EasyJoin - 玩家进出动作插件

EasyJoin 是一款功能强大的玩家加入/退出动作插件，提供多种自定义动作与格式，可显著提升服务器玩家的进出体验。

💡前置要求

• 本插件需要 PlaceholdersAPI 才能正常运行。

🎮核心特性

• 无限格式：可创建任意数量的加入/退出消息格式，每个格式的权限节点为 easyjoin.<格式名>。
• 多版本支持：兼容 Minecraft 1.8.X 至 1.18.X 版本。
• Hex 颜色代码：支持使用十六进制颜色代码（如 #123456）。
• AuthMe 联动：可设置在玩家通过 AuthMe 登录/注册后执行特定动作。
• 首次加入格式：支持为首次加入服务器的玩家设置独立的欢迎格式。

🔧可用动作列表

插件支持在配置中使用的动作指令格式如下

• [BROADCAST] <消息> - 向所有在线玩家发送消息。
• [JSON_BROADCAST] <JSON消息> - 向所有在线玩家发送 JSON 消息。
• [MESSAGE] <消息> - 向加入的玩家发送消息。
• [JSON_MESSAGE] <JSON消息> - 向加入的玩家发送 JSON 消息。
• [TITLE] <标题>;<副标题>;<淡入时间>;<停留时间>;<淡出时间> - 向加入的玩家发送标题与副标题。
• [BROADCAST_TITLE] <标题>;<副标题>;<淡入时间>;<停留时间>;<淡出时间> - 向所有在线玩家发送标题与副标题。
• [ACTIONBAR] <消息> - 向加入的玩家发送动作栏消息。
• [BROADCAST_ACTIONBAR] <消息> - 向所有在线玩家发送动作栏消息。
• [SOUND] <音效>;<音量>;<音高> - 向加入的玩家播放音效。
• [BROADCAST_SOUND] <音效>;<音量>;<音高> - 向所有在线玩家播放音效。
• [PLAYER] <命令> - 以玩家身份执行命令（无需 /）。
• [CONSOLE] <命令> - 以控制台身份执行命令（无需 /）。
• [CLEARCHAT] <行数> - 清空加入玩家的聊天记录。
• [BOOK] <延迟> - 在延迟后向玩家打开 book.yml 中设置的书籍。
• [FIREWORK] <类型>;<数量>;<强度>;<颜色(R,G,B)>;<次要颜色(R,G,B)>;<淡出颜色(R,G,B)>;<次要淡出颜色(R,G,B)> - 发射可自定义 RGB 颜色的烟花。
• [DELAY] <秒数> - 在动作之间添加延迟（单位为秒）。

使用提示

• 可在消息开头添加 <c> 来使消息居中显示，例如：[BROADCAST] <c>居中消息！
• JSON 消息可使用在线工具（如 minecraftjson.com）生成。
• 音效名称可参考 Bukkit 官方文档。

⭐命令与权限

• /easyjoin reload - 重载插件配置。
• 所需权限：easyjoin.admin
• /easyjoin setbook - 将手中持有的书籍保存至 book.yml。
• 所需权限：easyjoin.admin

✨配置示例 (`config.yml`)

以下为配置文件的精简示例，展示了核心设置与格式定义：

# 首次加入记录模式 (VANILLA, MYSQL)，若使用 MYSQL 需在 credentials.yml 中配置数据库信息
FirstJoinMode: VANILLA
# 是否启用 AuthMe 联动（在登录/注册后执行动作）
AuthMeHook: false

Formats:
  # 管理员格式 (权限: easyjoin.admin)
  admin:
    priority: 10
    join:
      actions:
        - '[BROADCAST] &8(&a+&8) &c&lADMIN &f%player_name%'
        - '[SOUND] LEVEL_UP;10;5'
        - '[ACTIONBAR] &ashop.example.com;5'
        - '[JSON_MESSAGE] {"text":"&9点击加入我们的 Discord","clickEvent":{"action":"open_url","value":"https://discord.gg/hPNYUMUauD"}}'
    quit:
      actions:
        - '[BROADCAST] &8(&c-&8) &f%player_name%'

  # 默认玩家格式 (权限: easyjoin.default)
  default:
    priority: 5
    join:
      actions:
        - '[BROADCAST] &8(&a+&8) &f%player_name%'
        - '[SOUND] LEVEL_UP;10;5'
        - '[ACTIONBAR] &ashop.example.com'
        - '[FIREWORK] STAR;10;2;255,120,200;100,50,30;10,20,30;40,10,20'
    quit:
      actions:
        - '[BROADCAST] &8(&c-&8) &f%player_name%'

配置说明

• 每个格式可通过设置 isFirstJoinFormat: true 转换为首次加入专属格式。
• 若启用 AuthMeHook，可在格式下添加 authme: 段落来配置登录后的动作。