GlobalBell : Global join/leave messages - GlobalBell - 全服进出消息

GBell 是一款 BungeeCord 网络消息插件，它能让所有玩家看到其他玩家加入、离开或切换服务器的动态。它提供了丰富的配置选项，包括自定义消息、别名系统、静默模式以及反机器人功能。

💡核心功能

• 网络范围消息：所有玩家都能看到玩家加入、离开或切换服务器的通知。
• 高度可配置：支持自定义所有消息内容和颜色格式。
• 欢迎消息：可设置玩家首次加入网络时的欢迎语。
• 服务器别名：可为每个服务器设置显示别名，替换消息中的原始服务器名。
• 服务器特定消息：可为每个服务器单独配置不同的加入、离开、切换消息。
• 静默模式：玩家可以开启静默模式，隐藏自己的进出动态。
• 反机器人机制：可启用以防止消息刷屏。

🎮命令与权限

命令

• /gbell silent

- 切换你自己的静默模式。开启后，其他玩家将不会看到你加入、离开或切换服务器的消息。

- 所需权限：`gbell.silent`

• /gbell reload

- 重新加载插件的配置文件。

- 所需权限：`gbell.reload`

权限

• gbell.silent：允许玩家使用 /gbell silent 命令。
• gbell.reload：允许玩家使用 /gbell reload 命令。
• gbell.receive：拥有此权限的玩家才会收到消息（在配置中设置）。
• gbell.silent.force：拥有此权限的玩家将始终处于静默状态（在配置中设置）。

权限管理提示：你可以使用 LuckPerms 等插件来管理 BungeeCord 上的权限。

🔧配置详解

配置文件为 YAML 格式。以下为关键配置项说明：

基础设置

prevent-bots: false
# 设置为 true 可启用反机器人机制，将在每条消息间强制加入 500 毫秒的冷却时间。

receive-permission: "gbell.receive"
# 拥有此权限的玩家才会收到消息。留空则允许所有人接收。

silent-permission: "gbell.silent.force"
# 拥有此权限的玩家将被强制设为静默状态。

消息格式

你可以使用 & 符号设置颜色和格式代码，使用 \n 进行换行。

• welcome：玩家首次加入网络时显示的欢迎消息。
• join-all：玩家加入网络时，向 BungeeCord 上所有玩家广播的消息。可用变量：%player%, %to-server%。
• join-to：玩家加入某个服务器时，仅在该目标服务器内广播的消息。可用变量：%player%, %to-server%。
• leave-all：玩家离开网络时，向 BungeeCord 上所有玩家广播的消息。可用变量：%player%, %from-server%。
• leave-from：玩家离开某个服务器时，仅在该离开的服务器内广播的消息。可用变量：%player%, %from-server%。
• switch-all：玩家切换服务器时，向 BungeeCord 上所有玩家广播的消息。可用变量：%player%, %from-server%, %to-server%。
• switch-to：玩家切换至某个服务器时，仅在该目标服务器内广播的消息。可用变量：%player%, %from-server%, %to-server%。
• switch-from：玩家从某个服务器离开时，仅在该离开的服务器内广播的消息。可用变量：%player%, %from-server%, %to-server%。

注意：任何消息都可以通过清空其内容来禁用。

服务器特定配置

在 servers: 部分，你可以为每个服务器（例如 factions）设置独立的配置。

servers:
  factions:
    alias: "&2Factions&b"
    # 此别名将替换所有消息中的 `%server%`、`%to-server%`、`%from-server%` 变量。
    join-to: "&d%player% would like to fight!"
    leave-from: "&d%player% surrenders"
    switch-to: "&d%player% would like to fight!"
    switch-from: "&d%player% surrenders"
    # 以上消息变体将只发送给位于 “factions” 服务器内的玩家。

❓变量与提示

• 可用变量：

- `%player%`：触发事件的玩家名。

- `%realname%`：玩家的真实名称（区分大小写）。

- `%from-server%`：玩家离开的服务器名（或其配置的别名）。

- `%to-server%`：玩家前往的服务器名（或其配置的别名）。

- `%server%`：当前相关的服务器名。

• 配置提示：修改配置后，请记得使用 /gbell reload 命令（需权限）或重启 BungeeCord 以使更改生效。