### A friendly way to roll out the welcome mat for your players!
**WelcomeMat** 是一个轻量级、功能强大的插件，旨在增强服务器的欢迎体验。它提供可定制的加入/离开消息、标题和声音，让您的玩家感到受欢迎，并营造更引人入胜的氛围！
## 🎉 最新更新！
### 版本 1.2.2
- ✅ **增加了对 Minecraft 1.21.5 的支持**
- 完全兼容 Minecraft 1.13 到 1.21.5
- 没有破坏性变更——只是保持新鲜和功能！
### 版本 1.2.1 Highlights
- **消息包系统**: 多个主题的消息集合 (默认, 友好, 专业, 搞笑, RPG)
- **多语言支持**: 支持英语和西班牙语，并提供简单的语言切换功能
- **改进的配置显示**: 更用户友好的设置界面，带有显示名称
## 功能
- 🎨 **可定制的消息**
- 彩色的加入/离开消息
- 完全可定制的文本和颜色
- 支持玩家名称占位符
- 玩家特定的欢迎消息
- 显示名称支持配置
- 带有主题集合的消息包 (友好, 专业, 搞笑, RPG)
- 多语言支持 (英语，西班牙语)
- 📜 **欢迎标题**
- 加入时的醒目标题和副标题
- 可配置的持续时间和淡出时间
- 完全支持颜色代码
- 🔊 **互动声音**
- 可定制的加入/离开声音
- 玩家的单个声音开关
- 支持现代和旧版声音名称
- 音量和音调控制
- ✨ **动画系统**
- 多个动画效果
- 绿色尖峰烟花表演
- 可定制的动画时间
- 每个玩家的动画设置
- ⚙️ **广泛的配置**
- 易于使用的配置文件
- 单独启用/禁用功能
- 玩家特定的声音偏好
- 管理员日志记录功能
- 动态重新加载配置
## 📋 命令
- `/welcomemat` 或 `/wm` - 基础命令
- `/wm sound` - 为自己切换加入/离开声音
- `/wm reload` - 重新加载插件配置
- `/wm help` - 显示帮助消息
- `/wm animation` - 为自己切换加入动画
- `/wm language` - 更改插件语言
- `/wm pack` - 更改消息包
- `/wm config` - 修改插件配置
## 🔑 权限
- `welcomemat.reload` - 允许重新加载配置 (默认: op)
- `welcomemat.bypass` - 绕过欢迎消息 (默认: false)
- `welcomemat.sound.toggle` - 允许切换声音 (默认: true)
- `welcomemat.animation.toggle` - 允许切换动画 (默认: true)
- `welcomemat.admin.log` - 接收管理员日志消息 (默认: op)
- `welcomemat.language` - 允许更改插件语言 (默认: op)
- `welcomemat.pack` - 允许更改消息包 (默认: op)
- `welcomemat.config` - 允许修改插件配置 (默认: op)
## 📦 安装
1. 下载 WelcomeMat 的最新版本
2. 将 `.jar` 文件放置在服务器的 `plugins` 文件夹中
3. 重新启动你的服务器
4. 在 `plugins/WelcomeMat/config.yml` 中配置插件
## ⚙️ 配置
```yaml
features:
join-message: true
leave-message: true
join-title: true
join-sound: true
leave-sound: true
other-players-sounds: true
join-animation: true
admin-logging: true
messages:
join: "&e%player% &ajust joined the server!"
leave: "&e%player% &chas left the server!"
player-specific:
example-player:
join: "&6Welcome back, special player %player%!"
leave: "&eGoodbye, special player %player%!"
titles:
join:
title: "&6Welcome!"
subtitle: "&eEnjoy your stay!"
sounds:
join:
sound: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.0
leave:
sound: ENTITY_IRON_GOLEM_DEATH
volume: 0.5
pitch: 1.0
animations:
green-spike:
enabled: true
duration: 40
height: 2.0
# Message Packs
message-packs:
# Currently selected pack (default, friendly, professional, funny, rpg)
selected: "default"
# Default pack (original messages)
default:
join:
- "&e%player% &ajust joined the server!"
leave:
- "&e%player% &chas left the server!"
# Friendly pack
friendly:
join:
- "&d✨ &e%player% &ahas joined the party! &d✨"
- "&aWelcome back, &e%player%&a! We missed you! &d❤"
leave:
- "&e%player% &7had to go... &cSee you soon! &d💕"
- "&7Until next time, &e%player%&7! &d👋"
```
## 🌐 语言支持
WelcomeMat 现在支持多种语言：
```yaml
# Available languages: english, spanish
selected-language: "english"
languages:
english:
name: "English"
messages:
reload:
success: "&aConfiguration reloaded successfully!"
sound:
enabled: "&aJoin/leave sounds enabled!"
disabled: "&cJoin/leave sounds disabled!"
spanish:
name: "Español"
messages:
reload:
success: "&a¡Configuración recargada con éxito!"
sound:
enabled: "&a¡Sonidos de entrada/salida activados!"
disabled: "&c¡Sonidos de entrada/salida desactivados!"
```
## 🎵 可用的声音
### 现代 (1.13+)
- `ENTITY_PLAYER_LEVELUP`
- `ENTITY_IRON_GOLEM_DEATH`
- `BLOCK_NOTE_BLOCK_PLING`
- `BLOCK_NOTE_BLOCK_CHIME`
- `BLOCK_NOTE_BLOCK_BELL`
- And more...
### 传统 (1.8-1.12) (开发中)
- `LEVEL_UP`
- `IRONGOLEM_DEATH`
- `NOTE_PLING`
- `NOTE_PIANO`
- And more...
## 💡 示例配置
### 专业服务器，使用消息包
```yaml
# Use the professional message pack
message-packs:
selected: "professional"
# Set the language to English
selected-language: "english"
sounds:
join:
sound: BLOCK_NOTE_BLOCK_PLING
volume: 0.8
pitch: 1.5
animations:
green-spike:
enabled: true
duration: 30
height: 1.5
```
### VIP 服务器，使用自定义消息
```yaml
messages:
join: "&d✨ &e%player% &ahas joined the party! &d✨"
leave: "&e%player% &7had to go... &cSee you soon!"
player-specific:
VIP_Player:
join: "&6⚡ The legendary &e%player% &6has arrived! ⚡"
leave: "&6The legend &e%player% &6must go... &7Until next time!"
sounds:
join:
sound: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.2
animations:
green-spike:
enabled: true
duration: 50
height: 2.5
```
## 📝 支持
如果您遇到任何问题或有任何建议：
- 在我们的 [GitHub 仓库](https://github.com/coffeeisle/welcome-mat) 中创建问题
- 加入我们的 [Discord 服务器](https://discord.gg/cJ4uP2xF7h)
---
Made with ❤️ by angeldev0
[Download](https://modrinth.com/plugin/welcome-mat) • [Source](https://github.com/coffeeisle/welcome-mat) • [Discord](https://discord.gg/cJ4uP2xF7h)