TNTRun_reloaded - TNTRun重载版

TNTRun_reloaded 是一款高度可配置、全自动的经典跑酷小游戏。玩家从由 TNT 支撑的沙层（或任何自定义方块组合）上开始奔跑，脚下的方块会随之消失。若玩家从一层掉落，将继续在下一层奔跑。当玩家从最后一层掉落时即告失败并成为旁观者，坚持到最后的玩家获胜。本插件功能丰富，支持多竞技场、自定义商店、队伍系统、计分板、占位符等，并持续更新以适配新版 Minecraft。

💡版本与要求

• 最新版本要求：Java 21 及 Minecraft/Spigot 1.21.3+。
• 旧版支持：

- 适用于 Minecraft/Spigot 1.21 - 1.21.2 的服务器，请下载版本 9.29。

- 适用于 Minecraft/Spigot 1.20.6 的服务器，请下载版本 9.29.1。

- 适用于 Java 17 及 Minecraft 1.17.1 - 1.20.4 的服务器，请下载版本 9.27。

- 更多旧版下载链接请查阅插件页面。

• 注意：旧版功能可能不全，仅提供有限维护和错误修复。

🎮核心特性

• 支持多个可独立配置的竞技场。
• 自动竞技场重置与方块消失延迟。
• 可配置的强制开始投票系统与命令。
• 自定义商店，可购买武器、盔甲、二段跳、药水、雪球等物品。
• 每场游戏可设置加入费用（金钱或游戏物品）与获胜奖励（金钱、材料、经验或命令）。
• 支持 PVP（可按竞技场启用/禁用）与职业套装系统。
• 内置队伍系统，并支持 AlessioDP Parties 插件。
• 与 HeadsPlus 集成，允许玩家在游戏中购买和佩戴自定义头颅。
• 完整的计分板、排行榜、占位符与全息图支持。
• 可自定义的加入菜单、音效、标题与 Boss 血条。
• 旁观者系统与反挂机机制。
• 支持 BungeeCord 与 MySQL。
• 通过 Crowdin 支持多语言本地化。

🔧依赖插件（可选）

• WorldEdit 7.3.9：用于快速选择竞技场区域（也可使用内置选择命令）。
• Vault 1.7：用于经济系统（设置费用与奖励）。
• HeadsPlus 7.1.5：允许玩家在游戏中购买和佩戴自定义头颅。
• PlaceholderAPI 2.11.6：使用占位符所必需。
• mcMMO 2.2.028：若已安装，可允许同 mcMMO 队伍的成员在竞技场内进行 PVP。
• DecentHolograms 2.8.8：用于创建全息图的示例插件。
• Parties 3.2.16：可替代内置队伍系统。
• TNTRun Timed Rewards：可选附加组件，用于记录游戏时间并奖励生存时长。
• IridiumColorAPI：用于在配置中实现渐变和彩虹色效果。

✨安装与升级

• 下载 TNTRun_reloaded.jar。
• 将其放入服务器的 plugins 文件夹。
• 重启服务器以生成默认配置文件。
• 从旧版 TNTRun 迁移：移除旧版插件文件，放入 TNTRun_reloaded，启动并关闭服务器一次，然后将 plugins\TNTRun\arenas 文件夹的内容复制到 plugins\TNTRun_reloaded\arenas，最后重启服务器即可。

❓基础命令（玩家）

• /tr list - 列出所有 TNTRun 竞技场。
• /tr join {arena} - 加入指定竞技场（需权限 tntrun.join）。
• /tr join - 打开竞技场加入菜单（需权限 tntrun.joinmenu）。
• /tr autojoin {pvp|nopvp} - 自动加入等待玩家最多的竞技场。
• /tr party {option} - 队伍相关命令。
• /tr leave - 离开当前竞技场。
• /tr vote - 投票强制开始游戏。
• /tr lobby - 传送至 TNTRun 大厅。
• /tr stats - 显示您的游戏记录。
• /tr leaderboard {size} - 显示排行榜。
• /tr listkit - 列出所有职业套装。
• /tr start {arena} - 强制开始竞技场（需权限 tntrun.start）。
• /tr spectate {arena} - 以旁观者身份加入（需权限 tntrun.spectate）。
• /tr info - 显示插件信息。
• /tr help - 显示所有 /tr 命令。

❓管理命令（需权限 `tntrun.setup`）

竞技场配置

