The Bridge - 桥梁对战

The Bridge 是一款快节奏的团队竞技游戏，玩家分为两队，在连接岛屿的狭窄桥梁上展开攻防。目标是通过战斗、建造或破坏桥梁，冲入对方基地的坑洞中得分，先得5分的队伍获胜。游戏节奏紧张，强调团队合作与快速反应。

💡游戏玩法

玩家分为两队，在2个或4个岛屿之间的狭窄桥梁上对战。目标是穿过桥梁，跳入对方岛屿的坑洞中得分。玩家可以使用剑进行战斗和防御，同时可以建造或破坏桥梁以获取战略优势。游戏节奏快，需要团队合作和快速反应。当一支队伍成功获得5分时游戏结束。桥梁可以重建，使得每一轮都充满动态挑战。

测试服务器： testing.mipcraft.eu (157.90.137.69:22022)

✨主要特性

• 高度可配置：允许自定义几乎所有方面。
• 自定义地图设计：发挥创意，设计个性化的地图。
• 可配置的消息：可更改加入、离开、击杀等游戏内消息。
• 多种地图规模：支持2队（2岛）或4队（4岛）模式。
• API支持：您可以通过插件API在游戏基础上添加自己的功能。

🔧安装与设置

• 下载插件。
• 将其放入服务器的 plugins 文件夹。
• 重启服务器或重载插件以生成配置文件。
• 根据需要配置 config.yml 文件。
• 准备就绪后，按照设置视频教程添加地图。

设置视频： 请参考相关教程。

🎮命令

• /tb play - 打开游戏选择菜单。
• /tb join [name] - 加入指定名称的游戏。
• /tb leave - 离开当前游戏。
• /tb create [game_name] - 创建一个新游戏。
• /tb edit [game_name] - 编辑一个已存在的游戏。
• /tb set inventory bar - 设置默认的物品栏位置。

⭐权限

• TheBridge.play - 允许玩家参与游戏。
• TheBridge.admin - 允许创建和编辑游戏（管理员权限）。

❓配置文件详解

配置文件 (config.yml) 允许深度自定义游戏体验。以下是一些关键配置项的说明：

基本设置

• End_Command：游戏结束时每位玩家执行的命令（例如传送到大厅）。
• Save_Locally：设置为 true 在本地保存用户数据；设置为 false 则使用数据库。

队伍配置

可配置最多4支队伍 (Team1 至 Team4)，每队可设置：

• ColorPrefx：颜色代码前缀（如 &4 代表红色）。
• ColorName：队伍颜色名称。
• Color：RGB颜色值。
• BlockMaterial：代表队伍颜色的方块材质。

游戏属性

• Fireworks_enabled：是否启用烟花效果。
• Save_players_inventory：是否保存玩家原有物品栏。
• Fall_damage：是否启用摔落伤害。

时间设置

• Waiting_In_Lobby：大厅等待玩家时间（秒）。
• Waiting_For_Next_Round：下一轮开始前的等待时间（秒）。
• Waiting_Before_End：游戏结束到执行 End_Command 的等待时间（秒）。

游戏常量

• Winning_Score：获胜所需分数（默认为5）。
• Start_percentage：游戏自动开始所需玩家比例（0.0 - 1.0）。
• Arrow_refresh：箭矢刷新速率（秒）。
• Spectator_border, Border_side, Border_Up：观战者边界范围。
• pit_radius：得分坑洞的半径。

消息与文本

所有消息均支持Minecraft颜色代码（如 &a 绿色， &c 红色）。可自定义的消息包括：

• 游戏开始、等待玩家、游戏结束的标题、副标题和行动栏文本。
• 玩家加入、离开、得分、击杀等聊天消息。
• 游戏内菜单、物品（如退出物品 RED_BED）的名称和描述。
• 大厅和游戏内记分板的标题和文本。

✨其他信息

• 相关插件：请查看插件页面或社区获取兼容插件信息。
• 加入Discord：https://discord.gg/2dcXEtP

要获取 The Bridge 插件的对象实例，只需使用以下代码。

🎮获取插件实例

TheBridge theBridge = (TheBridge) Bukkit.getPluginManager().getPlugin("TheBridge");

💡事件列表

以下是插件提供的主要事件，你可以在自己的插件中监听这些事件。

GameEndEvent

• 调用时机：当一局游戏结束时触发。
• 参数：Game game

GameStartEvent

• 调用时机：当一局游戏开始时触发。
• 参数：Game game

GameStateChangeEvent

• 调用时机：当游戏状态发生改变时触发。
• 参数：Game game, GameState stageFrom, GameState stageTo

PlayerKilledInGameEvent

• 调用时机：当玩家在游戏内被击杀时触发。
• 参数：Player player, Game game, String gameName, String message

PlayerScoreGameEvent

• 调用时机：当玩家在游戏中得分时触发。
• 参数：Player player, Game game

🔧使用示例

以下是一个监听 GameEndEvent 并广播玩家数据的示例。

@EventHandler
public void OnGameEndEvent(GameEndEvent e) {
    for (Entry<String, TeamPlayer> entryPlayer : e.getGame().teamPlayers.entrySet()) {
        String playerName = entryPlayer.getKey();
        TeamPlayer teamPlayer = entryPlayer.getValue();
        Bukkit.broadcastMessage(playerName + " scored " + teamPlayer.scores + " goals and got " + teamPlayer.kills + " kills!");
    }
}