How greatsage/pokemon-showdown works
Showdown is a Node.js Pokémon battle simulator and multiplayer server. Players connect to the server, join rooms, chat or challenge/search for an opponent, and make battle decisions; rooms coordinate battles and relay simulator updates. User identity and permissions, command handling, format/team validation, and generation-specific battle data support that workflow. The excerpts show the server dispatching to users and rooms, room creation and battle coordination, and tools loading battle data; some internal links and documented login/ladder integration are not fully shown, so those links are omitted or marked optional.
Main entry points: tools.js Battle Data Tools · rooms.js Room Coordination · users.js User Sessions · app.js Socket Server
Components 24
Server and Rooms
- Socket Server
app.js - Room Coordination
rooms.js
Users and Commands
- User Sessions
users.js - Chat Commands
chat-commands.js
Battle Runtime
- Battle Simulator
simulator.js
Formats and Data
- Battle Data Tools
tools.js - Battle Formats
data/formats.js - Format Metadata
mods/gen5-bw/formats-data.js - Pokédex
data/pokedex.js - Moves
data/moves.js - Abilities
data/abilities.js - Items
data/items.js - Learnsets
data/learnsets.js - Battle Scripts
data/scripts.js - Status Effects
data/statuses.js - Type Chart
data/typechart.js - Gen 4 Overrides
mods/gen4/moves.js - Gen 4 Pokémon
mods/gen4/pokedex.js - Gen 4 Abilities
mods/gen4/abilities.js - Gen 4 Items
mods/gen4/items.js - Gen 4 Scripts
mods/gen4/scripts.js - Gen 5 Items
mods/gen5-bw/items.js
Other components
- Player
- Login and Ladder Service
Connections 27
- Player → Socket Server: connects
README.md - Socket Server → User Sessions: resolves sessions
app.js - Socket Server → Room Coordination: routes room events
app.js - Socket Server → Chat Commands: dispatches commands
app.js - User Sessions → Room Coordination: joins and leaves
users.js - User Sessions → Chat Commands: parses chat
- Chat Commands → User Sessions: looks up users
chat-commands.js - Room Coordination → Battle Simulator: starts battles
rooms.js - Room Coordination → User Sessions: finds players
rooms.js - Battle Simulator → Battle Data Tools: uses battle data
- Battle Data Tools → Battle Formats: loads data
tools.js - Battle Data Tools → Format Metadata: loads data
tools.js - Battle Data Tools → Pokédex: loads data
tools.js - Battle Data Tools → Moves: loads data
tools.js - Battle Data Tools → Abilities: loads data
tools.js - Battle Data Tools → Items: loads data
tools.js - Battle Data Tools → Learnsets: loads data
tools.js - Battle Data Tools → Battle Scripts: loads data
tools.js - Battle Data Tools → Status Effects: loads data
tools.js - Battle Data Tools → Type Chart: loads data
tools.js - Battle Data Tools → Gen 4 Overrides: loads mods
- Battle Data Tools → Gen 4 Pokémon: loads mods
- Battle Data Tools → Gen 4 Abilities: loads mods
- Battle Data Tools → Gen 4 Items: loads mods
- Battle Data Tools → Gen 4 Scripts: loads mods
- Battle Data Tools → Gen 5 Items: loads mods
- Room Coordination → Login and Ladder Service: updates ladder
README.md