smogon/pokemon-showdown

Pokémon battle simulator.

TypeScript

5,947

27,840 commits

updated Oct 10, 2026

See the code

README

Pokémon Showdown

Navigation: Website | Server repository | Client repository | Dex repository

Build Status Dependency Status

Introduction

Pokémon Showdown is many things:

Pokémon Showdown simulates singles, doubles and triples battles in all the games out so far (Generations 1 through 9).

  • PROTOCOL.md - How the client and server communicate with each other.

  • sim/SIM-PROTOCOL.md - The part of the protocol used for battles and battle messages.

  • CONTRIBUTING.md - Useful code standards to understand if you want to send pull requests to PS (not necessary if you're just using the code and not planning to contribute back).

  • ARCHITECTURE.md - A high-level overview of how the code works.

  • Bot FAQ - An FAQ compiled by Kaiepi regarding making Pokemon Showdown bots - mainly chatbots and battle bots.

Community

PS has a built-in chat service. Join our main server to talk to us!

You can also visit the Pokémon Showdown forums for discussion and help.

If you'd like to contribute to programming and don't know where to start, feel free to check out Ideas for New Developers.

License

Pokémon Showdown's server is distributed under the terms of the MIT License.

Credits

Owner

  • Guangcong Luo [Zarel] - Development, Design, Sysadmin

Staff

  • Andrew Werner [HoeenHero] - Development
  • Annika L. [Annika] - Development
  • Chris Monsanto [chaos] - Development, Sysadmin
  • Kris Johnson [dhelmise] - Development
  • Leonard Craft III [DaWoblefet] - Research (game mechanics)
  • Mathieu Dias-Martins [Marty-D] - Research (game mechanics), Development
  • Mia A [Cassiopeia] - Development

Contributors

hacktoberfest

smogon/pokemon-showdown

Pokémon battle simulator.

TypeScript

5,947

27,840 commits

updated Oct 10, 2026

See the code

README

Pokémon Showdown

Navigation: Website | Server repository | Client repository | Dex repository

Build Status Dependency Status

Introduction

Pokémon Showdown is many things:

Pokémon Showdown simulates singles, doubles and triples battles in all the games out so far (Generations 1 through 9).

  • PROTOCOL.md - How the client and server communicate with each other.

  • sim/SIM-PROTOCOL.md - The part of the protocol used for battles and battle messages.

  • CONTRIBUTING.md - Useful code standards to understand if you want to send pull requests to PS (not necessary if you're just using the code and not planning to contribute back).

  • ARCHITECTURE.md - A high-level overview of how the code works.

  • Bot FAQ - An FAQ compiled by Kaiepi regarding making Pokemon Showdown bots - mainly chatbots and battle bots.

Community

PS has a built-in chat service. Join our main server to talk to us!

You can also visit the Pokémon Showdown forums for discussion and help.

If you'd like to contribute to programming and don't know where to start, feel free to check out Ideas for New Developers.

License

Pokémon Showdown's server is distributed under the terms of the MIT License.

Credits

Owner

  • Guangcong Luo [Zarel] - Development, Design, Sysadmin

Staff

  • Andrew Werner [HoeenHero] - Development
  • Annika L. [Annika] - Development
  • Chris Monsanto [chaos] - Development, Sysadmin
  • Kris Johnson [dhelmise] - Development
  • Leonard Craft III [DaWoblefet] - Research (game mechanics)
  • Mathieu Dias-Martins [Marty-D] - Research (game mechanics), Development
  • Mia A [Cassiopeia] - Development

Contributors

hacktoberfest

Project health

Overall

5.0/10

Maintained

10/10

Code review

7/10
OpenSSF Scorecard

Latest release

0.11.11 · Jul 28, 2026

Releases this year

1

Significant stargazers

(top 24 of 46)

Adam Munawar Rahman

39 followers · starred Mar 2019

Loong Dai

265 followers · starred Jun 2018

Raphael Amorim

2,575 followers · starred Dec 2016

Nicolò Boschi

376 followers · starred Oct 2017