• /trsetup create <arena> - 创建新竞技场。
• /trsetup setarena <arena> - 设置竞技场边界（需先用 WorldEdit 选择两个对角点）。
• /trsetup setloselevel <arena> - 设置失败高度（站在所需 Y 坐标执行）。
• /trsetup setspawn <arena> - 设置出生点。
• /trsetup setspectate <arena> - 设置旁观者出生点。
• /trsetup finish <arena> - 完成竞技场创建并启用。
• /trsetup setlobby - 设置全局大厅位置（只需设置一次）。
• /trsetup setmaxplayers/minplayers/timelimit/countdown... - 设置玩家数量、时间限制、倒计时等参数。

其他管理

• /trsetup setfee {arena} {amount} - 设置加入费用。
• /trsetup setcurrency {arena} {currency_item} - 设置费用货币（物品）。
• /trsetup setreward {arena} - 设置获胜奖励（金钱、物品、经验、命令）。
• /trsetup addkit {kit} - 创建职业套装（将复制你当前库存的所有物品和效果）。
• /trsetup linkkit {arena} {kit} - 将套装链接至竞技场。
• /trsetup enable/disable/delete {arena} - 启用/禁用/删除竞技场。
• /trsetup reloadconfig/msg/bars/titles - 重载各类配置文件。

🔧竞技场设置示例

• 使用 WorldEdit 等工具建造一个多层竞技场（例如 TNT 支撑沙层），层间保留足够跳跃空间（如 7 格高差）。
• 执行 /trsetup create <竞技场名称>。
• 用 WorldEdit 选择完全包裹竞技场的两个对角点（一上一下），然后执行 /trsetup setarena <竞技场名称>。
• 站在你希望玩家失败的高度（最后一层之下），执行 /trsetup setloselevel <竞技场名称>。
• 站在竞技场顶层出生点，执行 /trsetup setspawn <竞技场名称>。
• 站在旁观者出生点，执行 /trsetup setspectate <竞技场名称>。
• 执行 /trsetup finish <竞技场名称> 完成创建。
• （可选）站在大厅位置，执行 /trsetup setlobby 设置全局大厅。

⭐权限节点

• tntrun.join：允许加入竞技场（默认：true）。
• tntrun.setup：允许使用所有 /trsetup 命令（默认：op）。
• tntrun.joinmenu：允许使用加入菜单（默认：true）。
• tntrun.start：允许强制开始游戏（默认：op）。
• tntrun.spectate：允许以旁观者加入（默认：op）。
• tntrun.heads：允许使用 HeadsPlus 头颅功能（默认：true）。
• tntrun.shop：允许购买商店物品（默认：true）。
• tntrun.party：允许使用内置队伍命令（默认：true）。
• tntrun.doublejumps.n：限制玩家可拥有的二段跳数量，n 为数字（默认：false）。
• tntrun.forcejoinbypass：允许玩家免受强制加入命令影响（默认：op）。

🎮配置亮点

计分板

在 config.yml 的 scoreboard 部分可自定义等待中、游戏中、大厅内的计分板文本。支持 Hex/RGB 颜色、渐变效果及 PlaceholderAPI 占位符（如 %vault_eco_balance%）。

商店

物品在 shop.yml 中定义。可设置价格、所需权限、描述。药水效果使用 <效果>#<时长>#<强度> 格式，雪球可设置击退等级（0-5）。购买后物品在游戏开始时发放。

职业套装

使用 /trsetup addkit {套装名} 创建套装（复制你当前库存）。可在竞技场中启用随机分配，或使用 /trsetup linkkit 链接特定套装。

二段跳

可在配置中启用免费二段跳，或设置购买上限。跳跃高度和距离可通过 multiplier 和 height 调整。也可通过权限 tntrun.doublejumps.n 限制数量。

队伍

内置队伍系统允许队长带领队员同时加入同一竞技场。也支持 AlessioDP Parties 插件。详细用法请查阅 Wiki。

占位符

插件提供丰富的 PlaceholderAPI 占位符，用于显示游戏次数、胜率、当前竞技场状态、玩家数量、排行榜数据等。可用于计分板、全息图或聊天栏。

自定义事件

开发者可通过插件提供的自定义事件（如 PlayerJoinArenaEvent、PlayerWinArenaEvent、ArenaStartEvent 等）进行功能扩展。

🔧支持与反馈

• 遇到问题或提出建议，请通过 GitHub Issues、Discussions 或 Discord 服务器联系。
• 请勿在评论区域请求帮助或新功能。
• 本插件使用 bStats 收集匿名使用数据以帮助改进，你可以在配置中禁用。

