[插件][2020.12.20][CPS]一起来玩小游戏吧——TNTRun插件配置详解 - 联机教程

叁肆.

本帖最后由枫黎秋于 2021-3-27 19:18 编辑

教程介绍
- 此教程为TNTRun小游戏插件教程，将会对国内外较为火热的TNTRun插件进行讲解，从插件安装到文件配置，“手把手”地教学习者制作自己的TNTRun小游戏服务端。对于站内小游戏教程较少，此教程也用于弥补此状情况，推动国内小游戏服务器发展。为了便于学习者学习，本教程大多数使用较为通俗易懂的语言，尽量避免专业术语对学习者的困扰

字数统计

更新日志
- 2020/8/4 教程首次发布

2021.12 数据，可能有更多内容

教程介绍
- 此教程为TNTRun小游戏插件教程，将会对国内外较为火热的TNTRun插件进行讲解，从插件安装到文件配置，“手把手”地教学习者制作自己的TNTRun小游戏服务端。对于站内小游戏教程较少，此教程也用于弥补此状情况，推动国内小游戏服务器发展。为了便于学习者学习，本教程大多数使用较为通俗易懂的语言，尽量避免专业术语对学习者的困扰

字数统计

更新日志
- 2020/8/4 教程首次发布

前言

目前站内，TNTRun插件搬运贴主要是翻译原贴为主来讲解此插件，缺少系统化的讲解，个人认为这样不太适合“新萌”学习，加之搬运贴较为老旧，跟最新版内容差别较大，严重影响服主的使用。对于搬运贴的汉化文件较为老旧，与最新版出入较大，因此本人并未使用搬运贴的汉化，而是亲自汉化了所有最新版语言文件

本教程适合哪些人？
- 想要学习TNTRun插件，却无从下手的服主
- 想要学习更多插件，增长技术的服主

本教程需要的相关工具有哪些？
- 服务端：Spigot/PaperSpigot等支持TNTRun插件运行的服务器
- 编辑工具：Notepad++等编辑工具（电脑自带记事本除外）

TNTrun介绍

TNTrun是一款在国内外比较火热的小游戏插件，此插件主要玩法为：玩家在平台上快速奔跑，所碰到的方块都会坠落，玩家必须通过跑酷避免掉下去，最终留在平面上的玩家就会成为胜利者
搬运贴：https://www.mcbbs.net/thread-782395-1-1.html
原贴：https://www.spigotmc.org/resources/tntrun_reloaded-tntrun-for-1-13-1-16.53359/

插件特色：
- 可设置禁止下蹲
- 支持设置多个竞技场
- 可设置沙子掉落延迟
- 自定义提示消息
- 可创建游戏木牌
- 可限制游戏时间
- 竞技场自动重置
- 支持标题和血条
- 支持淘汰玩家观战
- 支持给予胜利玩家奖励

插件安装

此部分为插件安装教程，将会对TNTRun插件的安装过程做一个详细的说明和教学，如果你是大佬可以跳过此部分，但如果你对于此插件的安装过程不太了解，我推荐学习一下

下载插件

TNTRun插件除了主体外（TNTRun），还需要3个前置插件（worldedit、vault、BarAPI）
其中BarAPI是可选的，如果你不想要在游戏中屏幕上方的血条，则可以去掉此插件，但本人推荐装上
worldedit和Vault插件是必要的，如果不安装的话，TNTRun将无法正常运行

TNTRun下载地址：https://www.spigotmc.org/resources/tntrun_reloaded-tntrun-for-1-13-1-16.53359/
worldedit下载地址：https://dev.bukkit.org/projects/worldedit
vault下载地址：https://www.spigotmc.org/resources/vault.34315/
BarAPI下载地址：https://www.spigotmc.org/resources/api-bossbarapi-1-7-1-8-1-9-1-10.7504/

加载插件

将下载好的插件放到服务器plugins文件夹中
之后重启服务器来加载配置文件

汉化文件

配置文件加载后，关闭服务器，下载教程内汉化过的文件，替换掉配置文件
在游戏中输入后输入/reload重载配置文件或重启服务器即可汉化完成

文件下载

指令与权限
指令

基础指令

