Cobblemon Ranked

模组

· 作者 Kurt5

为 Cobblemon 添加了排名系统和跨服务器匹配支持

0 本站下载 0 关注 更新于 7 个月前

最新 v1.4.2 · 1.21.1 · NeoForge

一键开服(送7天)

? CobblemonRanked 排位系统文档

常见问题解答


本模组仅需安装在服务端。
客户端安装后,默认按 X 键即可打开图形化界面 (GUI)。
? 若要使用 enableTeamPreview(队伍预览)功能,此模组也需在客户端安装。

? 功能概览

  • 内置多语言支持(中文 & 英文),易于扩展
  • 可配置的竞技场,支持自动传送与返回
  • 可自定义的段位头衔与 Elo 阈值
  • 支持三种模式:单打 (Singles)、双打 (Doubles) 和 2v2单打 (2v2singles)
  • 每种格式独立计算 Elo 排名系统
  • 每种格式拥有独立的奖励系统,支持自定义命令
  • 内置赛季系统,支持自动轮换与数据重置
  • 基于 Elo 的匹配队列,可选基于等待时间的宽松匹配机制
  • 断开连接视为失败,扣除 Elo
  • 完全由 GUI 驱动,包含可点击的文本菜单和图形化界面
  • 支持跨服务器匹配
  • 当 enableTeamPreview 设置为 True 时,如果宝可梦数量超过设定限制,将触发宝可梦选择界面;若未超过限制,则不会触发该界面。
    例如,若 singlesPickCountNumber 设置为 3:
    玩家 1 有 5 只宝可梦,这将触发选择界面,需要其选择 3 只进行战斗。
    玩家 2 只有 2 只宝可梦,因此不会触发选择界面。在玩家 1 完成选择后,战斗将直接开始。

? 跨服务器匹配(已不再维护)

从 v1.2.0+ 版本起 — 支持从 任何服务器或单人世界 连接(需要 官方 Minecraft 账号)
跨服务器匹配演示与配置:Youtube
您可以在此下载服务端以搭建自己的服务器。下载

✅ 使用方法

  1. 在配置文件中启用 enableCrossServer
  2. 修改 cloudServerId,确保不与其他服务器重复(默认的 server 可能已被他人占用)
  3. 输入 /rank reload 重新加载配置或重启服务器。
  4. 输入 /rank cross start 连接到云服务器

⚠️ 当前限制

  • 仅支持 单打 (singles) 模式
  • 某些物品和技能效果可能无法生效
  • 来自同一服务器的玩家 不会互相匹配

? 跨服务器命令

命令 描述 权限
/rank cross start 连接到云服务器 OP
/rank cross stop 断开与云服务器的连接 OP
/rank cross chat 与对手聊天 所有玩家
/rank cross join singles 进入单打匹配队列 所有玩家
/rank cross leave 离开匹配队列 所有玩家
/rank cross battle move [1-4] 战斗中使用道具招式 所有玩家
/rank cross battle switch [1-6] 切换宝可梦 所有玩家
/rank cross battle forfeit 放弃战斗 所有玩家

? 命令概览

所有命令均以 /rank 开头


? 玩家命令

命令 描述
/rank gui 打开主菜单 GUI
/rank gui_top 打开排行榜格式选择 GUI
/rank gui_info 查看您的详细 Elo 统计数据
/rank gui_info_players 分页显示在线玩家列表,可查看其排名
/rank gui_myinfo 快速访问您的个人排名
/rank gui_queue 打开匹配菜单
/rank gui_info_format <player> <format> GUI 查看另一位玩家的赛季统计
/rank queue join [format] 加入排位队列
/rank queue leave 离开所有匹配队列
/rank status 显示您当前的队列状态
/rank info <format> <season> 显示指定格式和赛季的统计数据
/rank info <player> <format> [season] 查看另一位玩家在特定格式和赛季的排名
/rank top 查看默认格式和当前赛季的排行榜
/rank top <format> [season] [page] [count] 查看指定格式和赛季的分页排行榜
/rank season 查看当前赛季信息(开始/结束时间、参与情况等)
/rank pokemon_usage <season> <page> 查看宝可梦的使用统计

?️ 管理员命令 (需要 OP 权限)

命令 描述
/rank gui_reward 打开奖励格式选择 GUI
/rank gui_reset 分页显示在线玩家列表,用于重置排名
/rank reset <player> <format> 重置某位玩家在当前赛季和格式的数据
/rank reward <player> <format> <rank> 为特定排名的玩家发放奖励
/rank season end 强制结束当前赛季
/rank reload 重新加载配置文件(语言、段位设置等)
/rank setseasonname <seasonId> <name> 设置赛季名称

以下是修订后的 Wiki 英文内容:


占位符 API

基本占位符 (使用默认格式)

