Custom Join and Quit Message - 自定义进出消息插件

一款用于个性化玩家加入与退出消息的简单插件。

CustomJoinAndQuitMessages 是一款简单易用的插件，允许你完全自定义玩家加入和退出服务器时显示的消息。它还提供了消息自定义选项，让你可以添加特殊的交互动作（如悬停文本、点击事件）。如果你想关注插件开发并抢先体验测试版本，请点击这里。若有任何想法或建议，欢迎在讨论区提出！

请注意：在因任何错误或问题给予差评前，请先通过 Discord 或 Issue Tracker 寻求帮助。你可以点击这里参与插件消息的翻译工作。更新语言文件后，需要重载或重启服务器才能生效。

💡依赖项

部分功能需要以下依赖插件才能正常工作，请将其放入 plugins 文件夹。点击名称可跳转至依赖页面。

• PlaceholderAPI：允许你在消息中使用各种变量，但需要安装相应的扩展插件。
• LuckPerms：配合 LuckPerms，你可以使用基于玩家权限组的消息定制系统，只需将组名与配置中的名称对应即可。
• DiscordSRV：启用后，当玩家进入或离开服务器时，消息可以同步到 Discord（此功能目前处于实验阶段）。

🎮权限

所有权限默认对 OP 玩家开放。

权限列表 (版本参考):

• cjm.admin
• cjm.command.reload
• cjm.command.elp
• cjm.command.tabcomplete
• cjm.update

权限列表 (自 1.7.3 起):

• cjm.*
• cjm.commands.reload
• cjm.commands.help
• cjm.tab
• cjm.update.notify

🔧命令

• /cjm help - 查看插件详细信息与帮助。
• /cjm reload - 重载插件配置文件。
• /cjm info - 显示插件信息。

✨更新日志

1.7.2

• 错误修复。

1.7.1

• 集成 DiscordSRV 支持。
• 集成 Vault 支持。
• 新的权限组消息系统。
• 错误修复。

1.7.0

• 修复了在 1.17.x 版本中无法加载的问题。
• 新增功能：
• 渐变文字 (Gradient)。
• 彩虹文字 (Rainbow)。

1.6.2

• 为 1.16 及以上版本实现了十六进制颜色代码支持。

1.6.1

• 修复了更新检查器的错误。
• 修复了在 PaperMC、Purpur 端上的加载问题。

1.6.0

• 在悬停和点击事件中支持变量。
• 更新了悬停文本颜色系统。
• 更新了语言文件夹结构。
• 更新了 config.yml 配置。
• 新增基于权限组的加入/退出消息系统。
• 新增更新检查器系统。
• 修复了帮助命令。
• 修复了更新检查器。
• 移除了 BountiFulAPI 依赖。
• 更新了标题与动作栏消息功能。
• 更新了音效支持。
• 新增法语语言文件。
• 新增对 1.7.x 版本的服务端支持。

1.5.0

• 新增德语语言文件。

❓支持与反馈

如果你遇到问题或需要帮助，请通过以下渠道联系

• Issue Tracker：提交问题
• Discord：加入 Discord 服务器

CustomJoinAndQuitMessage 是一款功能强大的 Minecraft 插件，它允许服务器管理员高度自定义玩家加入、退出时的聊天消息、标题、音效等，并支持与 LuckPerms、Essentials 等流行插件集成，为服务器带来个性化的欢迎体验。

💡核心功能

• 完全自定义玩家加入和退出服务器的聊天消息。
• 支持为首次加入的玩家设置独特的欢迎消息。
• 为消息添加可交互的悬停文本（HoverEvent）和点击事件（ClickEvent）。
• 可在玩家加入时播放自定义音效、显示标题（Title）和动作条（ActionBar）消息。
• 支持基于玩家权限组（需 LuckPerms）显示不同的加入/退出消息。
• 与 Essentials 集成，可对处于隐身状态的玩家隐藏加入/退出消息。
• 实验性功能：支持将消息转发至 Discord 频道（通过 DiscordSRV 或 EssentialsDiscord）。

🎮配置文件详解

主要设置

• Lang: 设置插件语言，默认为 en_US。可使用内置语言或添加自定义翻译。
• Update: 是否检查插件更新，默认为 true。
• Debug: 是否显示插件加载的调试信息，默认为 true。
• Type: 消息显示模式，可选 normal（普通）、group（按权限组）或 none（无）。
• Show-Chat-In-Console: 是否在控制台显示聊天消息，默认为 true。

插件集成 (Hooks)

LuckPerms

• Enabled: 启用或禁用 LuckPerms 集成。
• AutoUpdateGroup:

-   `Enabled`: 是否自动检测玩家权限组变更并更新消息。

-   `Tick`: 自动执行检测的时间间隔（单位：游戏刻），默认 `600`（即 30 秒）。

DiscordSRV (实验性)

