The Bridge - 桥梁对战插件

💡简介

TheBridge 是一款基于团队合作的 PvP 小游戏插件。玩家需要保护己方床的同时，尝试摧毁对手的床，并最终消灭所有对手以获得胜利。它提供了丰富的自定义选项和流畅的游戏体验。

🎮功能特性

• 完整的游戏系统：包含队伍、床、重生、资源生成和胜利条件。
• 高度可配置：支持通过配置文件自定义队伍数量、队伍大小、游戏时长、资源生成速率等。
• 多语言支持：内置多种语言文件，可轻松切换。
• 统计系统：记录玩家的胜负、击杀等数据。
• 美观的记分板与行动栏：实时显示游戏信息。
• 内置地图管理系统：支持通过命令轻松管理游戏地图。
• 扩展 API：方便开发者进行二次开发。

🔧命令与权限

主要命令

• /thebridge 或 /tb - 显示插件主命令帮助。
• /tb createarena <名称> - 创建一个新的竞技场（需要权限）。
• /tb deletearena <名称> - 删除一个竞技场（需要权限）。
• /tb list - 列出所有可用的竞技场。
• /tb randomjoin - 随机加入一个可用的竞技场。
• /tb leave - 离开当前所在的竞技场。
• /tb stats [玩家名] - 查看自己或他人的游戏统计信息。
• /tb reload - 重载插件配置（需要权限）。
• /tb stop - 强制停止当前游戏（需要权限）。

常用权限节点

• thebridge.admin - 授予所有管理命令的使用权。
• thebridge.join.<竞技场名> - 允许玩家加入指定竞技场。
• thebridge.join.* - 允许玩家加入所有竞技场。
• thebridge.leave - 允许玩家使用离开命令。
• thebridge.stats - 允许玩家查看统计信息。

✨安装与设置

安装步骤

• 确保服务器运行的是 Paper、Spigot 或其衍生服务端（推荐 Paper 1.17+）。
• 将下载的 TheBridge.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 首次运行后，插件会在 plugins/TheBridge 目录下生成配置文件和地图文件夹。
• 根据需求编辑 config.yml 和 arenas.yml 等配置文件。

创建一张地图

• 在游戏内，使用 WorldEdit 等工具建造好完整的地图结构（包括床、生成点、资源点等）。
• 使用命令 /tb createarena <地图名> 开始设置流程。
• 根据聊天提示，依次用木斧（或徒手）点击设置：
• 竞技场边界（两个对角点）
• 每个队伍的生成点
• 每个队伍的床的位置
• 每个队伍的资源生成点
• 所有步骤完成后，地图即可投入使用。

❓常见问题

• Q: 玩家无法加入游戏？
• A: 请检查竞技场是否已正确设置完成，并确保玩家拥有 thebridge.join.<竞技场名> 权限。

• Q: 如何重置玩家统计数据？
• A: 统计数据存储在 stats.yml 文件中，可以手动编辑或删除该文件（重启后生效）。

• Q: 支持哪些 Minecraft 版本？
• A: 插件主要支持 1.17 及以上版本。部分功能在旧版本上可能受限。

• Q: 如何翻译插件？
• A: 在 plugins/TheBridge/languages 文件夹中找到对应的语言文件（如 messages_zh.yml）并进行编辑，然后在 config.yml 中设置 language 选项。

⭐注意事项

• 使用前请确保已安装 Vault 插件（如需经济功能）和 ProtocolLib（如需完整的粒子效果等功能）。
• 定期备份你的地图和配置文件。
• 在大量修改配置后，建议使用 /tb reload 重载插件。

🔧链接与支持

• 官方资源：插件下载与更新请访问 SpigotMC 资源页面。
• 问题反馈：遇到 Bug 或有功能建议，请在官方页面讨论区提交。
• 开源仓库：本插件为开源项目，由 Plugily Projects 维护，贡献者名单可在项目页面查看。

---

部分图标由 www.flaticon.com 的作者制作。

Copyright ⓒ 2023 - Plugily Projects , TheBridge Project maintained by @Tigerkatze and contributors

Minigame Plugin 文档

Minigame Plugin 是一款功能强大的 Minecraft 小游戏插件，支持多种游戏模式，如饥饿游戏、团队战、夺旗等。它提供了高度可定制的游戏体验，从地图管理、队伍系统到复杂的游戏机制，都能通过直观的配置和命令轻松实现。

💡核心特性

