Custom Join / Leave message - 自定义加入/离开消息

JoinLeave 是一款轻量级的 Minecraft 服务器插件，它允许你完全自定义玩家的加入/离开消息，并支持多种附加效果，如标题、烟花和音效。所有设置均可通过游戏内命令或配置文件轻松调整。

💡主要特性

• 可定制的加入/离开消息：支持颜色代码和 %player% 变量。
• 首次加入消息：可单独设置玩家首次加入时的欢迎词。
• 加入效果：支持在玩家加入时显示标题、播放音效和燃放烟花。
• 静默加入/离开：可为特定权限的玩家隐藏加入/离开消息。
• 全局开关：可完全禁用所有人的加入/离开消息。
• Essentials 昵称支持：可使用 Essentials 插件的昵称替代原版玩家名。
• 多语言支持：可轻松添加自定义语言。

🎮命令列表

所有命令均以 /joinleave 或配置中设定的 CommandPrefix 开头。

• /joinleave reloadconfig

重载插件配置文件。

• /joinleave set join <消息>

设置全局加入消息。可使用 `%player%` 代表玩家名。

• /joinleave set leave <消息>

设置全局离开消息。可使用 `%player%` 代表玩家名。

• /joinleave show join

查看当前设定的加入消息。

• /joinleave show leave

查看当前设定的离开消息。

🔧配置文件详解

config.yml

Join: '[&a+&r] &6The player &6&l%player% &6has joined the server!'
Leave: '[&c-&r] &6The player &6&l%player% &6has left the server!'
First-Join-Message: true
First-Join: '[&a+&r] &6The player &6&l%player% &6has joined for the first time!'
Language: EN
CommandPrefix: Join-Leave
Title-Onjoin: true
Hide-Players-With-Perms: false
Disable-Join-LeaveMessage: false
Fireworks-onJoin: true
Sound-onJoin: true
Use-Essentials: false

lang.yml

此文件存储所有语言文本。默认包含英文 (EN) 和荷兰文 (NL) 版本。你可以参照现有格式添加新语言。

Languages:
  EN:
    NoPermissions: You re not allowed to use this command!
    NoSubCommand: Please fill in a sub command!
    CommandDoesntExist: This command doesnt exist!
    SetJoinMessage: Join message has been set to
    ShowJoinMessage: This is at this moment the join message
    SetLeaveMessage: Leave message has been set to
    ShowLeaveMessage: This is at this moment the leave message
  NL:
    NoPermissions: Je hebt niet de juiste permissies om dit command uit te voeren!
    ...

✨权限节点

• joinleave.silentjoin

拥有此权限的玩家加入服务器时，不会显示加入消息。

• joinleave.silentleave

拥有此权限的玩家离开服务器时，不会显示离开消息。

• joinleave.set

使用 `/joinleave set` 命令所需的权限。

• joinleave.show

使用 `/joinleave show` 命令所需的权限。

• joinleave.help

使用帮助命令所需的权限。

❓常见问题解答

如何添加自定义语言？

• 打开 lang.yml 文件。
• 复制现有的语言区块（例如 EN: 部分）。
• 将其粘贴在文件底部，并将开头的 EN: 改为你想要的代码（例如 DE:）。
• 仅翻译冒号后的文本，保持键名（如 NoPermissions:）不变。
• 在 config.yml 中，将 Language: 的值改为你设置的语言代码（例如 DE）。
• 重启服务器或使用 /joinleave reloadconfig 重载配置。

执行命令后显示“null”？

这通常是因为在 config.yml 的 Language 设置中填写了 lang.yml 里不存在的语言代码。请检查并确保两者匹配（例如均为 EN 或 NL）。

为什么开启了音效却听不到？

• 你可能配置了一个 Minecraft 不存在的音效名称。
• 请检查服务器控制台是否有相关错误提示。
• 可在此处查询有效的音效列表：helpch.at/docs/1.16.5/org/bukkit/Sound.html
• 注意：音效名称区分大小写。

更新插件后出现错误？

很可能是因为旧配置文件与新版本不兼容。尝试删除旧的 config.yml 和 lang.yml，让插件重新生成默认配置文件。

加入时某个功能显示为默认文本？

这通常是由于 config.yml 中存在错误的配置项。请检查服务器控制台报错信息，根据提示修正配置。

插件在 1.18 版本上不工作？

请确保你使用的是适用于 1.18 的 Spigot/Paper 服务端。如果问题依旧，可以尝试使用为旧版 Minecraft 构建的特殊兼容版本（但会缺少部分新功能）。

> 兼容版下载链接：https://cdn.discordapp.com/attachments/923749173763932170/923867264124600330/joinleave-2.2.jar (仅限 2.2 版本)

遇到错误：`java.lang.NullPointerException: Cannot invoke "String.replaceAll(...)"`？

此错误已在 2.4.1 及以上版本 中修复。请更新到最新版本。

⭐后续更新计划

• 为首次加入的玩家播放特殊音效。
• 用于启用/禁用设置的 GUI 界面。
• 为特定玩家创建自定义加入消息。
• 版本检查器（用于提示旧版或存在问题的版本）。

---

需要帮助？ 请通过 Discord 联系作者：kurkentrekker

统计数据收集：本插件使用 bStats 收集匿名使用数据以帮助改进。你可以在 plugins/bStats/config.yml 中选择退出。