GTDungeonTeam 快速开始
GTDungeonTeam 是副本组队和普通组队插件。服务器有 DungeonPlus、QueDP、BTDungeons、MythicDungeons 时,可以把队伍流程接到副本启动、结算、体力和消耗上;服务器暂时没有副本插件时,也能只用队伍、公开房间、邀请、申请、掉落分配、经验共享和竞拍。
作者:RusBrook
先理解它管什么
| 模块 | 用途 |
|---|---|
| 队伍 | 创建队伍、邀请玩家、公开房间、申请入队、队长管理 |
| 副本 | 统一读取副本文件,再交给对应副本插件或命令适配器启动 |
| 体力 | 每名玩家有体力,上限、初始值、恢复量都能写变量和公式 |
| 入队条件 | 服主配置条件模板,队长在游戏里设置具体要求 |
| 进入条件 | 副本文件里写等级、职业、战力、权限等开本条件 |
| 成本 | 开本时扣体力、金币、物品,可按队长或全队在线成员扣除 |
| 掉落分配 | 队伍内随机、轮询、队长、拾取者分配掉落物 |
| 掉落竞拍 | 稀有物品进入竞拍,结束后扣款、给物品、队伍分红、系统抽成 |
| 经验共享 | 玩家获得经验时,按队伍人数给队友额外共享经验 |
| 客户端界面 | 原版 GUI、PaiUI、AX、DragonCore、KongCore、Dialog 路由 |
| 跨服 | Velocity、BungeeCord、Waterfall 网络中传送队伍并在目标服开本 |
安装步骤
- 安装
GTCore。 - 把
GTDungeonTeam.jar放进 Bukkit、Spigot、Paper 或 Purpur 服务端的plugins文件夹。 - 如果要用 PlaceholderAPI 变量,安装
PlaceholderAPI。 - 如果要接副本插件,安装对应副本插件。
- 如果要跨服,代理端也放对应的 GTDungeonTeam 代理插件。
- 启动服务器一次,让插件生成配置。
- 修改
plugins/GTDungeonTeam/config.yml。 - 在
plugins/GTDungeonTeam/dungeons/里给每个副本单独写一个 yml。 - 输入
/gdt reload重载。 - 玩家输入
/gdt打开主界面。
/gtdungeonteam、/gdteam、/gdt 是同一个命令。
生成后的目录
text
plugins/GTDungeonTeam/
config.yml
dungeons/
example.yml
gui/
main.yml
team.yml
invite.yml
applications.yml
requirements.yml
auction.yml
dungeons.yml
dungeon-detail.yml
rooms.yml
room-detail.yml
result.yml
assets/
base.yml
itemsadder.yml
craftengine.yml
oraxen.yml
vanilla.yml
hud/
betterhud.yml
client-ui/
providers.yml
paiui/webgui/gtdungeonteam/
ax/
dragoncore/
kongcore/
dialog/views.yml| 位置 | 用途 |
|---|---|
config.yml | 队伍、体力、掉落、竞拍、经验、存储、跨服、界面总开关 |
dungeons/ | 副本配置。固定文件夹模式,每个副本一个文件 |
gui/ | 原版背包 GUI,自定义方式接近 TrMenu |
assets/ | 图标资源映射,给 IA、CE、Oraxen、原版 CustomModelData 做分层 |
hud/ | BetterHud 同步配置 |
client-ui/ | PaiUI、AX、DragonCore、KongCore、Dialog 的客户端界面文件 |
最小可用配置
刚装好时可以先不接副本插件,只测试队伍。
yaml
team:
default-max-players: 4
default-public: true
default-allow-apply: true
loot:
enabled: true
mode: random
require-team-toggle: true
require-active-run: false
storage:
mode: local
ui:
default: vanilla重载:
text
/gdt reload测试:
text
/gdt
/gdt team create
/gdt team invite 玩家名
/gdt rooms list如果服务器没有副本插件,这一步仍然能正常使用。玩家可以组队、公开房间、申请、邀请,也能开队伍掉落分配。
第一个副本文件
创建:
text
plugins/GTDungeonTeam/dungeons/forest.yml写入:
yaml
dungeon:
id: forest
name: "&a森林遗迹"
provider: command
engine-id: forest
target-server: ""
min-players: 1
max-players: 4
icon: ENDER_EYE
description:
- "&7第一章测试副本。"
requirements:
scope: leader
list:
- "{calc:%player_level%+0} >= 10"
cost:
scope: leader
stamina: 10
money: 100
items: []
start-actions:
- "[console] say <leader> 开始了 <dungeon_name>"
reward-actions:
- "[message] &a你完成了 <dungeon_name>。"重载后测试:
text
/gdt reload
/gdt team create
/gdt dungeon open forest
/gdt dungeon startprovider: command 适合先打通流程。接 BTDungeons、MythicDungeons 等副本插件时,再把 provider 和 engine-id 改成真实副本。
推荐测试顺序
- 先用
storage.mode: local单服测试队伍。 - 确认
/gdt、创建队伍、邀请、公开房间能用。 - 写一个
provider: command的测试副本。 - 确认体力、金币、物品消耗按预期扣除。
- 再改成真实副本适配器。
- 单服流程通了,再接 MySQL、Redis 和跨服代理。
- 最后再换 PaiUI、AX、DragonCore、KongCore 或 Dialog。
不要一上来就把跨服、客户端 UI、副本插件、竞拍、多货币全部打开。组队流程是底座,底座先稳,后面好排错。
常用命令
text
/gdt
/gdt help
/gdt help team
/gdt help dungeon
/gdt help rooms
/gdt reload
/gdt status
/gdt providers/gdt status 只有管理权限能用,会显示存储、代理、队伍、副本适配器、界面、HUD、掉落分配和经验共享状态。
常见第一步问题
| 现象 | 处理 |
|---|---|
/gdt 没有命令 | 看插件是否正常启用,先查控制台启动报错 |
| 能打开界面但没有副本 | 检查 plugins/GTDungeonTeam/dungeons/ 里是否有 yml,执行 /gdt providers |
| 玩家点开始提示没有队伍 | 先 /gdt team create,队员要先接受邀请或申请加入 |
| 队长点开始提示未选择副本 | 先 /gdt dungeon open 副本ID 或在副本界面选择 |
| 体力显示不对 | 看 stamina.max、stamina.initial、PAPI 是否能解析 |
| 公开房间看不到队伍 | 队伍必须公开,且 team.public-room.enabled 为 true |
| 跨服不动 | 先单服测通,再检查 proxy.enabled、proxy.type、server-id、代理端插件 |
