Reference¶
Commands, permission nodes and config keys, read straight from the source code. For how and why to use them, see the other pages.
| mod_id | showdown |
| Version | 3.4.2 |
| Minecraft / NeoForge | 1.21.1 / 21.1.248 |
| Builds against Pixelmon | 9.4.2 |
| Install | Loads on both sides. See the Overview page for whether clients need it. |
| Git | https://github.com/Pixelrus/pixelmon-showdown |
| Depends on | pixelmon [9.4.2,) (required), battlecore [1.1.0,) (required) |
Commands¶
| Command | Who can use it | Description |
|---|---|---|
/showdown |
op level 0 | |
/showdown menu |
op level 0 | |
/showdown queue <ruleset> |
op level 0 | |
/showdown leave |
op level 0 | |
/showdown status |
op level 0 | |
/showdown stats |
op level 0 | |
/showdown stats <ruleset> |
op level 0 | |
/showdown stats <ruleset> <player> |
op level 0 | |
/showdown leaderboard <ruleset> |
op level 0 | |
/showdown leaderboard <ruleset> <page> |
op level 0 | |
/showdown history |
op level 0 | |
/showdown history <page> |
op level 0 | |
/showdown history <player> |
op level 0 | |
/showdown history <player> <page> |
op level 0 | |
/showdown preview |
op level 0 | |
/showdown watch <arena> |
op level 0 | |
/showdown tournament |
op level 0 | |
/showdown tournament create |
op level 0 | |
/showdown tournament autocreate |
showdown.admin.tournament |
|
/showdown tournament join <id> |
op level 0 | |
/showdown tournament leave |
op level 0 | |
/showdown tournament start |
op level 0 | |
/showdown tournament cancel |
op level 0 | |
/showdown tournament bracket |
op level 0 | |
/showdown tournament bracket <id> |
op level 0 | |
/showdown tournament list |
op level 0 | |
/showdown tournament forcestart <id> |
showdown.admin.tournament |
|
/showdown tournament forcecancel <id> |
showdown.admin.tournament |
|
/showdown tournament forcereset <id> |
showdown.admin.tournament |
|
/showdown tournament clearall |
showdown.admin.tournament.clearall |
|
/showdown tournament debugactive |
showdown.admin.tournament.debug |
|
/showdown tournament draft pool create <id> <team_size> <display_name> |
showdown.admin.tournament |
|
/showdown tournament draft pool list |
showdown.admin.tournament |
|
/showdown tournament draft pool info <pool> |
showdown.admin.tournament |
|
/showdown tournament draft pool addparty <pool> <slot> |
showdown.admin.tournament |
|
/showdown tournament draft pool remove <pool> <index> |
showdown.admin.tournament |
|
/showdown tournament draft set <tournament> <pool> |
showdown.admin.tournament |
|
/showdown tournament draft set <tournament> <pool> <pick_seconds> |
showdown.admin.tournament |
|
/showdown tournament draft clear <tournament> |
showdown.admin.tournament |
|
/showdown tournament draft template-set <template> <pool> |
showdown.admin.tournament |
|
/showdown tournament draft template-set <template> <pool> <pick_seconds> |
showdown.admin.tournament |
|
/showdown tournament draft template-clear <template> |
showdown.admin.tournament |
|
/showdown tournament draft status |
op level 0 | |
/showdown tournament draft status <tournament> |
op level 0 | |
/showdown tournament draft options |
op level 0 | |
/showdown tournament draft options <page> |
op level 0 | |
/showdown tournament draft pick <index> |
op level 0 | |
/showdown arena |
showdown.admin.arena.manage |
|
/showdown ruleset list |
showdown.command.ruleset.list |
|
/showdown ruleset info <id> |
showdown.admin.ruleset.info |
|
/showdown ruleset create <id> <name> |
showdown.admin.ruleset.create |
|
/showdown ruleset createscoped <id> <scope> <name> |
showdown.admin.ruleset.create |
|
/showdown ruleset setscope <id> <scope> |
showdown.admin.ruleset.create |
|
/showdown ruleset delete <id> |
showdown.admin.ruleset.delete |
|
/showdown ruleset enable <id> |
showdown.admin.ruleset.enable |
|
/showdown ruleset disable <id> |
showdown.admin.ruleset.disable |
|
/showdown ruleset reload |
showdown.admin.ruleset.reload |
|
/showdown ruleset set <id> <setting> <boolValue> |
showdown.admin.ruleset.set |
|
/showdown ruleset set <id> <setting> <intValue> |
showdown.admin.ruleset.set |
|
/showdown ruleset set <id> <setting> <stringValue> |
showdown.admin.ruleset.set |
|
/showdown ruleset list-setting <id> <setting> |
showdown.admin.ruleset.listsetting |
|
/showdown ruleset add <id> <setting> <value> |
showdown.admin.ruleset.add |
|
/showdown ruleset remove <id> <setting> <value> |
showdown.admin.ruleset.remove |
|
/showdown season start <id> <name> |
showdown.admin.season.manage |
|
/showdown season end |
showdown.admin.season.manage |
|
/showdown season current |
showdown.command.season.view |
|
/showdown season list |
showdown.command.season.view |
|
/showdown match list |
showdown.admin.match.list |
|
/showdown match save <player> |
showdown.admin.match.save |
|
/showdown match restore <player> |
showdown.admin.match.restore |
|
/showdown match discard <player> |
showdown.admin.match.discard |
|
/showdown forceend <player> |
showdown.admin.forceend |
|
/sd |
op level 0 | |
/ranked |
op level 0 |
Permission nodes¶
| Node | Default | What it allows |
|---|---|---|
showdown.admin.arena.delete |
see source | Permission to delete an arena (/showdown arena delete). |
showdown.admin.arena.finalize |
see source | Permission to finalize arena setup (/showdown arena finalize). |
showdown.admin.arena.list |
see source | Permission to list arenas (/showdown arena list). |
showdown.admin.arena.manage |
see source | Permission to manage arenas through the Arena Manager GUI (/showdown arena). |
showdown.admin.arena.seticon |
see source | Permission to set arena icon (/showdown arena seticon). |
showdown.admin.arena.setpos |
see source | Permission to set arena position (/showdown arena setpos). |
showdown.admin.arena.setteleport |
see source | Permission to set arena teleport location (/showdown arena setteleport). |
showdown.admin.arena.tp |
see source | Permission to teleport to an arena (/showdown arena tp). |
showdown.admin.forceend |
see source | Permission to force-end a battle (/showdown forceend). |
showdown.admin.match.discard |
see source | Permission to discard a saved match (/showdown match discard). |
showdown.admin.match.list |
see source | Permission to list active and saved matches (/showdown match list). |
showdown.admin.match.restore |
see source | Permission to restore a saved match (/showdown match restore). |
showdown.admin.match.save |
see source | Permission to save a stuck match's state (/showdown match save). |
showdown.admin.ruleset.add |
see source | Permission to add a ruleset to a category (/showdown ruleset add). |
showdown.admin.ruleset.create |
see source | Permission to create a ruleset (/showdown ruleset create). |
showdown.admin.ruleset.delete |
see source | Permission to delete a ruleset (/showdown ruleset delete). |
showdown.admin.ruleset.disable |
see source | Permission to disable a ruleset (/showdown ruleset disable). |
showdown.admin.ruleset.enable |
see source | Permission to enable a ruleset (/showdown ruleset enable). |
showdown.admin.ruleset.info |
see source | Permission to view the details of a DISABLED ruleset (/showdown ruleset info). |
showdown.admin.ruleset.listsetting |
see source | Permission to list ruleset settings (/showdown ruleset listsetting). |
showdown.admin.ruleset.reload |
see source | Permission to reload rulesets (/showdown ruleset reload). |
showdown.admin.ruleset.remove |
see source | Permission to remove a ruleset from a category (/showdown ruleset remove). |
showdown.admin.ruleset.set |
see source | Permission to set the active ruleset (/showdown ruleset set). |
showdown.admin.season.manage |
see source | Permission to manage seasons (/showdown season manage). |
showdown.admin.tournament |
see source | Permission to administer tournaments (/showdown tournament admin). |
showdown.admin.tournament.clearall |
see source | Permission to clear all tournaments (/showdown tournament clearall). |
showdown.admin.tournament.debug |
see source | Permission to debug tournaments (/showdown tournament debug). |
showdown.admin.tournament.draftalerts |
see source | Permission to receive tournament draft alerts (admin.tournament.draftalerts). |
showdown.command.history |
see source | Permission to view match history (/showdown history). |
showdown.command.leaderboard |
see source | Permission to view the leaderboard (/showdown leaderboard). |
showdown.command.leave |
see source | Permission to leave the matchmaking queue (/showdown leave). |
showdown.command.menu |
see source | Permission to open the main menu (/showdown menu). |
showdown.command.queue |
see source | Permission to join the matchmaking queue (/showdown queue). |
showdown.command.ruleset.list |
see source | Permission to list available rulesets (/showdown ruleset list). |
showdown.command.ruleset.view |
see source | Permission to view the details of an ENABLED ruleset (/showdown ruleset info and the queue GUI's right-click "view rules"). |
showdown.command.season.view |
see source | Permission to view the current season (/showdown season view). |
showdown.command.stats |
see source | Permission to view player stats (/showdown stats). |
showdown.command.status |
see source | Permission to check queue status (/showdown status). |
showdown.command.tournament |
see source | Permission to access tournament commands (/showdown tournament). |
showdown.command.tournament.create |
see source | Permission to create a tournament (/showdown tournament create). |
showdown.command.tournament.join |
see source | Permission to join a tournament (/showdown tournament join). |
showdown.command.tournament.view |
see source | Permission to view tournament details (/showdown tournament view). |
Config¶
| File | Key | Default | Notes |
|---|---|---|---|
config/showdown-server.toml |
database.host |
localhost |
MariaDB host |
config/showdown-server.toml |
database.port |
3306 |
MariaDB port (range 1 to 65535) |
config/showdown-server.toml |
database.database |
showdown |
Database name |
config/showdown-server.toml |
database.username |
root |
Database username |
config/showdown-server.toml |
database.password |
`` | Database password |
config/showdown-server.toml |
elo.defaultElo |
1000 |
Starting ELO for new players (range 100 to 9999) |
config/showdown-server.toml |
elo.kFactor |
32 |
ELO K-factor (higher = bigger rating swings) (range 1 to 256) |
config/showdown-server.toml |
elo.repeatOpponentDecay |
true |
Shrink ELO swings against a repeat opponent using the rankedRewards decay and recovery settings: at the default 0.2 step the 2nd match in a row moves 80% of normal ELO, the 6th moves none |
config/showdown-server.toml |
rankedRewards.enabled |
true |
Pay configurable money rewards for eligible completed ranked matches (tournaments keep their separate prize system) |
config/showdown-server.toml |
rankedRewards.winnerBaseAmount |
100.0 |
Full money reward for a ranked-match winner before repeat-opponent decay (range 0.0 to 1_000_000_000.0) |
config/showdown-server.toml |
rankedRewards.loserBaseAmount |
50.0 |
Full money reward for a ranked-match loser before repeat-opponent decay (range 0.0 to 1_000_000_000.0) |
config/showdown-server.toml |
rankedRewards.repeatOpponentDecayStep |
0.2 |
Fraction of the base reward (and, with elo.repeatOpponentDecay, the ELO swing) removed per repeat against the same opponent: 0.2 gives 100%, 80%, 60%, 40%, 20%, 0% (range 0.0 to 1.0) |
config/showdown-server.toml |
rankedRewards.otherOpponentRecoveryPerMatch |
0.5 |
Pair heat removed for every match either participant completes against somebody else; 0.5 restores 10% of the reward per match at the default decay step (range 0.0 to 100.0) |
config/showdown-server.toml |
rankedRewards.passiveRecoveryMinutesPerHeat |
60 |
Minutes without a rematch that remove one pair-heat unit; only whole periods count, so reductions stay in clean steps (range 1 to 43_200) |
config/showdown-server.toml |
rankedRewards.minimumCompletedTurns |
3 |
Minimum completed turns before a win pays rewards; forfeits pay regardless (repeat-opponent decay still applies) (range 0 to 1_000) |
config/showdown-server.toml |
rankedRewards.minimumPayout |
0.01 |
Calculated rewards below this amount are rounded down to zero (range 0.0 to 1_000_000.0) |
config/showdown-server.toml |
queue.tickInterval |
20 |
Ticks between matchmaking checks (20 = 1 second) (range 5 to 200) |
config/showdown-server.toml |
queue.battleCountdown |
5 |
Seconds of countdown before teleporting to arena (range 0 to 30) |
config/showdown-server.toml |
queue.postBattleTeleportDelay |
60 |
Ticks after battle ends before teleporting players back (range 0 to 200) |
config/showdown-server.toml |
announcements.queueJoin |
true |
Tell everyone else on the server when a player joins a ranked queue |
config/showdown-server.toml |
announcements.queueJoinCooldownSeconds |
60 |
Seconds before the same player's queue join is announced again; stops leave/rejoin chat spam (range 0 to 86_400) |
config/showdown-server.toml |
announcements.matchStart |
true |
Tell everyone else on the server when a ranked match starts; arenas in the player arena-teleport menu get a click-to-watch link |
config/showdown-server.toml |
server.name |
main |
Logical backend server name used for arena/tournament ownership, e.g. main or events |
config/showdown-server.toml |
server.draftTargetServer |
events |
Velocity backend name that should run draft tournaments after drafting finishes |
config/showdown-server.toml |
server.draftFactoryTargetServer |
events |
Velocity backend name that should run Draft Factory queue matches |
config/showdown-server.toml |
server.rewardAuthorityServer |
main |
Logical backend server name that should execute tournament reward payouts |
config/showdown-server.toml |
server.draftTransferDelaySeconds |
10 |
Seconds to wait after drafting completes before transferring players to the event server (range 0 to 600) |
config/showdown-server.toml |
server.draftTransferStartGraceSeconds |
10 |
Extra seconds for the event server to wait for arrivals before starting transferred draft tournaments (range 0 to 600) |
config/showdown-server.toml |
debug.tournamentStatusLogging |
false |
Enable verbose logging for tournament state, draft transfers, and handoff flow |
Files referenced in source: /data/showdown/draft-factory-matchups.json