TNT Run - 方块逃亡挑战

TNT Run 是一款快节奏的跳跃跑酷游戏，玩家需要在不断消失的方块平台上生存到最后。本插件功能丰富且高度可配置，支持创建多个独立竞技场、自定义地图、MySQL数据存储，并集成了PlaceholderAPI等。

💡游戏玩法

玩家（通常每张地图支持12或24人）将被放置在由沙/沙砾构成的多层平台上。玩家奔跑或站立过的方块会在短暂延迟后“掉落”。一旦掉落，玩家会坠落到下一层平台。每张地图都有多层平台，最底层之下即是虚空，坠入则被淘汰。游戏目标是成为最后存活的玩家，随着可用空间不断缩小，挑战将愈发困难。

特殊能力：二段跳

为帮助玩家生存，每位玩家都拥有二段跳能力。

• 可通过双击跳跃键（默认：空格） 或右键点击物品栏中的羽毛来激活。
• 二段跳会将玩家朝其面向的方向弹射，帮助跨越较大间隙、防止坠落，甚至跳上更高平台。
• 默认情况下，每位玩家拥有 5 次二段跳机会。

✨主要特性

• 无限竞技场：可创建任意数量的游戏实例，仅受想象力限制。
• 自定义地图设计：构建个性化地图以实现独特的游戏构想。
• MySQL 支持：通过 MySQL 集成轻松追踪和管理玩家数据。
• BungeeCord 兼容性：将每个服务器实例变为独立的游戏，获得流畅的 BungeeCord 体验。
• 地图自动恢复：每局游戏后自动将所有方块恢复至原始状态。
• 背包管理：保存并恢复玩家背包，确保物品不会丢失。
• 计分板与 Boss 血条：为不同竞技场的各种游戏状态提供完全可自定义的消息。
• 独立聊天：将游戏内聊天与服务器其他部分隔离，提供更沉浸的玩家体验。
• 玩家隐藏：限制玩家可见性，仅游戏内玩家可互相看到，观察者与非参与者将被隐藏。
• TOP 10 排行榜：显示得分最高的玩家。
• 命令限制：控制玩家在游戏中可使用的命令，确保公平体验。
• PlaceholderAPI 支持：集成 PlaceholderAPI，提供 17+ 种不同的占位符。
• 开发者 API：为开发者提供 API。
• 超过 20 项可自定义设置：提供更多定制选项以增强游戏体验。

🔧安装与设置

最低 Java 版本：Java 21

• 下载插件并将其放入服务器的 plugins 文件夹。
• 启动服务器，让插件生成配置文件。
• 使用命令 /tntrun create <arena_name> 创建一个竞技场。
• 使用命令 /tntrun edit <arena_name> 打开竞技场编辑器菜单进行设置。

-   首先，点击白色混凝土，设置大厅和结束位置（开始位置与大厅位置相同）。

-   接着，可点击命名牌更改地图名称（在聊天中输入新名称）。此步骤可选，默认地图名与竞技场 ID 相同。

-   然后，可点击荧石粉更改最小和最大玩家数量。此步骤可选。

-   完成后，点击屏障物品以注册该竞技场。之后也可随时使用 `/tntrun edit <arena_name>` 命令再次编辑。

• 完成设置并注册竞技场后，即可开始游戏。使用 /tntrun join <arena_name> 或 /tntrun randomjoin 命令加入竞技场。

🎮命令列表

管理员命令

• /tntrun create <arena_name> - 创建游戏实例。
• /tntrun delete <arena_name> - 删除指定 ID 的游戏实例。
• /tntrun edit <arena_name> - 打开竞技场编辑器菜单。
• /tntrun list - 显示现有竞技场 ID 列表。
• /tntrun forcestart - 如果玩家数量足够，强制开始玩家所在的竞技场。
• /tntrun stop - 强制停止玩家所在的竞技场。
• /tntrun reload - 重新加载配置文件。
• /tntrun help - 显示可用命令列表及其描述。

玩家命令

• /tntrun join <arena_name> - 尝试加入目标竞技场。
• /tntrun randomjoin - 尝试加入玩家最多的可用竞技场。
• /tntrun leave - 玩家尝试离开当前竞技场。
• /tntrun stats [player] - 显示玩家自己或目标玩家的统计数据。
• /tntrun top <statistic_name> - 显示指定统计数据的 TOP 10 玩家。

⭐权限节点

• tntrun.admin
• tntrun.admin.create
• tntrun.admin.delete
• tntrun.admin.edit
• tntrun.admin.list
• tntrun.admin.help
• tntrun.admin.forcestart
• tntrun.admin.stop
• tntrun.admin.sign.create
• tntrun.admin.sign.break
• tntrun.admin.reload
• tntrun.command.override

❓PlaceholderAPI 占位符

玩家相关

• %tntrun_player%
• %tntrun_uuid%
• %tntrun_wins%
• %tntrun_loses%
• %tntrun_games_played%
• %tntrun_longest_survive%
• %tntrun_coins%
• %tntrun_local_coins%
• %tntrun_local_survive%
• %tntrun_local_double_jumps%

竞技场相关

• %tntrun_<arena-id>: players%
• %tntrun_<arena-id>: players_left%
• %tntrun_<arena-id>:max_players%
• %tntrun_<arena-id>:min_players%
• %tntrun_<arena-id>:state%
• %tntrun_<arena-id>:state_pretty%
• %tntrun_<arena-id>:map_name%
• %tntrun_<arena-id>:timer%
• %tntrun_<arena-id>:timer_pretty%

TOP 10 排行榜

• %tntrun_top:<statistic-name>:<position>:name%
• %tntrun_top:<statistic-name>:<position>:value%

可用统计名称：

• wins
• loses
• coinsearned
• gamesplayed
• longestsurvive

🔧配置摘要

主要配置文件 (config.yml) 包含以下可调设置：

• 时间设置：大厅等待时间、开局倒计时、结束等待时间、方块开始消失延迟等。
• 二段跳：默认次数、使用冷却、权限组设置（如 tntrun.doublejumps.3）。
• 方块扫描深度：玩家在地面与空中时，检测方块的深度。
• 可消失方块白名单：默认包括 TNT、沙子、砂岩、沙砾、染色粘土、红砂岩等。
• 加入权限：控制谁能加入游戏及谁可加入已满游戏。
• 功能开关：进度条、统计保存、命令限制、计分板、Boss 血条、BungeeCord 支持、背包管理、跌落伤害、MySQL、名称标签隐藏、PvP、聊天格式、独立聊天、即时离开、最长生存统计条件、更新通知等。
• 消息与本地化：所有游戏内提示、计分板内容、GUI 文本等均在 messages.yml 中完全自定义。

---

开发者：Despical (Berke Akçen)

版权：Copyright 2025 © Berke Akçen

Discord：https://discord.gg/uXVU8jmtpU

💡安装方法

• 下载插件文件。
• 打开您的服务器文件夹，将插件文件放入 plugins 文件夹中。
• 重启服务器即可开始使用。