如何制作 BungeeCord 插件

分步说明

1. 1.确认你使用的代理端

   BungeeCord（或 Waterfall 这样的分支）和 Velocity 是不同的 API。BungeeCord 插件不能在 Velocity 上运行，反过来也一样。

2. 2.创建项目

   一个 Maven 或 Gradle 项目，带 provided 作用域的 bungeecord-api 依赖。运行时由代理端提供它。

3. 3.编写主类

   一个继承 net.md_5.bungee.api.plugin.Plugin 的类，在 onEnable() 中通过 getProxy().getPluginManager() 注册命令和监听器。

4. 4.在 bungee.yml 中描述插件

   name、version、main 和 author。BungeeCord 也会读取 plugin.yml，但用 bungee.yml 可以避免和 Spigot 插件混淆。命令在代码中注册，而不是写在文件里。

5. 5.编写命令和监听器

   命令继承 Command；监听器实现 Listener，用 @EventHandler 方法处理 PostLoginEvent 或 ServerSwitchEvent 等事件。

6. 6.需要时与后端服务器通信

   代理端看不到物品栏或世界。如果需要，就在每个后端服务器上放一个小的配套插件，与代理端插件交换插件消息。

7. 7.安装到代理端

   把 .jar 放进代理端的 plugins/ 文件夹，然后重启代理端，而不是后端服务器。

常用的代理端事件

正确配置群组服

• 在代理端的 config.yml 中开启 ip_forward，并在每个 Spigot 或 Paper 服务器的 spigot.yml 中设置 bungeecord: true，这样玩家名称和 UUID 才会被传递过去。
• 把后端服务器设为 online-mode=false，并确保它们无法从互联网直接访问，只能通过代理端进入。
• 插件消息只在有玩家连接到该后端服务器时才能传递，所以发往空服务器的消息不会送达。

描述示例

“一个名为 NetUtils 的 BungeeCord 1.21 代理端插件。/lobby 把玩家送到大厅服务器。/staffchat <message>（别名 /sc）把消息发给任何服务器上拥有 netutils.staff 的所有人。/maintenance on|off 显示维护 MOTD，并踢出没有 netutils.bypass 的玩家。管理员切换服务器时，在管理员聊天中发送一条加入消息。服务器名称、MOTD 和消息在 config.yml 中。”

用 Codexe

选择 BungeeCord/Velocity 类型，并写明你用的是哪个代理端，因为它们的 API 不同。Codexe 用 Maven 编译插件，并在标记为就绪之前检查 .jar 的描述文件是否正确；需求中没有写版本时，使用 BungeeCord API 1.21。如果你需要后端配套插件，请把它作为一个单独的 Spigot/Paper 项目来要求。

“立即试用”暂时还不支持代理服务器，所以请在你自己的群组服，或者带一个后端服务器的本地代理上测试代理端插件。另见 BungeeCord 插件生成器。

常见问题