TNTRun 插件文档

TNTRun 是一款经典的 Minecraft 小游戏插件，玩家脚下的方块会逐渐消失，最后一名未掉入虚空的玩家即为胜者。它支持多种游戏模式、强大的自定义选项，并能与 PlaceholderAPI 等插件集成，为服务器提供紧张刺激的竞技体验。

💡核心特性

• 多种游戏模式：支持经典模式、团队模式、PvP 模式等。
• 高度可配置：可自定义游戏地图、方块消失速度、重生保护时间、奖励等。
• 经济系统集成：支持与 Vault 经济插件联动，设置游戏入场费与获胜奖励。
• 多语言支持：内置多种语言文件，可轻松适配不同玩家群体。
• 统计与排行榜：记录玩家胜负数据，并可通过 PlaceholderAPI 在别处显示。
• BungeeCord 支持：可将玩家跨服传送至指定的 TNTRun 游戏大厅。

🎮命令与权限

玩家命令

• /tntrun 或 /tr：显示帮助信息。
• /tntrun join ：加入指定的竞技场。
• /tntrun leave：离开当前游戏。
• /tntrun list：列出所有可用的竞技场。
• /tntrun stats [玩家名]：查看自己或他人的游戏统计信息。
• /tntrun top：查看排行榜。
• /tntrun vote：对当前游戏地图进行投票（若启用）。

管理员命令

• /tntrun create ：创建一个新的竞技场。
• /tntrun delete ：删除一个竞技场。
• /tntrun setlobby：设置游戏大厅出生点。
• /tntrun setspawn ：设置竞技场内玩家的出生点。
• /tntrun finish：完成当前竞技场的区域设置（设定游戏边界）。
• /tntrun addspectator ：为竞技场添加观战点。
• /tntrun reload：重载插件配置与语言文件。

主要权限节点

• tntrun.play：允许玩家加入游戏。（默认拥有）
• tntrun.sign.create：允许创建加入游戏用的招牌。
• tntrun.command.*：授予所有管理员命令权限。
• tntrun.vip：VIP 玩家权限，可用于跳过等待队列等。

🔧安装与设置

安装步骤

• 确保服务器已安装 Java 8 或更高版本 和 Spigot/Paper 1.13+。
• 将下载的 TNTRun.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件和文件夹。
• 根据需求编辑 plugins/TNTRun/config.yml 和 arena.yml 文件。

创建第一个竞技场

• 在游戏内，使用 WorldEdit 工具或手动建造一个游戏平台。
• 站在平台一角，执行 /tntrun create 。
• 走到平台的对角，执行 /tntrun finish 以设定游戏区域。
• 在平台内为每位玩家设置出生点：/tntrun setspawn 。
• 使用 /tntrun setlobby 设置游戏大厅（玩家游戏结束后传送的位置）。
• 在配置文件中调整该竞技场的游戏模式、人数等设置。
• 重载配置：/tntrun reload，然后玩家即可使用 /tntrun join 加入游戏。

✨依赖与兼容性

可选依赖（增强功能）

• Vault：用于提供经济系统支持，实现游戏货币奖励与消费。
• PlaceholderAPI：提供丰富的占位符，用于在计分板、聊天或其他插件中显示游戏数据。
• WorldEdit：辅助管理员快速建造和编辑游戏地图。
• BungeeCord：实现跨服务器连接游戏大厅。

兼容版本

• 本插件支持 Minecraft 1.13 至最新版本 的 Spigot、Paper 及其衍生服务端。

❓常见问题

• Q：玩家加入游戏后卡在观察模式？
• A：请检查是否已正确设置玩家出生点 (/tntrun setspawn)，并且游戏区域 (/tntrun finish) 已完整包含这些出生点。
• Q：方块不消失或消失速度异常？
• A：请检查 config.yml 中的 block-removal-delay（方块移除延迟）和 level-loss-per-step（每步消失层数）设置。同时确认竞技场地板材质在 allowed-blocks 列表内。
• Q：如何设置游戏奖励？
• A：在 config.yml 的 reward 部分进行配置。需要安装 Vault 和经济插件（如 EssentialsX）来实现货币奖励。
• Q：如何将排行榜显示在计分板上？
• A：安装 PlaceholderAPI 和 TNTRun 的扩展，然后使用 `%tntrun_stats_wins_to...