VIP Join/Leave Message - VIP 进出消息

VIP Join Message 是一款用于自定义玩家加入/退出服务器时显示消息的插件。它支持无限数量的玩家组别（Rank）和优先级设置，并兼容 PlaceholderAPI，允许你为不同权限组的玩家设置独特的加入/退出消息，以及全局欢迎信息。

💡核心功能

• 为不同玩家组别（如 VIP、MVP、管理员）设置独立的加入与退出消息。
• 支持设置全局欢迎消息，并可以自定义显示延迟。
• 完全兼容 PlaceholderAPI，可在消息中使用各类变量（如 %player_name%）。
• 允许管理员灵活开关各类消息（全局、默认、组别、欢迎消息）。
• 通过配置文件轻松自定义所有消息内容和颜色格式。

🎮权限与命令

权限节点

• 组别加入消息: vjm.join.<rank> (例如: vjm.join.vip)
• 组别退出消息: vjm.quit.<rank> (例如: vjm.quit.vip)
• 管理员权限: vjm.admin (使用所有管理命令)

管理命令

所有命令均以 /vjm admin 开头，需要 vjm.admin 权限。

• 开关全局消息: /vjm admin toggle global <join/quit>
• 开关默认消息: /vjm admin toggle default <join/quit>
• 开关组别消息: /vjm admin toggle ranks <join/quit>
• 开关欢迎消息: /vjm admin toggle welcome
• 重载配置: /vjm admin reload

🔧配置文件详解

配置文件为 config.yml，主要结构如下：

全局设置 (global)

控制全局欢迎消息。

global:
  messages:
    join:
      delay: 2 # 加入消息延迟（秒）
      enabled: true
    quit:
      enabled: true
    welcome-message:
      enabled: true
      delay: 1 # 欢迎消息延迟（秒）
      message: # 欢迎消息内容，支持多行
      - '&7'
      - '&7&m-------------------------------------'
      - '&c&l        YOUR NETWORK NAME'
      - '&a        Welcome to my server'
      - '        &eStore: &fstore.yourserver.com'
      - '        &9Discord: &fdiscord.yourserver.com'
      - '&7&m-------------------------------------'

默认消息 (default)

适用于没有特定组别权限的玩家。

default:
  join:
    enabled: true
    message: '&7[&a+&7] &7%player_name% &7joined the lobby!'
  quit:
    enabled: true
    message: '&7[&a+&7] &7%player_name% &7left the lobby!'

组别消息 (ranks)

为不同权限组设置专属消息。你可以自由添加更多组别。

ranks:
  join:
    enabled: true
    messages:
      admin: '&4[ADMIN] %player_name% &6joined the lobby!'
      mod: '&c[MOD] %player_name% &6joined the lobby!'
      mvp: '&b[MVP] %player_name% &6joined the lobby!'
      vip: '&a[VIP] %player_name% &6joined the lobby!'
      random: '%luckperms_prefix% %player_name% &6joined the lobby!' # 使用LuckPerms前缀示例
  quit:
    enabled: true
    messages:
      admin: '&4[ADMIN] %player_name% &6left the lobby!'
      # ... 结构同 join

✨安装教程

• 将下载的插件文件（.jar）放入服务器的 plugins 文件夹内。
• 启动或重启你的 Minecraft 服务器。
• 根据你的需求编辑 plugins/VIPJoinMessage/config.yml 文件。
• 重载配置或重启服务器使更改生效。

> 推荐：同时安装 PlaceholderAPI 插件以使用更多变量功能。

❓常见问题

• 如何为我的自定义组别添加消息？

只需在 config.yml 文件的 ranks: join/quit: messages: 部分下，添加新的条目即可，例如 yourrank: '你的消息'，并确保玩家拥有对应的 vjm.join.yourrank 权限。

• 消息没有正确显示颜色？

请确保你的消息文本中使用了正确的颜色代码（如 &a 代表绿色），并且服务器支持彩色信息。

• 如何关闭所有加入消息？

使用管理员命令 /vjm admin toggle global join 可关闭全局加入消息，或分别关闭 default 和 ranks 的加入消息。

如需更多帮助，请联系插件开发者。