pokemon-showdown/sim
André Bastos Dias 815b5f260a
Some checks are pending
Node.js CI / build (18.x) (push) Waiting to run
Support inheritance of ability, item, and move conditions (#11754)
2026-03-19 03:44:48 -07:00
..
examples
tools
battle-actions.ts Show the hint message for Ogerpon Terastallization only on one side (#11810) 2026-03-17 23:40:12 -06:00
battle-queue.ts
battle-stream.ts
battle.ts Fix Skill Swap messages 2026-03-07 02:35:15 -05:00
dex-abilities.ts Support inheritance of ability, item, and move conditions (#11754) 2026-03-19 03:44:48 -07:00
dex-conditions.ts
dex-data.ts
dex-formats.ts
dex-items.ts Support inheritance of ability, item, and move conditions (#11754) 2026-03-19 03:44:48 -07:00
dex-moves.ts Support inheritance of ability, item, and move conditions (#11754) 2026-03-19 03:44:48 -07:00
dex-species.ts
DEX.md
dex.ts Support inheritance of ability, item, and move conditions (#11754) 2026-03-19 03:44:48 -07:00
field.ts
global-types.ts Linked: Fix modified-priority moves in a link 2026-03-09 12:00:37 -06:00
index.ts
NONSTANDARD.md
pokemon.ts Fix injective field position indexing (#11789) 2026-03-03 14:32:45 -07:00
prng.ts
README.md
side.ts
SIM-PROTOCOL.md
SIMULATOR.md
state.ts
team-validator.ts Implement Pomeg Glitch Clause (#11800) 2026-03-17 16:37:23 -07:00
TEAMS.md
teams.ts
tsconfig.json

Node.js package

Pokémon Showdown has a Node.js API. It currently only works in Node, not browsers, although we're working on unifying it to work in browsers.

You can install it with the usual:

npm install pokemon-showdown

And you can use it to do the following things:

Simulating battles

See: sim/SIMULATOR.md

Also available as a command-line API!

Validating, generating, and converting teams

See: sim/TEAMS.md

Also available as a command-line API!

Getting Pokédex information

See: sim/DEX.md

Undocumented APIs

Pokémon Showdown's Node.js package has TypeScript definitions for everything it exports, including a lot of undocumented APIs.

Please be aware that any undocumented API is unstable and should not be relied upon not to change. We do not follow semver for undocumented APIs. If you really want to use an undocumented API, remember to pin the exact PS version in your dependencies. You probably also want to follow the API update channel in the Discord server: https://psim.us/devdiscord