FAQ & Troubleshooting

No. CobbleRanked runs entirely server-side. Players join with a vanilla client and just type /ranked. Nothing to install.

Yes. CobbleRanked is built on top of Cobblemon’s battle system. You also need GashiLibs and MailLib (for reward delivery). See Installation.

Yes. Set language: ja-jp in config.yaml and run /rankedadmin reload. The GUI and messages switch to Japanese. English (en-us) and Japanese (ja-jp) ship with the mod; any other language can be added as a custom file.

• Velocity / BungeeCord: supported for cross-server setups (used to transfer players between servers).
• Arclight (Forge/Bukkit hybrid): compatible, with some timing adjustments built in. If anything misbehaves, let us know in Discord.

That’s expected. In Random Battle, or any format where you battle with a full party of 6, team selection is skipped and the match starts straight at lead selection. In normal ranked (picking a few from your party) it does appear.

• Make sure at least one arena is enabled (/rankedadmin arena status).
• You need at least two players in the queue for a match to form.
• A large rating gap makes matches take longer. The search range expands slowly over time.
• See Matchmaking settings for details.

Check that the arena’s exit (return point) is set. Configure it with /rankedadmin arena create <name> exit.

Handled. Forfeits and mid-battle disconnects carry escalating penalties, and early forfeits right after the match starts can carry an extra-heavy penalty. You can also optionally forbid forfeiting during the first few turns. See Flee & Forfeit Penalties.

That’s by design. While no season is running, ranked queue entry is blocked (casual battles stay open). Once a new season starts, ranked opens again.

Six tiers, named after Poké Balls, climbed in order:

In Glicko-2 mode, separate thresholds centered on 1500 are applied automatically.

They won’t. At low ratings the system is asymmetric: you gain more on a win than you lose on a loss (matching Pokémon Showdown). Newcomers climb steadily instead of spiraling.

Common causes:

• It was a casual battle (/casual); rating doesn’t move there.
• You hit the daily rating-gain cap. Losses are never capped.
• The match didn’t finish cleanly (disconnect, etc.).

For one player: /rankedadmin setelo <player> <format> <elo>. For everyone at once (new-season reset), use onSeasonEnd in Season settings and pick a hard reset or a partial (soft) reset.

• Make sure MailLib is installed. Rewards go out through the mailbox.
• Check that reward commands are set in rewards.yaml or your season preset.
• Players claim with /mailbox. Rewards for offline players land on their next login.

/mailbox

Open the mailbox and claim.

Yes. Any economy plugin/mod with a money command works — put its command in the reward lists (battle.yaml → rewards for per-match, rewards.yaml / season presets for season-end):

# battle.yaml — Impactor (Fabric)
rewards:
  victoryCommands:
    - "eco deposit 1000 {player}"

# battle.yaml — Vault/Essentials (Arclight)
rewards:
  victoryCommands:
    - "eco give {player} 1000"

Casual matches have their own lists (casualVictoryCommands / casualDefeatCommands) — keep those lighter, since casual games are high-frequency.

Only if you configure them. casualVictoryCommands / casualDefeatCommands in battle.yaml are empty by default. Missions (/casual missions) are the main reward loop for casual play. See Victory/Defeat Rewards.

• Check the end date/time and timezone in season.yaml (IANA format, e.g. Asia/Tokyo).
• Rotate manually with /rankedadmin season rotate.
• If the server was offline when the season changed, it’s detected and applied on the next startup.

Run /rankedadmin reload. On cross-server setups, every server needs a reload or restart.

The team tripped a blacklist (banned Pokémon/moves/items), a label limit (e.g. max 1 Legendary), or a duplicate rule (no duplicate species or held items). See Blacklist configuration.

/rankedadmin banranked <player> bans them from ranked (requires LuckPerms; casual still allowed). Lift it with /rankedadmin unbanranked <player>.

/rankedadmin clearpenalty <player>

Yes. Add a language file under config/cobbleranked/language/ and set language to match. Any language works. See Languages.

• A shared database (MySQL or MongoDB; SQLite is single-server only).
• Redis for queue sync.
• A proxy (Velocity or BungeeCord) for player transfers.

Steps are in Cross-Server Setup.

• Is Redis running? (redis-cli ping should return PONG.)
• Are the host, port, and password in config.yaml correct?
• Is port 6379 open in your firewall?

Make sure every server points at the same database. SQLite is per-server, so it can’t back a cross-server setup.