Tournament Manager

插件

· 作者 i_c0de

一个基于 Paper 的服务端插件,提供锦标赛和事件管理系统,配备可配置的管理员 GUI 以及小游戏提供商 API。

0 本站下载 0 关注 更新于 3 周前

最新 v0.5.0 · 26.1.2 · Paper

一键开服(送7天)

在此请求版本更新

TournamentManager

使用任何实现了 MinigameProvider 接口的迷你游戏插件来编排锦标赛。

概述

TournamentManager 是一个 Paper 插件,它在现有的迷你游戏插件(如 Spleef、TeamDeathmatch 或任何自定义插件)之上添加了锦标赛级别的组织功能。它不直接运行游戏,而是通过 Bukkit 的 ServicesManager 在运行时发现 MinigameProvider 的实现,并将比赛委托给它们处理。

不硬依赖任何特定的迷你游戏插件——该插件是完全通用的。任何实现 MinigameProvider 的插件都可以使用。

工作原理

  1. 迷你游戏插件(Spleef、TDM 等)实现 MinigameProvider 接口并通过 ServicesManager 进行注册。
  2. TournamentManager 在启动时 discovers 所有提供者,并在管理 GUI 中显示它们。
  3. 管理员创建锦标赛并选择要使用的已安装迷你游戏。
  4. 当比赛准备就绪时,锦标赛调用 provider.createMatch() 将游戏委托出去。
  5. 游戏结束时,提供者触发一个 MatchCompleteEvent。
  6. TournamentManager 接收该事件,确定获胜者,并推进赛程表。

依赖项

依赖项 类型 描述
Paper API 必需 Minecraft 服务器 API

迷你游戏提供者(Spleef、TeamDeathmatch 等)在运行时被发现——无需编译时依赖。

支持的格式

  • 单败淘汰制 — 经典赛制,输一场即被淘汰。
  • 瑞士轮制 — 进行固定轮数的比赛,总战绩最佳者获胜。

锦标赛生命周期

  1. 管理员创建 锦标赛(通过 GUI 或命令)。
  2. 玩家加入 通过 GUI(单人或预设队伍)。
  3. 管理员开始 锦标赛。
  4. 插件创建 比赛 —— 将实际游戏委托给所选的迷你游戏提供者。
  5. 结果 通过提供者的 MatchCompleteEvent 返回。
  6. 插件推进赛程表 / 更新瑞士轮排名。
  7. 冠军 加冕,统计数据记录。

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);

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源