Warbridge 战桥小游戏插件 使用说明 / 配置教程 / 排错指南 / 二次开发
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
一、插件介绍
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Warbridge 是一款专为群组服务器（BungeeCord / Waterfall）设计的战桥小游戏插件。
本插件采用“一服一局”的架构，每个子服务器即一场独立游戏，相比传统单服多房间模式：
• 性能更稳定
• 游戏状态更清晰
• 不会串房间
• 更适合大型服务器扩展
适用于：大厅 + 多子服小游戏网络架构
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
二、基础使用方法（新手必看）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. 将插件放入 Spigot/Paper 服务器 plugins 目录
2. 启动服务器生成配置文件
3. 进入编辑模式：
/warbridge edit
4. 按顺序配置地图：
【1】设置大厅出生点
/warbridge setup setlobbyspawn
【2】设置游戏区域
/warbridge setup setgamepos1
/warbridge setup setgamepos2
【3】创建队伍（2队或4队）
/warbridge setup <游戏名> addteam red 红队
/warbridge setup <游戏名> addteam blue 蓝队
【4】设置队伍出生点
/warbridge setup <游戏名> setteamspawn red
【5】设置笼子区域
/warbridge setup <游戏名> setcagepos1 red
/warbridge setup <游戏名> setcagepos2 red
【6】设置传送门
/warbridge setup <游戏名> setportalpos1 red
/warbridge setup <游戏名> setportalpos2 red
5. 检查配置是否完整：
/warbridge setup finish
6. 退出编辑模式：
/warbridge edit
7. 重启服务器
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
三、重要注意事项（一定要看）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• 使用 /reload 后插件不会自动恢复游戏状态
即使 /warbridge setup finish 显示正常
请务必重启服务器！！！
• 默认语言为中文（messages.yml）
如需英文：
- 将 message_en.yml 重命名为 messages.yml
- 删除原 messages.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
四、配置文件说明（核心）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
config.yml
→ 插件基础功能开关（成就、死亡消息等）
game.yml
→ 游戏规则配置
包括：
- 胜利分数
- 最小人数
- 最大人数
- 每队人数
- 友伤开关
- 饱食度
- 弓箭冷却
map.yml
→ 地图数据（最重要）
包括：
- lobby出生点
- spectator点
- 游戏区域
- 各队出生点
- 笼子区域
- 传送门区域
kits.yml
→ 玩家装备配置（可自定义附魔）
board.yml
→ 计分板（支持变量）
motd.yml
→ 不同游戏状态下的服务器 MOTD
sounds.yml
→ 音效配置（击杀/得分/倒计时）
menus.yml
→ 队伍选择菜单配置
messages.yml
→ 中文语言文件
message_en.yml
→ 英文语言文件
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
五、常见问题排故
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【问题1】游戏不开始
原因：
- 玩家人数不足
- 队伍未配置
- 地图未完成
解决：
/warbridge status 查看状态
【问题2】地图区域异常
原因：
- gamepos 没设置正确
解决：
重新设置：
/warbridge setup setgamepos1
/warbridge setup setgamepos2
【问题3】玩家无法攻击 / 卡刀
原因：
- 其他插件干预 PvP
解决：
关闭冲突插件测试
【问题4】配置修改无效
原因：
- 使用了 /reload
解决：
重启服务器
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
六、简单二次开发教程
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
本插件提供 API，可用于扩展开发。
获取 API：
WarbridgeApi api = Bukkit.getServicesManager().load(WarbridgeApi.class);
常用方法：
api.getState()
api.getRoundState()
api.getPlayerTeam(player)
api.getPlayerStats(player)
监听事件示例：
@EventHandler
public void onKill(WarbridgePlayerKillEvent event) {
Player killer = event.getKiller();
killer.sendMessage("你击杀了一名玩家！");
}
可实现功能：
• 击杀奖励系统
• 经济系统
• 排行榜
• 成就系统
• 自定义玩法扩展
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
七、More
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Warbridge 是一个可以扩展、可配置、可运营的小游戏系统核心。
适合：
• 小型服务器快速搭建小游戏
• 群组服构建完整小游戏体系
• 开发者进行二次开发 https://github.com/SenalMC/WarBridge/blob/main/developmentguide.md
我推荐二次开发者和我一样保持项目免费和开源！当然你也可以选择让他人为你的创意付费！
如果你制作了本插件的扩展并发布，请务必@我一下(也可以通过Github或者邮箱来联系我)我将第一时间前往支持
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
一、插件介绍
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Warbridge 是一款专为群组服务器（BungeeCord / Waterfall）设计的战桥小游戏插件。
本插件采用“一服一局”的架构，每个子服务器即一场独立游戏，相比传统单服多房间模式：
• 性能更稳定
• 游戏状态更清晰
• 不会串房间
• 更适合大型服务器扩展
适用于：大厅 + 多子服小游戏网络架构
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
二、基础使用方法（新手必看）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. 将插件放入 Spigot/Paper 服务器 plugins 目录
2. 启动服务器生成配置文件
3. 进入编辑模式：
/warbridge edit
4. 按顺序配置地图：
【1】设置大厅出生点
/warbridge setup setlobbyspawn
【2】设置游戏区域
/warbridge setup setgamepos1
/warbridge setup setgamepos2
【3】创建队伍（2队或4队）
/warbridge setup <游戏名> addteam red 红队
/warbridge setup <游戏名> addteam blue 蓝队
【4】设置队伍出生点
/warbridge setup <游戏名> setteamspawn red
【5】设置笼子区域
/warbridge setup <游戏名> setcagepos1 red
/warbridge setup <游戏名> setcagepos2 red
【6】设置传送门
/warbridge setup <游戏名> setportalpos1 red
/warbridge setup <游戏名> setportalpos2 red
5. 检查配置是否完整：
/warbridge setup finish
6. 退出编辑模式：
/warbridge edit
7. 重启服务器
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
三、重要注意事项（一定要看）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• 使用 /reload 后插件不会自动恢复游戏状态
即使 /warbridge setup finish 显示正常
请务必重启服务器！！！
• 默认语言为中文（messages.yml）
如需英文：
- 将 message_en.yml 重命名为 messages.yml
- 删除原 messages.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
四、配置文件说明（核心）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
config.yml
→ 插件基础功能开关（成就、死亡消息等）
game.yml
→ 游戏规则配置
包括：
- 胜利分数
- 最小人数
- 最大人数
- 每队人数
- 友伤开关
- 饱食度
- 弓箭冷却
map.yml
→ 地图数据（最重要）
包括：
- lobby出生点
- spectator点
- 游戏区域
- 各队出生点
- 笼子区域
- 传送门区域
kits.yml
→ 玩家装备配置（可自定义附魔）
board.yml
→ 计分板（支持变量）
motd.yml
→ 不同游戏状态下的服务器 MOTD
sounds.yml
→ 音效配置（击杀/得分/倒计时）
menus.yml
→ 队伍选择菜单配置
messages.yml
→ 中文语言文件
message_en.yml
→ 英文语言文件
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
五、常见问题排故
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【问题1】游戏不开始
原因：
- 玩家人数不足
- 队伍未配置
- 地图未完成
解决：
/warbridge status 查看状态
【问题2】地图区域异常
原因：
- gamepos 没设置正确
解决：
重新设置：
/warbridge setup setgamepos1
/warbridge setup setgamepos2
【问题3】玩家无法攻击 / 卡刀
原因：
- 其他插件干预 PvP
解决：
关闭冲突插件测试
【问题4】配置修改无效
原因：
- 使用了 /reload
解决：
重启服务器
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
六、简单二次开发教程
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
本插件提供 API，可用于扩展开发。
获取 API：
WarbridgeApi api = Bukkit.getServicesManager().load(WarbridgeApi.class);
常用方法：
api.getState()
api.getRoundState()
api.getPlayerTeam(player)
api.getPlayerStats(player)
监听事件示例：
@EventHandler
public void onKill(WarbridgePlayerKillEvent event) {
Player killer = event.getKiller();
killer.sendMessage("你击杀了一名玩家！");
}
可实现功能：
• 击杀奖励系统
• 经济系统
• 排行榜
• 成就系统
• 自定义玩法扩展
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
七、More
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Warbridge 是一个可以扩展、可配置、可运营的小游戏系统核心。
适合：
• 小型服务器快速搭建小游戏
• 群组服构建完整小游戏体系
• 开发者进行二次开发 https://github.com/SenalMC/WarBridge/blob/main/developmentguide.md
我推荐二次开发者和我一样保持项目免费和开源！当然你也可以选择让他人为你的创意付费！
如果你制作了本插件的扩展并发布，请务必@我一下(也可以通过Github或者邮箱来联系我)我将第一时间前往支持
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