/tr list - 列出所有竞技场
/tr list {arena} - 列出指定竞技场设置
/tr join {arena} - 加入指定竞技场(默认)
/tr join - 打开竞技场菜单(默认)
/tr autojoin - 加入玩家人数最多的竞技场
/tr leave - 离开当前竞技场
/tr vote - 开启当前竞技场投票
/tr lobby - 传送至TNTRun大厅
/tr stats - 显示我的TNTRun信息
/tr leaderboard {size} - 显示TNTRun计分板
/tr listkit - 列出TNTRun所有工具包
/tr listkit {kit} - 列出工具包物品内容
/tr start {arena} - 强制开始游戏
/tr info - 查询TNTRun插件信息
/tr help - 列出所有/tr指令
/tr cmds - 列出所有/trsetup指令

创建竞技场

/trsetup create <arena> - 创建竞技场
/trsetup setarena <arena> - 创建竞技场范围
/trsetup setloselevel <arena> - 设置竞技场最低层
/trsetup setspawn <arena> - 设置竞技场出生点
/trsetup setspectate <arena> - 设置竞技场观战点
/trsetup finish <arena> - 保存设置并启用竞技场
/trsetup setlobby - 设置当前位置为TNTRun大厅

配置竞技场

/trsetup setmaxplayers {arena} {number} - 设置竞技场最大玩家人数（默认值：15）/trsetup setminplayers {arena} {number} - 设置竞技场最小玩家人数（默认值：2）
/trsetup settimelimit {arena} {seconds} - 设置竞技场的最大游戏时间（默认值：300秒）
/trsetup setcountdown {arena} {seconds} - 设置竞技场差多少秒开启倒计时（默认值：10）
/trsetup setmoneyreward {arena} {amount} - 设置获胜金币奖励数量（必须有前置Vault）
/trsetup setteleport {arena} {previous/lobby} - 设置游戏结束时将玩家传送的位置
/trsetup setdamage {arena} {yes/no/zero} - 设置竞技场是否开启PVP（yes = 开启，no = 不开启，zero = 无伤害）
/trsetup deletespectate {arena} - 删除玩家的传送点
/trsetup setgameleveldestroydelay {arena} {ticks} - 设置玩家踩到块后方块多久才坠落（默认值：8）
/trsetup setregenerationdelay {arena} {ticks} - 设置玩家重新加入竞技场的时间限制（默认值：60）
/trsetup setvotepercent {arena} {0<votepercent<1} - 设置强制开启游戏所需的投票百分比（默认值：0.75）
/trsetup setfee {arena} {amount} - 设置加入竞技场的花费
/trsetup setcurrency {arena} {currency_item} - 设置金币类型
/trsetup setreward {arena} -设置竞技场奖励物品、经验值、指令奖励（列：/points give %player% 1）/trsetup setP1 - 设置目标方块为第一个选择点
/trsetup setP2 - 设置目标方块为第二个选择点
/trsetup clear - 删除选择点

控制台指令

trconsole help -查询控制台帮助
trconsole info - 查询插件信息
trconsole list - 列出所有竞技场
trconsole enable {arena} - 启用竞技场
trconsole disable {arena} - 禁用竞技场
trconsole start {arena} - 强制开始游戏
trconsole reloadconfig - 重载config.yml
trconsole reloadbars - 重载configbars.yml
trconsole reloadmsg - 重载messages.yml
trconsole leaderboard - 显示排行榜

其他指令

/trsetup setlobby - 设置当前位置为TNTRun大厅
/trsetup deletelobby - 删除TNTRun大厅
/trsetup setbarcolor {color} - 设置血条颜色（默认值：RANDOM）
/trsetup addkit {kit} - 创建道具包
/trsetup deletekit {kit} - 删除道具包
/trsetup reloadbars - 重载configbars.yml
/trsetup reloadmsg - 重载messages.yml
/trsetup reloadtitles - 重载titles.yml
/trsetup reloadconfig - 重载config.yml
/trsetup addspawn {arena} - 添加竞技场出生点
/trsetup deletespawnpoints {arena} - 删除使用addspawn创建的所有出生点
/trsetup enable {arena} - 启用竞技场
/trsetup disable {arena} - 禁用竞技场
/trsetup delete {arena} - 删除竞技场
权限

玩家权限

tntrun.join - 允许加入游戏
tntrun.heads - 允许玩家使用HeadsPlus
tntrun.shop - 允许玩家购买道具
tntrun.joinmenu - 允许玩家使用菜单

