CobblemonRanked Battling System Documentation

Comprehensive guide to the competitive ranking system that enhances Cobblemon gameplay.

Starting from version 1.0.3, pressing the X key opens the interface by default.

IMPORTANT: The customBattleLevel configuration undergoes thorough testing exclusively within Cobblemon environments. For other use cases, independent verification is required.

Core Features

This mod significantly expands Cobblemon battling capabilities:

• Internationalization - built-in Chinese and English support with easy language extension
• Custom Arenas - automatic teleportation and return after battles
• Flexible Ranking - fully customizable titles and Elo thresholds
• Three Battle Formats - support for singles, doubles, and 2v2singles
• Independent Rankings - Elo system calculated separately per format
• Motivating Rewards - independent reward system with customizable commands
• Seasonal Cycles - automatic rotation and data reset at season end
• Smart Matchmaking - Elo-based opponent search with waiting time consideration
• Reliable System - disconnects count as losses with Elo deduction
• User-Friendly Interface - fully graphical system with interactive buttons
• Cross-Platform Search - opponent matching between different servers

Cross-Server Matchmaking

Version 1.2.0+ introduces the exciting feature of finding opponents from other servers and single-player worlds (requires official Minecraft account).

If you encounter incorrect matches or suspected cheating, please report through Discord. Cloud server support is guaranteed until at least January 1, 2026.

Workflow Demonstration: Complete setup guide available in YouTube video

Basic Setup

1. Enable the enableCrossServer option in configuration
2. Modify cloudServerId - use unique name for each server (default server might be taken)
3. Execute /rank reload or restart server
4. Begin matchmaking with /rank cross start

Known Limitations

• Only singles battle format is supported
• Some items and ability effects might not work
• Players from the same server cannot be matched together

Cross-Server Commands

For managing the cross-server system, the following commands are available:

Command Management

IMPORTANT: All commands start with prefix /rank

Player Commands

These commands help you manage participation in ranked battles:

• /rank gui - main interface menu
• /rank gui_top - leaderboard format selection
• /rank gui_info - detailed Elo statistics
• /rank gui_info_players - online players list for checking rankings
• /rank gui_myinfo - quick access to personal ranking
• /rank gui_queue - matchmaking management
• /rank gui_info_format <player> <format> - seasonal stats of another player
• /rank queue join [format] - join ranked queue
• /rank queue leave - leave all queues
• /rank status - current queue status
• /rank info <format> <season> - personal stats by format and season
• /rank info <player> <format> [season] - another player's ranking
• /rank top - overall ranking table
• /rank top <format> [season] [page] [count] - paginated leaderboard members
• /rank season - current season information
• /rank pokemon_usage <season> <page> - Pokémon usage statistics

Administrative Commands

Available for players with operator permissions:

• /rank gui_reward - reward format selection
• /rank gui_reset - online players list for rank reset
• /rank reset <player> <format> - reset player's data
• /rank reward <player> <format> <rank> - grant reward by rank
• /rank season end - force-end current season
• /rank reload - configuration reload
• /rank setseasonname <seasonId> <name> - set season name

Configuration File

Main system parameters are configured through cobblemon_ranked.json:

{
  "defaultLang": "en",                     // Default language: 'en' or 'zh'
  "defaultFormat": "singles",              // Default battle format
  "minTeamSize": 1,                        // Minimum Pokémon per team
  "maxTeamSize": 6,                        // Maximum Pokémon per team
  "maxEloDiff": 200,                       // Maximum Elo difference for matchmaking
  "maxQueueTime": 300,                     // Maximum wait time (seconds) before relaxing rules
  "maxEloMultiplier": 3.0,                 // Maximum Elo difference relaxation multiplier
  "seasonDuration": 30,                    // Season duration (days)
  "initialElo": 1000,                      // Elo at season start
  "eloKFactor": 32,                        // K-factor for Elo calculations
  "minElo": 0,                             // Minimum Elo floor
  "bannedPokemon": ["Mewtwo", "Arceus"],   // Banned Pokémon (legendaries)
  "bannedHeldItems": ["cobblemon:leftovers"], // Banned held items
  "bannedCarriedItems": ["cobblemon:leftovers"], // Banned inventory items
  "bannedMoves": ["leechseed"],            // Banned moves
  "bannedNatures": ["cobblemon:naughty"], // Banned natures
  "bannedAbilities": [],                   // Banned abilities
  "bannedGenders": ["MALE"],               // Banned Pokémon genders
  "bannedShiny": false,                    // Ban shiny Pokémon from battles
  "allowedFormats": ["singles", "doubles", "2v2singles"], // Supported battle formats
  "maxLevel": 0,                           // Max level (0 = no limit)
  "allowDuplicateSpecies": false,          // Allow duplicate Pokémon species
  "enableCustomLevel": false,              // Enable forced level modification
  "customBattleLevel": 50,                 // Force Pokémon to specific level
  "battleArenas": [                        // Custom battle arena settings
    {
      "world": "minecraft:overworld",
      "playerPositions": [
        { "x": 0.0, "y": 70.0, "z": 0.0 },
        { "x": 10.0, "y": 70.0, "z": 0.0 }
      ]
    }
  ],
  "victoryRewards": [                      // Rewards awarded after each victory
    "give {player} minecraft:experience_bottle 5",
    "give {player} minecraft:emerald 1"
  ],
  "rankRewards": {                         // Rank-based achievement rewards
    "singles": {
      "Bronze": ["give {player} minecraft:apple 5"],
      "Silver": ["give {player} minecraft:golden_apple 3"],
      "Gold": ["give {player} minecraft:diamond 2"],
      "Platinum": ["give {player} minecraft:diamond_block 1"],
      "Diamond": ["give {player} minecraft:netherite_ingot 1"],
      "Master": ["give {player} minecraft:netherite_block 2"]
    }
  },
  "rankTitles": {                         // Rating threshold values
    "3500": "Master",
    "3000": "Diamond",
    "2500": "Platinum",
    "2000": "Gold",
    "1500": "Silver",
    "0": "Bronze"
  },
  "rankRequirements": {                  // Minimum win rate requirements
    "Bronze": 0.0,
    "Silver": 0.3,
    "Gold": 0.3,
    "Platinum": 0.3,
    "Diamond": 0.3,
    "Master": 0.3
  },
  "enableCrossServer": true,             // Enable cross-server matchmaking
  "cloudServerId": "server",              // Unique server identifier
}