Pokémon battle simulator.
Clone or download
Latest commit d9bd8bd Sep 18, 2018
Failed to load latest commit information.
.vscode VS Code: Use PS's built-in TypeScript version Jul 20, 2018
chat-plugins Rules: Fix crash when used in PMs (#4863) Sep 18, 2018
config Sketchmons: Restrict Extreme Speed (#4859) Sep 16, 2018
data Reduce Emergency Exit's rating Sep 18, 2018
dev-tools Correct Soul-Heart activation order Sep 13, 2018
lib Update to TypeScript 3.0.1 (#4710) Aug 6, 2018
logs Refactor repl.js Dec 24, 2017
mods Gen 5: Random Battle improvements Sep 18, 2018
sim Fix other typo in Sim Readme Sep 18, 2018
static Improve static files Sep 25, 2015
test Test some more illegal egg move combinations Aug 21, 2018
tournaments Tournaments: fix pending challenge message Aug 24, 2018
.editorconfig Editorconfig: Increase indent size to 3 spaces (#4090) Oct 29, 2017
.eslintignore Simplify eslint invocation Nov 8, 2017
.eslintrc Remove eslint no-undef-init rule Apr 28, 2018
.gitattributes Normalize file endings when committing. Dec 31, 2015
.gitignore Add .vs to .gitignore Aug 3, 2018
.npmrc Disable package-lock.json Jan 13, 2018
.travis.yml Travis CI: update to Node 8 and fix Typescript cache Jul 6, 2018
CONTRIBUTING.md Document PS's null/undefined conventions Nov 15, 2017
LICENSE LICENSE: Update copyright year to include 2018 (#4313) Jan 6, 2018
PROTOCOL.md PROTOCOL.md: Add details to |title| doc Jul 23, 2018
Procfile Make Procfile specify Heroku's desired port May 17, 2012
README.md README: Add Honko to Contributors Aug 21, 2018
app.js Update to TypeScript 3.0.1 (#4710) Aug 6, 2018
chat-commands.js Add a chat monitor plugin (#4755) Sep 18, 2018
chat-formatter.js Fix misc bugs discovered by LGTM Sep 6, 2018
chat.js Chat monitor: also display allowed names on the filter list and move … Sep 18, 2018
dnsbl.js Make fsPath.read() return a string by default Jan 18, 2018
ladders-local.js Refactor for...length to for...of where applicable (#4516) Mar 24, 2018
ladders-remote.js Improve stream interrupt error message Feb 13, 2018
ladders.js Prevent searching battles in challenge-only formats (#4589) Apr 15, 2018
loginserver.js Update to TypeScript 3.0.1 (#4710) Aug 6, 2018
monitor.js Helptickets: Lower the amount of helptickets that shared IPs can have ( Aug 13, 2018
old-simulator-doc.txt Update "Pokemon" to "Pokémon" in old-simulator-doc.txt file Jun 11, 2015
package.json Update to TypeScript 3.0.1 (#4710) Aug 6, 2018
pokemon-showdown Make pokemon-showdown ES3-compatible Jul 17, 2018
punishments.js Add a chat monitor plugin (#4755) Sep 18, 2018
room-battle.js Timer: Add a debug mode Aug 22, 2018
room-game.js Update to TypeScript 3.0.1 (#4710) Aug 6, 2018
roomlogs.js Remove user's text from scrollback log (#4751) Sep 13, 2018
rooms.js Add basic language support (#4862) Sep 18, 2018
simulator-doc.txt Refactor Decision -> Action Dec 2, 2017
sockets.js Update to TypeScript 3.0.1 (#4710) Aug 6, 2018
team-validator-async.js Update to TypeScript 3.0.1 (#4710) Aug 6, 2018
tsconfig.json Add a chat monitor plugin (#4755) Sep 18, 2018
users.js Add a chat monitor plugin (#4755) Sep 18, 2018
verifier.js Update to TypeScript 3.0.1 (#4710) Aug 6, 2018


Pokémon Showdown

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

Build Status Dependency Status devDependency Status


This is the source code for the game server of Pokémon Showdown, a website for Pokémon battling. Pokémon Showdown simulates singles, doubles and triples battles in all the games out so far (Generations 1 through 7).

This repository contains the files needed to set up your own Pokémon Showdown server. Note that to set up a server, you'll also need a server computer.

You can use your own computer as a server, but for other people to connect to your computer, you'll need to expose a port (default is 8000 but you can choose a different one) to connect to, which sometimes requires port forwarding. Note that some internet providers don't let you host a server at all, in which case you'll have to rent a VPS to use as a server.



(Requires Node.js 8+)

Detailed installation instructions

Pokémon Showdown requires you to have Node.js installed, 8.x or later (7.7 or later can work, but you might as well be on the latest stable).

Next, obtain a copy of Pokémon Showdown. If you're reading this outside of GitHub, you've probably already done this. If you're reading this in GitHub, there's a "Clone or download" button near the top right (it's green). I recommend the "Open in Desktop" method - you need to install GitHub Desktop which is more work than "Download ZIP", but it makes it much easier to update in the long run (it lets you use the /updateserver command).

Pokémon Showdown is installed and run using a command line. In Mac OS X, open Terminal (it's in Utilities). In Windows, open Command Prompt (type cmd into the Start menu and it should be the first result). Type this into the command line:


Replace LOCATION with the location Pokémon Showdown is in (ending up with, for instance, cd "~/Downloads/Pokemon-Showdown" or cd "C:\Users\Bob\Downloads\Pokemon-Showdown\").

This will set your command line's location to Pokémon Showdown's folder. You'll have to do this each time you open a command line to run commands for Pokémon Showdown.

Copy config/config-example.js into config/config.js, and edit as you please.

Congratulations, you're done setting up Pokémon Showdown.

Now, to start Pokémon Showdown, run the command:

node pokemon-showdown

(If you're not on Windows, we recommend doing ./pokemon-showdown instead.)

You can also specify a port:

node pokemon-showdown 8000

Visit your server at http://SERVER:8000

Replace SERVER with your server domain or IP. Replace 8000 with your port if it's not 8000 (the default port).

Yes, you can test even if you are behind a NAT without port forwarding: http://localhost:8000 will connect to your local machine. Some browser setups might prevent this sort of connection, however (NoScript, for instance). If you can't get connecting locally to work in Firefox, try Chrome.

You will be redirected to http://SERVER.psim.us. The reason your server is visited through psim.us is to make it more difficult for servers to see a user's password in any form, by handling logins globally. You can embed this in an iframe in your website if the URL is a big deal with you.

If you truly want to host the client yourself, there is a repository for the Pokémon Showdown Client. It's not recommended for beginners, though.

Setting up an Administrator account

Once your server is up, you probably want to make yourself an Administrator (~) on it.


To become an Administrator, create a file named config/usergroups.csv containing


Replace USER with the username that you would like to become an Administrator. Do not put a space between the comma and the tilde.

This username must be registered. If you do not have a registered account, you can create one using the Register button in the settings menu (it looks like a gear) in the upper-right of Pokémon Showdown.

Once you're an administrator, you can promote/demote others easily with the /globaladmin, /globalleader, /globalmod, etc commands.

Browser support

Pokémon Showdown currently supports, in order of preference:

  • Chrome
  • Firefox
  • Opera
  • Safari 5+
  • IE11+
  • Chrome/Firefox/Safari for various mobile devices

Pokémon Showdown is usable, but expect degraded performance and certain features not to work in:

  • Safari 4+
  • IE9+

Pokémon Showdown is mostly developed on Chrome, and Chrome or the desktop client is required for certain features like dragging-and-dropping teams from PS to your computer. However, bugs reported on any supported browser will usually be fixed pretty quickly.


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.


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



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


  • Chris Monsanto [chaos] - Sysadmin
  • Leonardo Julca [Slayer95] - Development
  • Mathieu Dias-Martins [Marty-D] - Research (game mechanics), Development
  • [The Immortal] - Development

Retired Staff

  • Bill Meltsner [bmelts] - Development, Sysadmin
  • Cathy J. Fitzpatrick [cathyjf] - Development, Sysadmin
  • Hugh Gordon [V4] - Research (game mechanics), Development
  • Juanma Serrano [Joim] - Development, Sysadmin

Major Contributors

  • Bär Halberkamp [bumbadadabum] - Development
  • Kevin Lau [Ascriptmaster] - Development, Art (battle animations)
  • Konrad Borowski [xfix] - Development
  • Quinton Lee [sirDonovan] - Development


  • Andrew Goodsell [Zracknel] - Art (battle weather backdrops)
  • Avery Zimmer [Lyren, SolarisFox] - Development
  • Ben Davies [Morfent] - Development
  • Ben Frengley [TalkTakesTime] - Development
  • Cody Thompson [Rising_Dusk] - Development
  • [Honko] - Development
  • Ian Clail [Layell] - Art (battle graphics, sprites)
  • Jeremy Piemonte [panpawn] - Development
  • Kris Johnson [Kris] - Development
  • Neil Rashbrook [urkerab] - Development
  • Robin Vandenbrande [Quinella] - Development
  • [Ridaz] - Art (battle animations)
  • Tobias Mann [asgdf] - Development

Special thanks