DeluxeJoin - 高度自定义的加入离开插件

DeluxeJoin 是一款功能全面的玩家加入与离开动作管理插件。你可以为不同权限组创建独立的加入/离开动作列表，并执行多种类型的操作，例如发送JSON消息、普通消息、标题、动作栏信息、执行控制台或玩家命令、播放音效等。它还支持首次加入动作列表和基于权限的游戏内MOTD系统，无需依赖其他插件即可运行，但配合 PlaceholderAPI 可使用更多变量。

💡核心功能

• 分组动作列表：为不同权限组设置独立的加入、离开和首次加入时执行的动作序列。
• 丰富的动作类型：支持发送JSON消息/广播、普通消息/广播、标题、动作栏信息、执行命令、播放音效等。
• 首次加入处理：专门为首次加入服务器的玩家执行特定动作，如发送欢迎公告或发放新手礼包。
• 权限化MOTD系统：玩家在加入时或通过命令可查看与其权限节点对应的MOTD信息，实现不同玩家看到不同内容。
• 优先级系统：通过 priority 数值管理多个格式的优先级，数值越小，优先级越高。
• 变量支持：若安装 PlaceholderAPI 或 DeluxeChat，可在所有动作中使用丰富的变量（如 %player%, %online%）。

🎮配置指南

配置文件允许你创建任意数量的消息格式（format），每个格式必须包含由有效动作标签开头的动作列表。

动作标签与示例

所有动作行必须以一个有效的动作标签开始。以下是可用标签及其简写和示例：

• JSON消息
• 标签：[JSONMESSAGE], [JSON]
• 示例：- '[JSON] {"text":"这条消息发送给目标玩家"}'

• JSON广播
• 标签：[JSONBROADCAST], [JSONBC]
• 示例：- '[JSONBC] {"text":"这条消息发送给所有玩家"}'

• 聊天消息
• 标签：[MESSAGE], [MSG]
• 示例：- '[MESSAGE] &a这条消息发送给加入/离开/查看MOTD的玩家'

• 聊天广播
• 标签：[BROADCAST], [BC]
• 示例：- '[BROADCAST] &a这条消息发送给所有玩家'

• 动作栏消息
• 标签：[ACTIONBARMSG], [ACTIONMSG]
• 示例：- '[ACTIONMSG] &a这条消息发送给目标玩家'

• 动作栏广播
• 标签：[ACTIONBARBROADCAST], [ACTIONBROADCAST]
• 示例：- '[ACTIONBROADCAST] &a这条消息发送给所有玩家'

• 标题消息
• 标签：[TITLEMESSAGE], [TITLEMSG]
• 示例：- '[TITLEMSG] title:&a欢迎来到服务器 subtitle:&b这里是副标题 fadein:10 stay:20 fadeout:10'

• 标题广播
• 标签：[TITLEBROADCAST], [TITLEBC]
• 示例：- '[TITLEBC] title:&a%player% 加入了！ subtitle:&b副标题 fadein:10 stay:20 fadeout:10'

• 玩家命令
• 标签：[PLAYERCOMMAND], [PLAYERCMD]
• 示例：- '[PLAYERCMD] /spawn'

• 控制台命令
• 标签：[CONSOLECOMMAND], [CONSOLECMD]
• 示例：- '[CONSOLECMD] spawn %player%'

• 玩家音效
• 标签：[SOUND], [PLAYERSOUND]
• 示例：- '[SOUND] NOTE_PLING 10 10'

• 广播音效
• 标签：[BROADCASTSOUND], [BCASTSOUND]
• 示例：- '[BROADCASTSOUND] NOTE_PLING 10 10'

配置格式模板

deluxejoin_formats:
  <格式标识符>:
    priority: <优先级数字>
    join_actions:
    - '[JSONBROADCAST] {"text":"%player% 加入了游戏","color":"yellow"}'
    leave_actions:
    - '[JSONBROADCAST] {"text":"%player% 离开了游戏","color":"yellow"}'

重要配置说明

• 优先级：数字越小优先级越高（如 1 最高，1000 最低）。当玩家拥有多个格式权限时，插件将选择优先级最高的格式。
• 权限节点：每个格式的权限节点为 deluxejoin.format.<标识符>。
• JSON组合：如需在一个字符串中使用多个JSON组件，请用 && 连接。
• 普通文本行：若要发送带颜色代码的普通文本，行首必须使用 [MESSAGE] 标签。

🔧动作使用限制

• 离开动作 (leave_actions) 中不能使用以下动作（因为玩家已离线）：
• [JSONMESSAGE], [MESSAGE], [ACTIONBARMSG], [TITLEMSG], [PLAYERCMD], [SOUND]

• MOTD动作 (motd_actions) 中不能使用以下全局动作（以免影响所有在线玩家）：
• [JSONBROADCAST], [BROADCAST], [ACTIONBARBROADCAST], [TITLEBROADCAST], [BROADCASTSOUND]

✨权限与命令

• 重载插件配置：deluxejoin.admin
• 查看MOTD命令：deluxejoin.motd
• 使用特定加入/离开格式：deluxejoin.format.<标识符>
• 查看特定MOTD：deluxejoin.motd.<标识符>

❓常见问题与提示

• 如何生成JSON消息？ 可以访问 minecraftjson.com 来辅助生成。
• 需要依赖吗？ 本插件可独立运行，但安装 PlaceholderAPI 后可以使用更多变量。
• MOTD系统：在配置中启用后，玩家加入时或执行 /motd 命令即可查看。MOTD格式与加入/离开格式类似，但有自己的权限节点 (deluxejoin.motd.<标识符>)。
• 首次加入配置：在 first_join 部分设置 announce_on_join: true 并定义 actions 列表。
• 更多帮助：请访问官方 Wiki：https://wiki.helpch.at/clips-plugins/deluxejoin