TNTRun - 多模式 排行榜支持 MySQL

💡全新 TNTRun 插件 - 重制无延迟版现已发布！

一款完全重写、彻底消除延迟的全新 TNTRun 插件现已免费推出！此版本无需任何依赖，并支持 Vault 经济系统，让你即刻享受流畅的跑酷爆炸体验。

🎮核心特性

• 无依赖设计：插件本身无需任何前置插件即可运行。
• Vault 支持：完美兼容 Vault 经济系统。
• LeaderHeads 支持：支持与 LeaderHeads 排行榜插件联动，可自定义变量。
• 高效地图再生系统：全新的地图再生机制，运行流畅无延迟。
• BungeeCord 与多世界模式：全面支持 BungeeCord 网络和单服务器多世界模式。
• Bungee 模式地图：在 Bungee 模式下，支持使用固定地图或随机轮换地图。
• 高度自定义：所有游戏消息、告示牌文本等均可自定义。
• 数据统计：支持 MySQL 数据库和本地文件两种方式存储玩家数据。
• 动态记分板：集成抗闪烁的动态记分板功能。
• 告示牌玻璃背景：为游戏加入告示牌自动添加玻璃背景。
• 无限竞技场：可创建无限数量的游戏竞技场。
• 胜利指令：可为获胜者配置自定义执行指令。
• API 支持：提供完整的 API 接口，方便开发者获取统计数据或监听事件。

权限节点

• tntrun.join.signs：允许玩家通过告示牌加入游戏。
• tntrun.force：允许使用强制开始游戏的指令。
• tntrun.setup：允许进行竞技场设置。
• tntrun.sign.create：允许创建游戏加入告示牌。
• tntrun.sign.destroy：允许破坏游戏加入告示牌。

🔧指令列表

主指令为 /tntrun，使用 /tntrun help 查看帮助。

管理与设置指令

• /tntrun create <竞技场名称>：创建一个新的竞技场。
• /tntrun set spawn <竞技场名称>：设置该竞技场内玩家的出生点。
• /tntrun set spectate <竞技场名称>：设置该竞技场观战者的出生点。
• /tntrun set bounds <竞技场名称>：设置竞技场的边界。
• /tntrun set point1：设置区域点 1（用于定义边界）。
• /tntrun set point2：设置区域点 2（用于定义边界）。
• /tntrun set loselevel <竞技场名称>：设置竞技场的淘汰高度（玩家低于此高度即失败）。
• /tntrun set time <竞技场名称> <时间>：设置游戏开始倒计时。
• /tntrun set minplayers <竞技场名称> <数量>：设置开始游戏所需的最小玩家数。
• /tntrun set maxplayers <竞技场名称> <数量>：设置竞技场的最大玩家容量。
• /tntrun finish <竞技场名称>：完成竞技场创建，保存所有配置和数据。
• /tntrun reload：重载 config.yml 和 messages.yml 配置文件。

玩家与游戏指令

• /tntrun join <竞技场名称>：加入指定竞技场。
• /tntrun leave：离开当前所在的竞技场。
• /tntrun stats：查看自己的游戏统计信息。
• /tntrun force <竞技场名称>：强制开始某个竞技场的游戏。

✨开发者 API

插件提供了丰富的 API，方便其他插件进行功能扩展与集成。

统计数据获取

通过 TNTRunAPI 类可以获取玩家数据：

Class: me.tade.tntrun.TNTRunAPI
Method: #getStats(Player, StatsType) returns Integer

事件监听

插件提供了多个可监听的事件，方便开发者挂钩游戏流程：

import me.tade.tntrun.events.TNTRunPlayerJoinEvent;
import me.tade.tntrun.events.TNTRunPlayerLeaveEvent;
import me.tade.tntrun.events.TNTRunPlayerLoseEvent;
import me.tade.tntrun.events.TNTRunPlayerWinEvent;

// 玩家加入竞技场事件
@EventHandler
public void onArenaJoin(TNTRunPlayerJoinEvent e){
    Player p = e.getPlayer();
    Arena a = e.getArena();
    e.setCancelled(Boolean); // 可通过此处取消加入
}

// 玩家离开竞技场事件
@EventHandler
public void onArenaLeave(TNTRunPlayerLeaveEvent e){
    Player p = e.getPlayer();
    Arena a = e.getArena();
}

// 玩家游戏失败事件
@EventHandler
public void onArenaLost(TNTRunPlayerLoseEvent e){
    Player p = e.getPlayer();
    Arena a = e.getArena();
}

// 玩家游戏胜利事件
@EventHandler
public void onArenaWin(TNTRunPlayerWinEvent e){
    Player p = e.getPlayer();
    Arena a = e.getArena();
}

自定义游戏物品

你可以在 items.yml 配置文件中自定义游戏内物品，例如退出物品：

leave:
  id: WHITE_BED
  subid: 0
  name: '&c&l离开竞技场'
  command: tntrun leave
  slot: 9
  giveAfter: 2
  lore:
  - '&7离开当前竞技场'

❓告示牌使用指南

创建加入游戏的告示牌非常简单

• 第一行固定填写：[TNTRun]
• 第二行填写：<竞技场名称>
• 若要删除告示牌，请在创造模式下潜行对其点击。

⭐教程与支持

• 设置教程：作者提供的设置教程视频同样适用于 Bungee 模式。
• 地图类型说明：

- 若地图类型设置为 `shuffled`（随机），服务器将随机选取一张地图。

- 若地图类型设置为 `normal`（普通），服务器将始终使用创建的第一张地图。

• 社区视频：

- 游戏演示 by @ericbarbwire

- 竞技场创建教程 by @SnapSpik

- 意大利语教程 by @jonnycp9

- 意大利语游戏演示 by @jonnycp9

获取帮助与反馈

• 支持作者：如果你喜欢这个插件，可以通过 PayPal 支持作者。
• Discord 社区：如需帮助，请加入作者的 Discord 服务器。
• 问题与建议：请将遇到的 Bug 或新功能想法发布在插件的讨论页面，作者会尽力回复、修复或添加。
• 重要提示：本插件仍在持续开发中，功能将不断完善。请不要轻易给予负面评价，感谢你的理解与支持！