[MC插件] BungeeDocs | Deprecated v0.2.1 – 评分 5.0/5.0

插件详细介绍

🔧 插件简介

BungeeDocs 是一款由 Favorlock 开发的 BungeeCord 插件，灵感来源于 CraftBukkit 上的 MCDocs。它主要用于动态修改 BungeeCord 服务器的 MOTD（欢迎语），支持多监听器独立配置，并能实现轮播显示效果。当前最新版本为 0.2.1，评分 5.0/5.0，累计下载量 1327。

⚠️ 重要提示： 该插件已被作者标记为“Deprecated（已废弃）”，作者明确表示不再提供任何支持，且已停止开发。对于仍在运行旧版 BungeeCord 且需要 MOTD 管理的服务器，仍可参考使用，但建议关注替代方案或自行维护。

💡 核心功能

BungeeDocs 聚焦于 MOTD 管理，提供以下关键特性：

• 多监听器独立 MOTD： 支持为 BungeeCord 配置中的每个 listener（监听器）单独设置 MOTD，覆盖原配置中的 motd 字段。
• 指令动态管理： 提供 /bdocs motd add <server> <motd>、list 和 remove 三条指令，方便管理员在线增删查 MOTD 条目。
• 循环轮播（Rotating MOTD）：通过配置文件设定轮播间隔（Interval），让不同 MOTD 自动交替显示，提升服务器页面新鲜感。
• 全彩色代码支持： 使用标准 Minecraft 颜色代码（如 &2 深绿、&4 暗红、&l 粗体等）定制富文本 MOTD。

🎯 使用场景

适合需要以下场景的 BungeeCord 网络：

• 多子服统一入口： 通过不同监听器绑定不同域名或端口，为每个子服（如生存服、小游戏服）显示专属 MOTD，吸引对应玩家。
• 活动宣传： 利用轮播功能轮流展示服务器活动、公告或更新日志，无需手动频繁修改。
• 品牌差异化： 在同一 BungeeCord 代理下，为不同子服配置不同配色的 MOTD，强化品牌形象。

⚙️ 配置说明

插件依赖 BungeeYAML 库。基本配置示例：

# BungeeDocs - By Favorlock

MOTD:
  server1:
  - '&2MOTD One!'
  - '&4MOTD Two!'
  - '&6MOTD Three!'
  server2:
  - '&6MOTD One!'
  - '&4MOTD Two!'
  - '&2MOTD Three!'
Interval: 10

• MOTD： 以服务器名（如 server1）为键，列表形式存储多条 MOTD 字符串。
• Interval： 轮播间隔（秒），设为 10 表示每 10 秒切换一条 MOTD。

在 BungeeCord 的 config.yml 中，需将对应监听器的 motd 字段留空（''），否则 BungeeDocs 的配置不会生效：

listeners:
- max_players: 50
  host: 0.0.0.0:25565
  motd: ''
  default_server: server1
  ...
- max_players: 50
  host: 0.0.0.0:25564
  motd: ''
  default_server: server2
  ...

🔌 兼容性与注意事项

• 版本要求： 专为 BungeeCord 设计，不适用于 Bukkit/Spigot 服务端。仅测试于 BungeeCord 1.7.x ~ 1.8.x 环境（老旧版本），高版本 BungeeCord 可能不兼容。
• 权限节点：
  • bungeedocs.motd.add
  • bungeedocs.motd.list
  • bungeedocs.motd.remove
• 已知局限： 未实现“每个服务器独立的权限节点”功能（在 ToDo 列表中），且作者已停止开发。建议在生产环境前充分测试。
• 备选方案： 如需更现代且活跃维护的类似插件，可考虑 BungeeMOTD、AdvancedMOTD 或 BungeeTabListPlus 等。

📜 版本历史摘要

• v0.2.0： 增加 MOTD 添加/列出/删除指令，自定义指令处理器。
• v0.1.2： 实现每个监听器独立 MOTD。
• v0.0.7： 初始发布，包含基础轮播功能。

（更多变更日志请参考原插件介绍 Spoiler。）

🌟 总结： BungeeDocs 是一个轻量、简洁的 BungeeCord MOTD 管理插件，适合小型或旧版代理网络。尽管已废弃，但其简洁的配置和直观的指令仍值得参考。若需长期运行，建议寻找仍在维护的替代品。