管理员权限

tntrun.start - 允许强制开始游戏
tntrun.setup - 允许使用指令/trsetup
tntrun.version.check - 允许查看版本信息

自定义权限

tntrun.doublejumps.n - 设置玩家二段跳的最大次数
变量

此部分为TNTRun变量详解，将会列出目前插件的所有变量，并进行注释

％tntrun_played％ - 参与过的游戏次数
％tntrun_wins％ - 游戏获胜次数
％tntrun_losses％ - 游戏失败次数
％tntrun_version％ - 插件版本
％tntrun_arena_count％ - 竞技场的数量
％tntrun_player_count％ - 当前正在玩TNTRun的玩家总数量
％tntrun_player_count_ <竞技场>％ - 当前正在玩TNTRun的玩家数量
％tntrun_status_ <竞技场>％ - 竞技场的状态
％tntrun_joinfee_ <竞技场>％ - 加入竞技场所需的费用
％tntrun_currency_ <竞技场>％ - 加入竞技场所需的花费类型
％tntrun_doublejumps％ - 玩家允许二段跳的次数
%tntrun_leaderboard_wins_player_<position>% - 当前在获胜排行榜中的玩家
%tntrun_leaderboard_wins_score_<position>% - 获胜排行榜中的获胜次数
%tntrun_leaderboard_losses_player_<position>% - 当前在失败排行榜中的玩家
%tntrun_leaderboard_losses_score_<position>% - 失败排行榜中的获胜次数
%tntrun_leaderboard_played_player_<position>% - 当前在总次数排行榜中的玩家
%tntrun_leaderboard_played_score_<position>% - 总次数排行榜中的游戏次数
config.yml详解

此部分将对config.yml文件的所有内容进行讲解
config.yml主要用于设置全局性问题

special:
UseBossBar: true
介绍：此项用于设置是否使用BoosBar显示信息和倒计时

BossBarColor: RANDOM
介绍：此项用于设置BoosBar的颜色

UseTitle: true
介绍：此项用于设置是否使用标题显示信息

UseScoreboard: true
介绍：此项用于设置是否使用计分板显示统计信息

UseDoubleJumpPermissions: false
介绍：此项用于设置是否使用权限来设置二段跳次数

CheckForNewVersion: true
介绍：此项用于设置是否检测插件版本

Metrics: true
介绍：此项用于设置是否启动aStats

UseRankInChat:
enabled: false
usegroup: true
useprefix: false
介绍：此项用于设置玩家聊天时显示的信息

shop:
name: '&6&lTNTRun &f&l商店'
size: 27
doublejump:
maxdoublejumps: 10
logpurchases: false
onleave:
removepurchase: false
showmoneyitem: GOLD_INGOT
介绍：此项用于设置TNTRun商店

freedoublejumps:
enabled: false
amount: 10
介绍：此项用于设置是否在游戏开始时提供给玩家道具

commandsonwin:
- say {PLAYER} 赢得了比赛!
- say 恭喜!
介绍：此项用于设置当玩家胜利时对玩家执行的指令

fireworksonwin:
enabled: true
duration: 4
介绍：此项用于设置是否开启烟花和烟花时间（秒）

broadcastwinlevel: 2
menu:
item: TNT
panecolor: LIGHT_BLUE
includedisabled: false
介绍：此项用于设置TNTRun游戏加入菜单

sounds:
arenastart:
enabled: true
sound: ENTITY_PLAYER_LEVELUP
volume: 10
pitch: 1.0
itemselect:
enabled: true
sound: UI_BUTTON_CLICK
volume: 1
pitch: 1.0
blockbreak:
enabled: true
sound: BLOCK_SAND_BREAK
volume: 5
pitch: 1.0
介绍：此项用于设置游戏声音

anticamping:
enabled: true
介绍：此项用于设置是否开启当最后5秒时，将所有等待玩家传送到竞技场

leaderboard:
maxentries: 10
介绍：此项用于设置排行榜最大显示排名数