• Enabled: 启用或禁用 DiscordSRV 集成。
• Channel-ID: 用于接收 Minecraft 聊天消息的 Discord 频道 ID，默认为 'none'。

Essentials

• Enabled: 启用或禁用 Essentials 集成。
• HidePlayerIsVanish: 当玩家处于隐身状态时，是否隐藏其加入/退出消息，默认为 true。

EssentialsDiscord (实验性)

• Enabled: 启用或禁用 EssentialsDiscord 集成。
• Channel-ID: 用于聊天的 Discord 频道 ID，默认为 'none'。
• Use-Default-Channel: 是否使用 EssentialsDiscord 的默认频道，默认为 true。

加入消息 (Join)

• Enabled: 启用或禁用加入消息。
• Text: 自定义加入消息文本。支持颜色代码、渐变 (<GRADIENT:...>) 和彩虹 (<RAINBOW>) 等格式，可使用 <name> 等占位符。
• First-Join: 首次加入设置。

-   `Enabled`: 是否为首次加入的玩家启用特殊消息。

-   `Text`: 首次加入消息文本。

-   `Type`: 消息类型，可选 `normal` 或 `modify`（可交互）。

• HoverEvent: 悬停事件设置。

-   `Enabled`: 启用或禁用悬停文本。

-   `Hover`: 悬停时显示的文本列表，支持多行。

• ClickEvent: 点击事件设置。

-   `Enabled`: 启用或禁用点击事件。

-   `Mode`: 点击模式，可选 `command`（执行命令）、`suggest`（建议命令）或 `url`（打开链接）。

-   `Actions`: 定义不同模式下的具体行为。

-   `Command`: 点击后执行的命令。

-   `Url`: 点击后打开的链接。

-   `Suggest-Command`: 点击后建议输入的命令。

• Sound: 加入音效设置。

-   `Enabled`: 启用或禁用音效。

-   `Send-To-All`: 音效是否发送给所有在线玩家。

-   `Name`: 音效名称（例如 `BLOCK_NOTE_BLOCK_PLING`）。完整列表请查阅 Spigot 声音列表。

-   `Pitch`: 音高，默认为 `1`。

-   `Volume`: 音量，默认为 `20`。

• Title: 加入标题设置。

-   `Enabled`: 启用或禁用标题。

-   `Title`: 主标题文本。

-   `SubTitle`: 副标题文本。

-   `FadeIn`: 淡入时间（刻），默认为 `20`。

-   `Stay`: 停留时间（刻），默认为 `40`。

-   `FadeOut`: 淡出时间（刻），默认为 `20`。

• ActionBar: 加入动作条设置。

-   `Enabled`: 启用或禁用动作条。

-   `Text`: 动作条显示的文本。

退出消息 (Quit)

配置项与“加入消息”类似，包括 Enabled、Text、Type、HoverEvent、ClickEvent 和 Sound 等，用于自定义玩家退出时的体验。

欢迎消息 (Welcome)

• Enabled: 启用或禁用欢迎消息。
• Text: 玩家进入服务器后显示的欢迎消息列表，支持多行和丰富的格式。

🎮权限组配置 (groups.yml)

此文件用于为不同 LuckPerms 权限组的玩家设置独立的加入/退出消息。组名必须与 LuckPerms 中的权限组名称完全一致。

每个权限组（如 default）的配置结构与主配置文件 (config.yml) 中的 Join 和 Quit 部分高度相似，包含：

• Join: 该组玩家的加入消息。
• Enabled-Join: 启用或禁用该组的加入消息。
• Quit: 该组玩家的退出消息。
• Enabled-Quit: 启用或禁用该组的退出消息。
• First-Join: 该组玩家的首次加入设置（包含消息、类型、悬停事件、点击事件等）。
• Sound: 该组玩家加入时的音效设置。
• Title: 该组玩家加入时的标题设置。
• ActionBar: 该组玩家加入时的动作条设置。

🔧链接与支持

• Spigot 资源页面: https://www.spigotmc.org/resources/custom-join-and-quit-message-1-8-x-1-19-x.57006/
• Discord 社区: https://discord.gg/c5GhQDQCK5
• 问题追踪 (GitHub): https://github.com/jonagamerpro1234/CustomJoinAndQuitMessages/issues
• 插件统计: https://bstats.org/plugin/bukkit/CustomJoinAndQuitMessages/6318
• 声音列表参考:

-   (1.8): https://www.spigotmc.org/wiki/cc-sounds-list/

-   (最新): https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html

✨注意事项

• 使用“按权限组显示消息”(group 类型) 功能必须安装并正确配置 LuckPerms。
• DiscordSRV 和 EssentialsDiscord 集成功能目前处于实验阶段。
• 配置中使用 <name> 等占位符会被自动替换为玩家名。
• 确保配置文件的 File-Version 不被手动修改，以免出现兼容性问题。