Documentation Index
Fetch the complete documentation index at: https://mintlify.com/tldrwtf/pokedo/llms.txt
Use this file to discover all available pages before exploring further.
Every PokeDo account starts with an ELO rating of 1000. After each completed battle, the server recalculates both players’ ratings using the standard ELO formula with a K-factor of 32. Winning against a higher-rated opponent earns more points than beating a lower-rated one, and losing to a lower-rated opponent costs more. Your rank label — from Youngster to Pokemon Master — is derived automatically from your current ELO.
Commands
View the global leaderboard
Displays the top 20 trainers sorted by ELO rating by default. Columns include rank position, trainer name, ELO, rank label, wins, losses, and win percentage.
Sort by a different field
# Sort by total wins
pokedo leaderboard show --sort battle_wins
# Sort by XP
pokedo leaderboard show --sort xp
# Sort by Pokemon caught
pokedo leaderboard show --sort pokemon_caught
--sort flag (short: -s) accepts elo_rating, battle_wins, xp, and pokemon_caught. Use --limit (-n, default 20) to control result count and --offset (-o, default 0) for pagination.
View your own profile
pokedo leaderboard me -u myname
ELO system
| Parameter | Value |
|---|
| Starting rating | 1000 |
| K-factor | 32 |
| Floor | 0 (rating cannot go below 0) |
| Rank update | After every finished or forfeited battle |
expected_winner = 1 / (1 + 10 ^ ((loser_elo - winner_elo) / 400))
K * (1 - expected_winner) points; the loser loses K * expected_loser points. Both values are rounded to the nearest integer. A draw does not update ELO.
Rank thresholds
Ranks are computed from the compute_rank function in pokedo/core/battle.py and are updated on the server after every battle result.
| Rank | ELO range |
|---|
| Youngster | below 1100 |
| Bug Catcher | 1100–1299 |
| Ace Trainer | 1300–1499 |
| Gym Leader | 1500–1699 |
| Elite Four | 1700–1899 |
| Champion | 1900–2099 |
| Pokemon Master | 2100 and above |
Additional leaderboard fields
The leaderboard and player profile responses include several fields beyond ELO that are useful for comparing trainers:
| Field | Description |
|---|
battle_wins | Total battles won |
battle_losses | Total battles lost |
battle_draws | Draws (mutual KO) |
win_rate | Wins as a percentage of total battles |
pokemon_caught | Total Pokemon caught in single-player mode |
tasks_completed | Total tasks completed |
daily_streak_best | All-time best daily streak |
trainer_level | Trainer level derived from XP |
pokedo leaderboard me and in the full leaderboard table shown by pokedo leaderboard show.