Cobblemon Ranked - Cobblemon 排位赛

📊 CobblemonRanked 天梯系统文档

常见问题解答

> 此模组只需安装在服务器端。

> 客户端安装后，默认按 X 键可打开图形化 GUI。

> 💡 为了使用 enableTeamPreview 功能，客户端也需要安装此模组。

🎯 功能概览

• 内置多语言支持（中文与英文），易于扩展
• 可配置的对战场地，支持自动传送与返回
• 可自定义的段位称号与 Elo 阈值
• 支持三种模式：单打、双打 和 2v2单打
• 每种模式独立计算的 Elo 排名系统
• 每种模式独立的奖励系统，支持自定义命令
• 内置赛季系统，支持自动轮换与数据重置
• 基于 Elo 的匹配队列，支持基于等待时间的匹配放宽
• 掉线视为战败，扣除 Elo
• 完全 GUI 驱动，支持可点击的文本菜单和图形化 GUI
• 跨服务器匹配支持
• 当 enableTeamPreview 为 True 时，如果宝可梦数量超过设定上限，将触发选择对战宝可梦的界面。如果数量未超过上限，则不会触发界面。

例如，若 singlesPickCountNumber 设为 3：

玩家 1 有 5 只宝可梦，将触发选择界面，需要选择 3 只进行对战。

玩家 2 只有 2 只宝可梦，因此不会触发选择界面。玩家 1 选择完毕后，对战将直接开始。

🌐 跨服务器匹配（不再维护）

> v1.2.0+ 版本可用 — 支持从任意服务器或单人世界连接（需要正版 Minecraft 账号）

> 跨服务器匹配演示与配置：Youtube

> 您可以在此下载服务器以搭建自己的服务器。下载

✅ 使用方法

• 在配置中启用 enableCrossServer
• 修改 cloudServerId，不应与其他服务器重复（默认的 server 可能已被他人使用）
• 输入 /rank reload 重载配置或重启服务器。
• 输入 /rank cross start 连接到云端服务器

⚠️ 当前限制

• 仅支持单打模式
• 某些道具和技能效果可能无法生效
• 来自同一服务器的玩家不会被匹配到一起

🌐 跨服务器命令

📌 命令总览

> 所有命令均以 /rank 开头

🎮 玩家命令

🛡️ 管理员命令（需要 OP 权限）

以下是修订后的 Wiki 内容（英文）：

占位符 API

基础占位符（使用默认模式）

赛季相关占位符

段位进度占位符

队列状态占位符

模式支持（指定对战模式）

支持三种对战模式：singles、doubles、2v2singles

用法：在占位符后添加 _模式

注意： 赛季相关占位符（seasonname、seasonid、seasondaysleft、seasontimeleft）和 queue_status 不支持模式参数，因为它们并非模式特定。

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

点击展开完整配置参考（含行内注释）

{
  "defaultLang": "en",                     // 默认语言：'en' 或 'zh'
  "defaultFormat": "singles",              // 默认对战模式
  "minTeamSize": 1,                        // 每队最少宝可梦数量
  "maxTeamSize": 6,                        // 每队最多宝可梦数量
  "allowDuplicateItems": false,            // 允许队伍中存在重复的携带道具
  "enableTeamPreview": true,               // 启用队伍预览与选择（带6选3/4）
  "teamSelectionTime": 90,                 // 队伍选择允许时间（秒）
  "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）。败方最多损失（胜方获得 * 败方保护率）。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,     // 战斗后恢复宝可梦 HP
  "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 或域名均可）
}

点击展开 database.json

{
	// 数据库类型：'sqlite' 或 'mysql'
	"databaseType": "sqlite",
	// SQLite 数据库文件路径（相对于配置文件夹）
	"sqliteFile": "ranked.db",
	// MySQL 配置
	"mysql": {