items:
vote:
use: true
material: DIAMOND
name: '&2&l投票'
slot: 0
info:
use: true
material: EMERALD
name: '&2&l信息'
slot: 1
shop:
use: true
material: NETHER_STAR
name: '&2&l商店'
slot: 2
stats:
use: true
material: REDSTONE
name: '&2&l统计'
slot: 3
leave:
material: GREEN_BED
name: '&2&l离开'
slot: 8
heads:
use: true
material: GLOWSTONE_DUST
name: '&e&lHeadsPlus'
slot: 4
介绍：此项用于设置TNTRun菜单

scoreboard:
header: '&6&lTNTRUN'
displaydoublejumps: false
waiting:
- '&f欢迎来到TNTRun'
- '&a '
- '&f竞技场: &6&l{ARENA}'
- '&b '
- '&f玩家: &a&l{PS}&7&l/&c&l{MPS}'
- '&c '
- '&f需要玩家: &6&l{VOTES}'
- '&d '
- '&f等待开始: &6&l{COUNT}'
playing:
- '&fTNTRun'
- '&竞技场: &6&l{ARENA}'
- '&b '
- '&f玩家: &a&l{PS}&7&l/&c&l{MPS}'
- '&c '
- '&f已淘汰玩家: &a&l{LOST}'
- '&d '
- '&f获胜者: &c&l{LIMIT}'
介绍：此项用于设置TNTRun计分板信息

database: file
MySQL:
host: host
port: 12345
name: tntrun
table: stats
user: root
pass: password
useSSL: false
介绍：此项用于设置数据库

signs:
prefix: '&6&lTNTRun'
join: '[Join]'
status:
disabled: '&c取消开启'
ingame: '&c&l{PS}&8/&c&l{MPS}'
regenerating: '&6&l重置地图中'
waiting: '&a&l{PS}&8/&a&l{MPS}'
介绍：此项用于设置木牌文本

bungeecord:
enabled: false
hub: lobby
useMOTD: true
stopserver: false
介绍：此项用于设置Bungeecord跨服

shop.yml详解

此部分将对shop.yml文件的内容进行讲解
shop.yml是可以修改的，服主们可以个性化设置
shop.yml为TNTRun的游戏道具购买菜单

商店格式如下：

代码:

'工具包名':
name: '工具包名'
cost: 花费数额
material: 显示的物品ID
amount: 显示的物品数量
permission: 购买所需权限
lore:
- 工具包Lore介绍
items:
'物品名':
material: '物品ID'
amount: 物品数量
displayname: '物品显示名'
lore:
- 物品Lore介绍
enchantments:
- '附魔'

name: ' ' 设置GUI中此工具包显示的名称，支持颜色代码
cost: 设置购买此工具包花费的金额
material: 设置GUI中此工具包显示的物品类型
amount: 设置GUI中此工具包显示的物品数量
permission: 设置购买此工具包所需的权限
lore: [] 设置GUI中此工具包显示的Lore介绍

items: 设置此工具包中的物品

实例:

代码:

'2':
name: '&f剑客'
cost: 250
material: IRON_SWORD
amount: 1
permission: tntrun.shop.2
lore:
- 剑 + 击退#1
- 只需&6 250 &5金币
items:
'1':
material: IRON_SWORD
amount: 1
displayname: '&c剑 + 击退1'
lore:
- 剑 + 击退#1
enchantments:
- KNOCKBACK#1

configbars.yml详解

configbars.yml文件用于设置BoosBar显示的内容
此文件支持个性化修改

文件内容

代码:

waiting: '&6请耐心等待玩家加入, 当前玩家人数:&r {COUNT}'
starting: '&6游戏将在:&r {SECONDS} 秒后开始'
playing: '&6剩余时间:&r {SECONDS} &6剩余玩家人数:&r {COUNT}'

configtitles.yml详解

configtitles.yml文件用于设置通过标题发送的内容
此文件支持个性化修改

文件内容

代码:

join: '&7[&6TNTRun&7]'
subjoin: '&6{PLAYER} &7加入游戏'
win: '&6你获胜了'
subwin: '&7恭喜'
starting: '&7[&6TNTRun&7]'
substarting: '&7游戏将会在 &6{COUNT} 秒后开始'
start: '&7[&6TNTRun&7]'
substart: '&7游戏已经开始'

创建竞技场

此部分为教程的重点部分，将会一步一步得教学习者如何创建一个竞技场
建议初次创建者，仔细阅读此部分进行操作

第一步创建一个竞技场

1.输入指令/trsetup create <竞技场>来创建一个空竞技场

