JoinPlugin - 全功能进服管理 自定义消息与MOTD

💡简介

Join Plugin 是一款功能丰富的 Minecraft 服务器插件，允许你为玩家加入和退出服务器创建高度自定义的体验。它支持基于玩家权限组的差异化消息、特效、音效、首次加入欢迎、服务器维护模式以及 MOTD 设置。

🎮配置说明

配置文件采用 YAML 格式，请确保缩进正确，并在包含特殊符号的文本外使用引号。若文本中包含英文单引号 '，请使用两个单引号 '' 进行转义。

占位符与命令执行器

• 可用占位符：

- `%player%` - 玩家名称

- `%playerdisplayname%` - 玩家显示名称

• 命令执行器：

- `[player]` - 以玩家身份执行命令

- `[console]` - 以控制台身份执行命令

核心功能配置

分组消息

通过 Enable Join Message By Groups 启用或禁用整个加入/退出消息系统。每个组需要唯一的 ID。

**配置示例**

Groups:
  group1:
    permission: "group1.join"
    Join Message: "Group1 Joined!"
    Quit Message: "Group1 Left!"
    Firework: true
    Sound: "BLOCK_NOTE_BLOCK_CHIME"
    commands:
      - "[player] spawn"
      - "[player] kit starter"
      - "[console] broadcast hello!"

玩家数量与 MOTD

• MaxPlayers：可设置服务器最大玩家数及满员时的踢出消息。
• JoinMOTD：玩家加入时在聊天栏显示的欢迎信息，支持多行。
• ServerMOTD：在服务器列表中显示的 MOTD，包含两行。

加入标题与首次加入

• Join Title：可配置玩家加入时显示的标题与副标题，以及淡入、停留、淡出时间。
• First Join：可单独配置玩家首次加入时的专属欢迎消息和 MOTD。

通用功能

• Whitelist：配置服务器启用白名单时的踢出消息。
• Maintenance：启用或禁用维护模式，并配置相关提示消息和服务器列表 MOTD。

✨特色功能

• 基于权限组的消息：为不同权限组的玩家设置不同的加入/退出消息、命令和特效。
• Hex 颜色代码支持 (Beta)：在消息中使用 &# 前缀的十六进制颜色代码（例如：&#0fba70%Player% Joined!）。请注意，消息文本与颜色代码之间不应有空格。
• 静默加入支持：通过 SupportEssentialXVanish: true 设置，当玩家处于隐身（Vanish）状态时，可抑制其加入消息。
• 丰富的视觉与听觉效果：

- 可配置的加入烟花效果。

- 可自定义的加入音效（注意：示例音效 `BLOCK_NOTE_BLOCK_CHIME` 适用于 1.17+，请根据服务器版本调整）。

• 自动化命令：在玩家加入时自动执行一系列命令。
• 维护模式与白名单：轻松开启服务器维护或白名单，并自定义提示信息。

🔧使用与支持

• 插件版本：当前文档基于 1.0 版本配置。
• Hex 颜色支持：此功能目前处于 Beta 阶段，仅在 1.16.5 版本中经过测试。
• 获取支持：如需帮助，请加入 Discord 支持服务器：https://discord.gg/7XRSVMMPQP
• 鼓励评分：如果你喜欢这个插件，请在 Spigot 页面为其评分，这对开发者非常重要。