Ranks
Ranks and Seasons System
Cobblemon BattleHUB has an integrated competitive system for ranking and pairing players. It keeps matches fair, discourages intentional abandonment, and automates season transitions.
The Rating Algorithm (Glicko-2)
Instead of classic Elo (a single fixed number), BattleHUB uses Glicko-2, which tracks two values per Ladder for each player:
| Value | Meaning | Starting default |
|---|---|---|
Rating (R) |
The player's estimated skill score. | 1500 |
Rating Deviation (RD) |
How uncertain the system is about that skill. High = unsure, low = confident. | 350 |
The system is ~95% confident the player's real skill sits within roughly R ± 2 × RD.
How uncertainty (RD) affects matches
- New / inactive players (
RDhigh): the system doesn't know your level yet, so each win or loss causes a largeRswing to place you quickly. - Regular players (
RDlow): as you play,RDshrinks toward a floor (around50). The system trusts your rating, soRchanges become smaller and more stable.
Scale conversion (internal)
For its variance and volatility (σ) math, Glicko-2 works on a compressed internal scale: it divides (R − 1500) and RD by the constant 173.7178, runs the update, then multiplies back. You never see or configure this — it's purely how the algorithm works under the hood.
Desertion Penalty System (Leaver Buster)
To stop players ruining ranked by rage-quitting a losing battle, the CobblemonBattleHandler watches for intentional abandons (Alt+F4, freeze, crash) and turn timeouts from being AFK.
What happens on abandonment
When a player disconnects or is punished for inactivity mid-ranked-match, recordForfeitOrAFK(loser) runs:
- Automatic loss: the leaver takes an immediate loss and drops
Ras normal. - W.O. win for the opponent: the remaining player is told the opponent left and receives the win.
- Leaver Ban: the leaver is barred from the ranked queue for a cumulative period (each fresh offence stacks more time).
- Honor penalty: the leaver's Honor drops by 15% (never below 0%).
Re-queuing during an active ban shows a formatted notice, e.g.:
"You are banned from the competitive queue for another 01h 15m due to recent abandons."
Clear a ban manually with /bh clearban <player>.
Honor
Honor is a sportsmanship score shown as a badge on each player's profile (hover the badge in-game for a quick explanation). Everyone starts at 100%.
| Event | Honor change |
|---|---|
| Forfeit or AFK / disconnect in a ranked match (see above) | −15% |
| Finishing a match normally (win or loss, ranked or casual) | +2% |
Honor is always kept between 0% and 100%, so it takes several clean matches to recover from a single abandonment ("punish fast, recover slowly" — the same pace as the Leaver Ban's escalation reset after 20 clean matches).
Note
Honor is a reputation indicator only — it does not block anyone from the queue by itself. The actual queue restriction is the Leaver Ban above. Matches that end as a mutual no-show (nobody contested the battle) change nobody's Honor.
Profile Data
Stored in the MySQL / SQLite table (see Storage):
| Key | Meaning |
|---|---|
TOTAL_BATTLES |
Matches played (Ranked + Casual) |
RANKED_WINS / RANKED_LOSSES |
Competitive wins / losses |
RANKED_MATCHES |
Completed competitive matches |
QUICK_WINS / QUICK_MATCHES |
Casual matchmaking stats |
RANKED_BAN_EXPIRATION |
Millisecond timestamp when a penalized player may return to ranked |
Reset a single player's rating and rank with /bh resetrank <player>.
Season Management
Seasons are configured in server_config.json (currentSeasonNumber, currentSeasonName, the reward blocks…) and rolled over with a command.
Ending a season
/bh season rollover
This runs, in order:
- Determine winners — scans each ranked Ladder and generates the Top 1 / Top 3 / Top 10 rewards from
seasonEndRewards.placementRewardsinserver_config.json. - Filter inactive players — only players who met
minimumGamesfor the season are eligible for rewards and the final rankings. - Archive — the finished season is appended to
completedRankedSeasons. - Soft reset — every active player's
Ris pulled back toward1500andRDis reset to350for the new season (progress isn't wiped, just softened).
Check the current season any time with /bh season (info) or /bh season stats (admin detail).