Skip to content

Staff guide

Admin permissions all start with showdown.admin. and are off by default. Player permissions start with showdown.command. and are on by default. Ops have everything. Test as a non-op.

Formats (rulesets)

Use the GUI: open /sd and click Ruleset Editor (shown only to staff with showdown.admin.ruleset.set). Page 1 of the editor has a Scope button (ranked, tournament, tower) that decides where the format shows up.

/sd ruleset create gen9ou Gen 9 OU
/sd ruleset enable gen9ou
/sd ruleset set gen9ou levelCap 100
/sd ruleset set gen9ou allowDynamax false
/sd ruleset add gen9ou bannedSpecies Koraidon
/sd ruleset list-setting gen9ou bannedSpecies
/sd ruleset reload

allowMega, allowUltraBurst, allowZMoves, allowDynamax and allowGigantamax can only be set by command or in the JSON file. The GUI does not show them. List settings for add, remove and list-setting are bannedSpecies, bannedItems, bannedAbilities, bannedMoves and the matching whitelist... names. Rulesets are stored by Battlecore (see its README). The Draft Factory format has the id draftfactory.

Arenas

/sd arena opens the Battlecore Arena Manager. An arena needs the pvp tag to be used by the ranked queue and tournaments.

Seasons

/sd season start s5 Season 5
/sd season current
/sd season end

Tournaments

Task Command
Create an automated tournament template /sd tournament autocreate (opens a wizard)
Start or cancel a tournament now /sd tournament forcestart <id>, forcecancel <id>
Reset a stuck tournament /sd tournament forcereset <id>
Remove every tournament /sd tournament clearall
Dump active tournament state to the log /sd tournament debugactive

Draft pools (all need showdown.admin.tournament):

/sd tournament draft pool create starters 6 Starter Draft
/sd tournament draft pool addparty starters 1
/sd tournament draft pool info starters
/sd tournament draft set 12 starters 30
/sd tournament draft template-set weekly starters

addparty copies the Pokemon in your party slot into the pool. set attaches a pool to one tournament, with an optional seconds-per-pick. template-set attaches it to an automated template.

Stuck matches

Task Command
List active and saved matches /sd match list
Save a stuck ranked match /sd match save <player>
Restart it later from the saved turn /sd match restore <player>
Throw the saved copy away /sd match discard <player>
End a player's Showdown battle with no result /sd forceend <player>

Save a stuck match first, then end the battle any way you like. Because a save exists, the end records nothing (no ELO, no reward, no history). restore puts both players back in an arena with their saved teams, turn, weather and terrain. Tournament matches cannot be saved. They have their own restart.