在此请求版本更新
TournamentManager
使用任何实现了 MinigameProvider 接口的迷你游戏插件来编排锦标赛。
概述
TournamentManager 是一个 Paper 插件,它在现有的迷你游戏插件(如 Spleef、TeamDeathmatch 或任何自定义插件)之上添加了锦标赛级别的组织功能。它不直接运行游戏,而是通过 Bukkit 的 ServicesManager 在运行时发现 MinigameProvider 的实现,并将比赛委托给它们处理。
不硬依赖任何特定的迷你游戏插件——该插件是完全通用的。任何实现 MinigameProvider 的插件都可以使用。
工作原理
- 迷你游戏插件(Spleef、TDM 等)实现
MinigameProvider 接口并通过 ServicesManager 进行注册。
- TournamentManager 在启动时 discovers 所有提供者,并在管理 GUI 中显示它们。
- 管理员创建锦标赛并选择要使用的已安装迷你游戏。
- 当比赛准备就绪时,锦标赛调用
provider.createMatch() 将游戏委托出去。
- 游戏结束时,提供者触发一个
MatchCompleteEvent。
- TournamentManager 接收该事件,确定获胜者,并推进赛程表。
依赖项
| 依赖项 |
类型 |
描述 |
| Paper API |
必需 |
Minecraft 服务器 API |
迷你游戏提供者(Spleef、TeamDeathmatch 等)在运行时被发现——无需编译时依赖。
支持的格式
- 单败淘汰制 — 经典赛制,输一场即被淘汰。
- 瑞士轮制 — 进行固定轮数的比赛,总战绩最佳者获胜。
锦标赛生命周期
- 管理员创建 锦标赛(通过 GUI 或命令)。
- 玩家加入 通过 GUI(单人或预设队伍)。
- 管理员开始 锦标赛。
- 插件创建 比赛 —— 将实际游戏委托给所选的迷你游戏提供者。
- 结果 通过提供者的
MatchCompleteEvent 返回。
- 插件推进赛程表 / 更新瑞士轮排名。
- 冠军 加冕,统计数据记录。
GUI 界面
管理员
- 主菜单 — 创建锦标赛、管理锦标赛、已安装的迷你游戏
- 创建锦标赛 — 配置名称、格式、迷你游戏提供者、队伍大小、最大队伍数
- 管理锦标赛 — 开始、取消、强制结束、查看赛程表/排名、查看队伍
- 赛程表视图 — 按轮次显示的可视化树状图
- 瑞士轮排名 — 带有胜负记录的排名表格
- 已安装的迷你游戏 — 显示所有可用的提供者和它们的竞技场
玩家
- 开放锦标赛 — 可加入锦标赛的分页列表
- 锦标赛详情 — 信息、加入/离开、查看赛程表/排名
- 我的比赛 — 当前/即将到来的比赛
- 比赛历史 — 过往比赛及胜负指示器
命令
| 命令 |
描述 |
/tournament |
打开玩家 GUI(别名:/tourney, /t) |
/tournament admin |
打开管理员 GUI |
/tournament create |
打开创建锦标赛 GUI |
/tournament join <id> |
通过 ID 加入锦标赛 |
/tournament leave <id> |
离开锦标赛 |
/tournament start <id> |
开始锦标赛(管理员) |
/tournament cancel <id> |
取消锦标赛(管理员) |
权限
| 权限 |
默认值 |
描述 |
tournament.admin |
op |
管理员命令和管理 GUI |
tournament.player |
true |
加入和查看锦标赛 |
创建 MinigameProvider
任何插件都可以通过实现 MinigameProvider 接口与 TournamentManager 集成:
public class MyGameProvider implements MinigameProvider {
@Override public String getPluginName() { return "MyGame"; }
@Override public String getDisplayName() { return "MyGame"; }
@Override public Material getIcon() { return Material.DIAMOND_SWORD; }
@Override public boolean isEnabled() { return plugin.isEnabled(); }
@Override public List<String> getAvailableArenas() { return List.of("arena1"); }
@Override
public boolean createMatch(String arena, List<UUID> team1,
List<UUID> team2, String matchId) {
// 在此处启动你的游戏
return true;
}
@Override public void cancelMatch(String matchId) { /* 清理 */ }
}
在你的插件的 onEnable() 中注册它:
getServer().getServicesManager().register(
MinigameProvider.class, myProvider, this, ServicePriority.Normal
);
当游戏结束时,触发一个 MatchCompleteEvent:
MatchCompleteEvent event = new MatchCompleteEvent(
getPluginName(), matchId, winningPlayerUuids, arena, false);
Bukkit.getPluginManager().callEvent(event);
Request version updates here!
TournamentManager
Orchestrates tournaments using any minigame plugin that implements the MinigameProvider interface.
Overview
TournamentManager is a Paper plugin that adds tournament-level organization on top of existing minigame plugins (Spleef, TeamDeathmatch, or any custom plugin). Instead of running games directly, it discovers MinigameProvider implementations at runtime via Bukkit's ServicesManager and delegates matches to them.
No hard dependency on any specific minigame — the plugin is fully generic. Any plugin that implements MinigameProvider can be used.
How It Works
- Minigame plugins (Spleef, TDM, etc.) implement the
MinigameProvider interface and register it via ServicesManager.
- TournamentManager discovers all providers on startup and displays them in the admin GUI.
- Admin creates a tournament and selects which installed minigame to use.
- When matches are ready, the tournament calls
provider.createMatch() to delegate the game.
- When the game ends, the provider fires a
MatchCompleteEvent.
- TournamentManager receives the event, determines the winner, and advances the bracket.
Dependencies
| Dependency |
Type |
Description |
| Paper API |
Hard |
Minecraft server API |
Minigame providers (Spleef, TeamDeathmatch, etc.) are discovered at runtime — no compile-time dependency.
Supported Formats
- Single Elimination — classic bracket, lose and you're out.
- Swiss System — play a set number of rounds, best overall record wins.
Tournament Lifecycle
- Admin creates a tournament (via GUI or command).
- Players join via GUI (solo or pre-made teams).
- Admin starts the tournament.
- Plugin creates matches — delegates actual games to the chosen minigame provider.
- Results come back via
MatchCompleteEvent from the provider.
- Plugin advances bracket / updates Swiss standings.
- Champion crowned, stats recorded.
GUIs
Admin
- Main Menu — Create Tournament, Manage Tournaments, Installed Minigames
- Create Tournament — Configure name, format, minigame provider, team size, max teams
- Manage Tournaments — Start, Cancel, Force End, View Bracket/Standings, View Teams
- Bracket View — Visual bracket tree by round
- Swiss Standings — Ranked table with win/loss records
- Installed Minigames — Shows all available providers and their arenas
Player
- Open Tournaments — Paginated list of joinable tournaments
- Tournament Details — Info, Join/Leave, View Bracket/Standings
- My Matches — Current/upcoming matches
- Match History — Past matches with W/L indicators
Commands
| Command |
Description |
/tournament |
Open player GUI (aliases: /tourney, /t) |
/tournament admin |
Open admin GUI |
/tournament create |
Open create tournament GUI |
/tournament join <id> |
Join a tournament by ID |
/tournament leave <id> |
Leave a tournament |
/tournament start <id> |
Start a tournament (admin) |
/tournament cancel <id> |
Cancel a tournament (admin) |
Permissions
| Permission |
Default |
Description |
tournament.admin |
op |
Admin commands and management GUIs |
tournament.player |
true |
Join and view tournaments |
Creating a MinigameProvider
Any plugin can integrate with TournamentManager by implementing the MinigameProvider interface:
public class MyGameProvider implements MinigameProvider {
@Override public String getPluginName() { return "MyGame"; }
@Override public String getDisplayName() { return "MyGame"; }
@Override public Material getIcon() { return Material.DIAMOND_SWORD; }
@Override public boolean isEnabled() { return plugin.isEnabled(); }
@Override public List<String> getAvailableArenas() { return List.of("arena1"); }
@Override
public boolean createMatch(String arena, List<UUID> team1,
List<UUID> team2, String matchId) {
// Start your game here
return true;
}
@Override public void cancelMatch(String matchId) { /* cleanup */ }
}
Register it in your plugin's onEnable():
getServer().getServicesManager().register(
MinigameProvider.class, myProvider, this, ServicePriority.Normal
);
When the game ends, fire a MatchCompleteEvent:
MatchCompleteEvent event = new MatchCompleteEvent(
getPluginName(), matchId, winningPlayerUuids, arena, false);
Bukkit.getPluginManager().callEvent(event);
评论 0
登录后参与评分
还没有评论,来抢沙发吧