• 多游戏模式支持：内置多种流行的小游戏类型，并可通过扩展添加更多。
• 高度可配置：几乎所有游戏参数，如时间、队伍、物品生成、胜利条件等，都可自定义。
• 地图管理系统：支持多张地图的独立配置与循环使用。
• 玩家统计与排行榜：记录玩家数据，并可通过内置或外部插件显示排行榜。
• 强大的 API：为开发者提供丰富的 API，方便创建自定义扩展或集成其他插件。
• 多语言支持：内置多种语言文件，并允许社区贡献翻译。

主要游戏模式

• 饥饿游戏 (Hunger Games)：经典的生存竞技模式。
• 团队战 (Team Deathmatch)：队伍之间的对抗。
• 夺旗 (Capture the Flag)：夺取对方旗帜并带回己方基地。
• 空岛战争 (SkyWars)：在空岛上开始，收集资源并击败对手。

🎮命令与权限

常用玩家命令

• /play [游戏名]：加入指定游戏的等待大厅。
• /leave：退出当前游戏。
• /vote：在游戏开始前投票选择地图。
• /stats [玩家名]：查看自己或其他玩家的游戏统计信息。

常用管理员命令

• /arena create [游戏名] [地图名]：为指定游戏模式创建一个新的竞技场。
• /arena delete [竞技场名]：删除一个竞技场。
• /arena list：列出所有已配置的竞技场。
• /setup：进入设置模式，用于配置竞技场区域（如等待区、游戏区、出生点）。
• /admin：打开管理员管理菜单。

主要权限节点

• plugilyprojects.minigame.user：允许玩家使用基本命令（如 /play, /leave）。
• plugilyprojects.minigame.admin：授予所有管理员权限，包括创建、删除竞技场和配置设置。
• plugilyprojects.minigame.stats.see：允许查看统计信息。
• plugilyprojects.minigame.vip：可授予VIP特权，如加入已满游戏。

🔧安装与设置

安装步骤

• 确保服务器运行 Spigot、Paper 或兼容的 Minecraft 1.13+ 服务端。
• 将下载的 MinigamePlugin.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件和文件夹。
• 根据需要，将可选的地图文件放入 plugins/MinigamePlugin/Maps/ 目录。
• 使用管理员命令开始创建和配置你的第一个竞技场。

基本配置流程

• 使用 /arena create [游戏名] [地图名] 创建竞技场。
• 使用 /setup 命令，并按照聊天提示依次设置：
• 主等待大厅（如果未设置全局大厅）
• 竞技场的等待区（玩家准备区域）
• 游戏区域边界
• 每个队伍的出生点
• 游戏结束后的传送点
• 在设置模式中，使用木棍（默认工具）左键和右键点击方块来设定区域位置。
• 完成所有步骤后，保存配置并重启竞技场。

✨依赖与兼容性

可选依赖（增强功能）

• PlaceholderAPI：支持在其它插件中使用游戏统计变量（如 %minigameplayer_kills%）。
• Vault：用于经济系统集成，可设置游戏入场费或获胜奖励。
• WorldEdit：便于快速导入和设置游戏地图。
• ProtocolLib：某些高级视觉效果或机制可能需要。

兼容性说明

• 核心插件本身无需任何依赖即可运行。
• 建议使用 Paper 服务端以获得最佳性能和兼容性。
• 与大多数权限管理插件（如 LuckPerms）兼容。
• 请注意，某些扩展子插件可能需要特定版本的 Minigame Plugin。

❓常见问题

游戏无法启动

• 检查竞技场设置：确保所有必要区域（等待区、游戏区、出生点）都已正确配置。
• 检查最低玩家数：在配置文件中，确保 minimumplayers 设置正确，且在线玩家足够开始游戏。
• 查看服务器日志：重启服务器或重载竞技场时，查看控制台是否有错误信息。

玩家无法加入竞技场

• 检查权限：确认玩家拥有 plugilyprojects.minigame.user 权限。
• 检查竞技场状态：使用 /arena list 查看竞技场是否已启用（ENABLED）且未在运行中。
• 检查地图是否加载：确认竞技场使用的地图世界已正确加载。

如何添加新地图？

• 将地图世界文件夹放入服务器的根目录（与 plugins 文件夹同级）。
• 确保在 server.properties 中 level-name 不是该地图名，以免冲突。
• 使用 /arena create [游戏名] [地图世界名] 创建新竞技场。
• 进入设置模式（/setup），在新世界内配置竞技场区域。

如何更新插件？

• 从官方来源下载新版本的 MinigamePlugin.jar。
• 关闭服务器。
• 替换 plugins 文件夹中的旧 JAR 文件。
• 启动服务器。通常配置会自动迁移，但建议备份 plugins/MinigamePlugin 文件夹。

如需更多帮助，请访问 Plugily Projects 官方网站 或加入 Discord 社区。