BungeeStaff DISCORD API REDIS SUPPORT Infinite chats and commands 1.7 - 1.18 - BungeeStaff

BungeeStaffs 是一款功能丰富的 BungeeCord 插件，旨在为服务器管理提供强大的工具集。它包含自定义聊天、跨服搜索、在线管理列表、服务器控制以及与 Discord 的深度集成等功能，帮助管理员高效地管理和维护服务器网络。

💡核心功能

• 自定义聊天系统：支持创建带格式的专属聊天频道（如 Staff 聊天），并可集成 LuckPerms 前缀和 Discord 双向同步。
• 玩家与服务器管理：

- `/search`：查找玩家所在服务器，结果支持自定义悬停文本和点击事件。

- `/stafflist`：显示所有在线管理及其所在服务器。

- `/skick`：踢出指定服务器内的所有玩家。

- `/serverlist`：显示 BungeeCord 下的服务器列表及玩家数量。

- `/clientstatus`：查看玩家在服务器中的状态。

• 自定义命令：可配置如 /helpop、/report、/msg 等命令，支持冷却时间、权限控制和 Discord 通知。
• 服务器别名系统：通过 /aliases.yml 为服务器设置简短别名（例如 /prac 代替 /server practice）。
• Limbo（等待区）系统：当目标服务器关闭时，将玩家传送至安全的等待服务器，并在目标服务器恢复后自动传回。
• 聊天过滤器：可屏蔽敏感词和链接，并支持替换为指定文本。
• 全面的配置与多语言：提供高度可定制的配置文件，并内置英语、西班牙语、葡萄牙语、波兰语等多语言支持。

🎮命令与权限

主要管理命令

• /bstaffs reload - 重载插件配置。

- 权限：`bstaffs.admin`

• /bstaffs version - 显示插件版本。

- 权限：`bstaffs.admin`

• /search <player> - 查询玩家所在服务器。

- 权限：`bstaffs.search`

• /toggle <command> - 开关自定义命令的输出。

- 权限：由各命令配置决定（例如 `bstaffs.helpop.toggle`）。

• /togglechat <input> - 开关自定义聊天的输出。

- 权限：`bstaffs.togglechat`

• /stafflist - 显示在线管理列表。

- 权限：`bstaffs.list`

• /skick <server> - 踢出指定服务器的所有玩家。

- 权限：`bstaffs.serverkick`

- 绕过权限：`bstaffs.serverkick.bypass`

• /svrestart - 重启服务器：将玩家送至 Limbo，待服务器重启完成后自动传回。
• /serverlist - 显示 BungeeCord 服务器列表。

- 权限：`bstaffs.serverlist`

• /clientstatus - 显示玩家客户端状态。

- 权限：`bstaffs.clientstatus`

自定义命令示例（在 commands.yml 中配置）

• /helpop <消息> - 向在线管理发送求助信息。
• /report <玩家> <原因> - 举报其他玩家。
• /msg <玩家> <消息> - 向其他玩家发送私信。
• /discord - 显示服务器 Discord 链接。

🔧配置说明

插件的主要配置文件均位于 /plugins/BungeeStaffs/ 目录下。

settings.yml

主配置文件，包含

• 基础设置：语言选择、是否使用 Bungee MOTD 作为服务器名变量。
• Discord 集成：开关、机器人令牌、活动状态更新。
• 管理设置：管理权限节点、加入/离开/切换服务器时的公告。
• Limbo 系统：等待服务器名称、超时时间、传送冷却、备用服务器列表。
• 日志记录：可选择输出至控制台、文件或两者。

commands.yml

用于创建和管理自定义命令。

• 可定义命令类型：SOLO（单人）、TARGET（目标）、PRIVATE（私信）、CONSOLE（控制台）。
• 为每个命令设置权限、使用格式、输出信息、冷却时间和 Discord 频道通知。

chats.yml

用于创建和管理自定义聊天频道。

• 定义聊天触发前缀（如 #）、显示格式、所需权限。
• 聊天过滤器：可屏蔽词语、链接，并启用词语替换。
• Discord 双向同步：可将游戏内聊天与 Discord 频道双向联通。

aliases.yml

用于设置服务器别名。

• 为服务器（如 Practice）设置简短易记的别名（如 prac）。
• 可设置黑名单服务器，禁止在这些服务器上使用别名。
• 可为每个别名设置独立的使用权限。

语言文件

• en_US.yml, es_ES.yml, pt_BR.yml, pl_PL.yml
• 可完全自定义插件所有提示信息，支持颜色代码和自定义格式语法。

✨自定义格式语法

插件移除了对 Minedown API 的依赖，采用了自定义的富文本语法。在配置消息时，可以使用以下参数（需放在 ${} 格式之后）：

• (show_text=<消息>) - 设置鼠标悬停时显示的文本。
• (run_command=<命令>) - 设置点击时执行的命令。
• (suggest_command=<命令>) - 设置点击时在输入框建议的命令。
• (format=<格式>) - 设置文本样式，可选：underline、strikethrough、bold、italic。
• (color=<十六进制颜色>) - 设置颜色，例如 #ff1100。
• (color=<起始色>-<结束色>) - 设置渐变颜色。

**使用示例**

&e点击 ${&e&l这里}(run_command=/server lobby)(show_text=&b点击加入服务器) &e来加入。

❓常见问题

• 如何添加新的自定义命令？

- 编辑 `commands.yml` 文件，在 `COMMANDS:` 节点下按照现有格式添加新的配置块即可。

• 如何将聊天同步到 Discord？

- 在 `settings.yml` 中启用 `DISCORD-INTEGRATION` 并配置机器人令牌。

- 在 `chats.yml` 中对应聊天的 `DISCORD:` 部分启用并配置频道 ID。

• 玩家无法使用服务器别名怎么办？

- 检查 `aliases.yml` 中的 `BLACKLIST-SERVERS`，确保玩家当前所在服务器不在黑名单中。

- 检查是否为该别名设置了权限，并确保玩家拥有相应权限。

• 如何修改插件的提示信息？

- 根据 `settings.yml` 中的 `LANGUAGE` 设置，编辑对应的语言文件（如 `en_US.yml`）即可。

• 更多信息在哪里查看？

- 请访问插件的 Wiki 页面以获取最完整和最新的文档。

> 提示：如果您想支持本插件，可以制作讲解视频并发布在 YouTube 上，然后通过我们 Discord 服务器中的工单系统提交链接。如果视频内容优质，我们可能会将其展示在主页。