占位符 描述
%cobblemon_ranked:elo% Elo 分数
%cobblemon_ranked:rank_title% 段位头衔
%cobblemon_ranked:win_rate% 胜率
%cobblemon_ranked:wins% 胜场数
%cobblemon_ranked:losses% 负场数
%cobblemon_ranked:total_games% 总比赛场次
%cobblemon_ranked:streak% 当前连胜次数
%cobblemon_ranked:best_streak% 最佳连胜记录
%cobblemon_ranked:flee_count% 逃跑/退出次数
%cobblemon_ranked:rank% 当前排名 (例如 #1)

赛季相关占位符

占位符 描述
%cobblemon_ranked:season_name% 赛季名称
%cobblemon_ranked:season_id% 赛季 ID
%cobblemon_ranked:season_days_left% 赛季剩余天数
%cobblemon_ranked:season_time_left% 格式化后的剩余时间

排名进度占位符

占位符 描述
%cobblemon_ranked:next_rank_elo% 下一等级所需的 ELO
%cobblemon_ranked:next_rank_name% 下一等级名称

队列状态占位符

占位符 描述
%cobblemon_ranked:queue_status% 当前队列状态

格式支持(指定对战格式)

支持三种对战格式:singles、doubles、2v2singles

用法:在占位符后添加 _format

占位符 描述
%cobblemon_ranked:elo_singles% 单人对战 ELO 分数
%cobblemon_ranked:elo_doubles% 双人对战 ELO 分数
%cobblemon_ranked:elo_2v2singles% 2v2 单打 ELO 分数
%cobblemon_ranked:rank_title_singles% 单人对战等级称号
%cobblemon_ranked:rank_title_doubles% 双人对战等级称号
%cobblemon_ranked:win_rate_singles% 单人对战胜率
%cobblemon_ranked:win_rate_doubles% 双人对战胜率
%cobblemon_ranked:wins_singles% 单人对战胜场数
%cobblemon_ranked:wins_doubles% 双人对战胜场数
%cobblemon_ranked:rank_singles% 单人对战排名
%cobblemon_ranked:rank_doubles% 双人对战排名
%cobblemon_ranked:next_rank_elo_singles% 单人对战下一等级所需 ELO
%cobblemon_ranked:next_rank_name_singles% 单人对战下一等级名称

注意: 与赛季相关的占位符(season_name、season_id、season_days_left、season_time_left)以及 queue_status 不支持格式参数,因为它们并非特定于某种格式。


⚙️ 配置文件参考 (cobblemon_ranked.json)

点击展开完整配置参考(含行内注释)
{
  "defaultLang": "en",                     // 默认语言:'en' 或 'zh'
  "defaultFormat": "singles",              // 默认对战格式
  "minTeamSize": 1,                        // 队伍最少宝可梦数量
  "maxTeamSize": 6,                        // 队伍最多宝可梦数量
  "allowDuplicateItems": false,            // 允许队伍中存在重复的携带道具
  "enableTeamPreview": true,               // 启用队伍预览与选择(携带6只,挑选3/4只上场) 
  "teamSelectionTime": 90,                 // 队伍选择允许的时间(秒)
  "turnActionTimeoutSeconds": 90,          // 每回合选择动作允许的时间(秒)(0 = 禁用)
  "singlesPickCount": 3,                   // 单打模式需选择的宝可梦数量(通常为3) 
  "doublesPickCount": 4,                   // 双打模式需选择的宝可梦数量(通常为4) 
  "maxEloDiff": 200,                       // 匹配时的最大 Elo 差距
  "maxQueueTime": 300,                     // 放宽 Elo 规则前的最大等待时间(秒)
  "maxEloMultiplier": 3.0,                 // Elo 差距放宽的最大倍数
  "seasonDuration": 30,                    // 赛季持续时间(天)
  "initialElo": 1000,                      // 赛季开始时的初始 Elo 值
  "eloKFactor": 32,                        // Elo K 系数(影响 Elo 变化幅度)
  "minElo": 0,                             // 最低 Elo 下限
  "loserProtectionRate": 1.0,              // 败者保护率(0.0 到 1.0)。败者最多损失 (胜者获得分数 * loserProtectionRate)。1.0 = 无保护
  "bannedPokemon": ["Mewtwo", "Arceus"],   // 禁用的宝可梦(例如传说宝可梦)
  "restrictedPokemon": ["Mew", "Celebi"],  // 受限宝可梦列表
  "maxRestrictedCount": 2,                 // 队伍中允许的受限宝可梦最大数量
  "bannedHeldItems": ["cobblemon:leftovers"], // 禁用的宝可梦携带道具
  "bannedCarriedItems": ["cobblemon:leftovers"], // 禁用的玩家背包内物品
  "bannedMoves": ["leechseed"],            // 禁用的招式
  "bannedNatures": ["cobblemon:naughty"],  // 禁用的性格
  "bannedAbilities": [],                   // 禁用的特性
  "bannedGenders": ["MALE"],               // 禁用的性别
  "bannedShiny": false,                    // 禁止闪光宝可梦参与对战
  "allowedFormats": ["singles", "doubles", "2v2singles"], // 支持的对战格式
  "maxLevel": 0,                           // 宝可梦最高等级(0 = 无限制)
  "allowDuplicateSpecies": false,          // 是否允许出现同种宝可梦
  "enableCustomLevel": false,              // 启用强制修改宝可梦等级
  "customBattleLevel": 50,                 // 强制设定的对战等级
  "preventBlockBreaking": true,            // 防止玩家在排位赛中破坏方块
  "restorePokemonHpAfterBattle": true,     // 战斗结束后恢复宝可梦生命值
  "battleArenas": [                        // 竞技场列表(对战传送点)
    {
      "world": "minecraft:overworld",
      "playerPositions": [
        { "x": 0.0, "y": 70.0, "z": 0.0 },
        { "x": 10.0, "y": 70.0, "z": 0.0 }
      ]
    },
    {
      "world": "minecraft:overworld",
      "playerPositions": [
        { "x": 100.0, "y": 65.0, "z": 100.0 },
        { "x": 110.0, "y": 65.0, "z": 100.0 }
      ]
    }
  ],
  "victoryRewards": [                      // 胜利奖励配置(每次获胜后执行)
    "give {player} minecraft:experience_bottle 5",
    "give {player} minecraft:emerald 1"
  ],
  "rankRewards": {                         // 按格式划分的段位奖励(基于命令)
    "singles": {
      "Bronze": ["give {player} minecraft:apple 5"],
      "Silver": ["give {player} minecraft:golden_apple 3"],
      "Gold": ["give {player} minecraft:diamond 2", "give {player} minecraft:emerald 5"],
      "Platinum": ["give {player} minecraft:diamond_block 1", "effect give {player} minecraft:strength 3600 1"],
      "Diamond": ["give {player} minecraft:netherite_ingot 1", "give {player} minecraft:elytra 1"],
      "Master": ["give {player} minecraft:netherite_block 2", "give {player} minecraft:totem_of_undying 1", "effect give {player} minecraft:resistance 7200 2"]
    },
    "doubles": {
      "Bronze": ["give {player} minecraft:bread 5"],
      "Silver": ["give {player} minecraft:gold_nugget 10"],
      "Gold": ["give {player} minecraft:emerald 1"],
      "Platinum": ["give {player} minecraft:golden_apple 1"],
      "Diamond": ["give {player} minecraft:totem_of_undying 1"],
      "Master": ["give {player} minecraft:netherite_ingot 2"]
    },
    "2v2singles": {
      "Bronze": ["give {player} minecraft:bread 5"],
      "Silver": ["give {player} minecraft:gold_nugget 10"],
      "Gold": ["give {player} minecraft:emerald 1"],
      "Platinum": ["give {player} minecraft:golden_apple 1"],
      "Diamond": ["give {player} minecraft:totem_of_undying 1"],
      "Master": ["give {player} minecraft:netherite_ingot 2"]
    }
  },
  "rankTitles": {                          // Elo 阈值 → 段位名称
    "3500": "Master",
    "3000": "Diamond",
    "2500": "Platinum",
    "2000": "Gold",
    "1500": "Silver",
    "0": "Bronze"
  },
  "rankRequirements": {              // 每个段位奖励所需的最低胜率(0.0 ~ 1.0)
    "Bronze": 0.0,
    "Silver": 0.3,
    "Gold": 0.3,
    "Platinum": 0.3,
    "Diamond": 0.3,
    "Master": 0.3
  },
  "enableCrossServer": true,       // 启用跨服务器匹配
  "cloudServerId": "server",       // 本服务器的云端服务器 ID(不可与其他服务器重复)
  "cloudToken": "",                // 云端服务器认证令牌(留空表示使用公共云服务器)
  "cloudApiUrl": "http://139.196.103.55:8000",  // 云端 API 地址(IP 或域名均可)
}

"cloudWebSocketUrl": "ws://139.196.103.55:8000/ws/" // 云端 WebSocket 地址(支持 IP 或域名) }

</details>

<details>
<summary>点击展开 `database.json`</summary>

```json
{
	// 数据库类型:'sqlite' 或 'mysql'
	"databaseType": "sqlite",
	// SQLite 数据库文件路径(相对于 config 文件夹)
	"sqliteFile": "ranked.db",
	// MySQL 配置
	"mysql": {
		// MySQL 主机地址
		"host": "localhost",
		// MySQL 端口
		"port": 3306,
		// MySQL 数据库名称
		"database": "cobblemon_ranked",
		// MySQL 用户名
		"username": "root",
		// MySQL 密码
		"password": "",
		// MySQL 连接池大小
		"poolSize": 10,
		// MySQL 连接超时时间(毫秒)
		"connectionTimeout": 5000,
		// 附加 MySQL 连接参数
		"parameters": "useSSL=false&serverTimezone=UTC&characterEncoding=utf8"
	}
}

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源