第二步给竞技场设置范围

1.使用WorldEdit插件，选择两个相对的点，分别在竞技场的上方和下方
提示：请确保选择区域可以包括整个竞技场
2.输入指令/trsetup setarena <竞技场>将竞技场的范围设置为选择区域

第三步设置最低平台

1.使用WorldEdit选择平台的两个相对点，选择的平面将作为竞技场最低点，如果玩家掉出此平台，将会淘汰
提示：这两个点必须位于上一步选择的竞技场范围中
2.输入指令/ trsetup setloselevel <竞技场>将竞技场最低平台设置为选择平面

第四步设置玩家出生点

1.站在竞技场的最高层（可自选）
2.输入指令/trsetup setspawn <竞技场>将把你所站立的位置设置为玩家开始游戏时传送的位置

第五步设置玩家观战点

1.站在竞技场的最高层（可自选）
2.输入指令/trsetup setspectate <竞技场>将把你所站立的位置设置为玩家淘汰时传送观战的位置

第六步保存竞技场并开启

1.输入指令/trsetup finish <竞技场>来保存刚才创建的竞技场，保存后竞技场将会启用

第七步设置一个大厅

1.站在你想设置成大厅的位置
2.输入指令/trsetup setlobby将把你所站立的位置设置为TNTRun的大厅
提示：只允许设置一个大厅

常见问题

此部分将会对使用插件时的问题和一些小技巧进行总结，每个问题都会给出详细的解决方式

如何设置悬浮字排行榜？

1.需要下载HolographicDisplays和HolographicExtension、ProtocolLib才可以使用此功能
2.站立在你想要创建排行榜的位置输入指令/hd create TNTRun_Wins TNTRun Leaderboard创建一个悬浮字排行榜
3.接下来给排行榜添加排名
/hd addline TNTRun_Wins {slowest}&6%tntrun_leaderboard_wins_player_1% &f: &c%tntrun_leaderboard_wins_score_1%
/hd addline TNTRun_Wins {slowest}&6%tntrun_leaderboard_wins_player_2% &f: &c%tntrun_leaderboard_wins_score_2%
/hd addline TNTRun_Wins {slowest}&6%tntrun_leaderboard_wins_player_3% &f: &c%tntrun_leaderboard_wins_score_3%
以此类推

如何设置工具包？

1.将背包清空
2.将想要添加到工具包的物品放到背包中
3.输入指令/trsetup addkit [工具包]将背包中的物品创建为一个工具包
4.输入指令/trsetup enablekits [竞技场]设置竞技场开启工具包
提示：开启游戏后，允许开启工具包的竞技场的玩家将会随机分配工具包

如何创建传送木牌?

1.创建一个木牌按照已下格式进行填写
加入木牌
第一行 [TNTRun]
第二行 [Join]
第三行竞技场名字
第四行不填

离开木牌
第一行 [TNTRun]
第二行 [Leave]
第三行不填
第四行不填

投票木牌
第一行 [TNTRun]
第二行 [Vote]
第三行不填
第四行不填

其他问题将会继续补充

个人心得

首先，个人认为目前国内小游戏服务器较少，大多数服主因为怕玩家太少而不敢开小游戏服务器，个人认为如果你认真做一个小游戏服务器，慢慢积累玩家，服务器还有所成就
其次，个人认为服主们不应该故步自封，普遍的游戏玩法是不足以吸引玩家的，对于那些较为普遍的小游戏，玩家们大多都会选择去网易等一些大服务器，因此应该不断创新改善小游戏的玩法来吸引玩家
最后，配置小游戏服务端时一定要细心，不要漏掉任何一步，否则会出现问题，导致前功尽废
希望你看到这里，已经对TNTRun插件的配置有了进一步的了解，希望你继续努力，共同推动国内服务器的发展！

表示路过

好，非常好的教程！

叁肆.

表示路过发表于 2020-8-6 19:42
好，非常好的教程！

谢谢评价（可否留下评分？）

chuangxinzhe

配置里没有bungeecord啊

北风666

谢谢大佬~~~~~

北风流批

请问二段跳能不能禁止呢？他和飞行冲突就飞不起来了

hzy2403

谢谢楼主的分享awa！！！

jiangyikai1020

6666666666666

jiangyikai1020

6666666666666

2660308895

66666666666