Pokémon battle simulator.
Latest commit ab8a6ea Jan 22, 2017 @ascriptmaster ascriptmaster committed with TheImmortal Random Battle: Improve move rejection for dual STAB issues (#3104)
Reject Hex entirely if Will-o-Wisp is not present, to prevent it on the
same set as Shadow Ball.

Reject Fire Blast with Flare Blitz.
Failed to load latest commit information.
chat-plugins movesearch: Add support for Z-status effects (#3105) Jan 22, 2017
config BH: Add CFZ Clause Jan 17, 2017
data Random Battle: Improve move rejection for dual STAB issues (#3104) Jan 22, 2017
dev-tools Tests: tweak user mocks, add Connection tests, fix Trivia tests (#2682) Aug 9, 2016
lib Some cleanup in /modlog Dec 8, 2014
logs Replace 'this.sendReply' with 'this.errorReply' in some cases Sep 28, 2015
mods Mix and Mega: Set Kyurem-Black as Uber Jan 15, 2017
static Improve static files Sep 25, 2015
test Implement sockets.js unit tests (#3098) Jan 16, 2017
tournaments Allow tour banning offline users Dec 10, 2016
.eslintignore eslint: Manually skip ignored directories May 3, 2016
.eslintrc Rename simulator.js to room-battle.js Oct 21, 2016
.gitattributes Normalize file endings when committing. Dec 31, 2015
.gitignore Modify data and mods files to follow style rules Dec 31, 2015
.travis.yml Increase minimum requirements to Node v6 Sep 12, 2016
CONTRIBUTING.md CONTRIBUTING.md: Don't open duplicate PRs (#3040) Dec 20, 2016
LICENSE License: Update copyright year to include 2017 (#3061) Jan 2, 2017
PROTOCOL.md PROTOCOL: Document |uhtml| and |uhtmlchange| (#2656) Jul 30, 2016
Procfile Make Procfile specify Heroku's desired port May 17, 2012
README.md README: Add Dex to Navigation section (#2785) Oct 3, 2016
app.js Rename simulator.js to room-battle.js Oct 21, 2016
battle-engine.js Update check for Z-Moves against protection Jan 10, 2017
chat-commands.js Fix /markshared and /unmarkshared not checking for existing keys prop… Dec 30, 2016
chat.js Fix username banword filter Jan 6, 2017
crashlogger.js Report crashes in Dev Oct 3, 2016
dnsbl.js Standardize using const when declaring modules (#2806) Oct 2, 2016
ladders-remote.js Rename CommandParser to Chat Oct 1, 2016
ladders.js Rename CommandParser to Chat Oct 1, 2016
loginserver.js Rename CommandParser to Chat Oct 1, 2016
monitor.js Rename CommandParser to Chat Oct 1, 2016
old-simulator-doc.txt Update "Pokemon" to "Pokémon" in old-simulator-doc.txt file Jun 11, 2015
package.json v0.11.0 Nov 29, 2016
pokemon-showdown Refactor out Room#chat Sep 13, 2016
process-manager.js Performance: replace direct references to arguments with rest paramet… Oct 4, 2016
punishments.js Make ip-based room punishments show up on /ip Dec 30, 2016
repl.js Remove .js extension from requires (#2725) Aug 30, 2016
room-battle.js Refactor BattleEngine Oct 23, 2016
room-game.js Performance: replace direct references to arguments with rest paramet… Oct 4, 2016
rooms.js Fix DeprecationWarning Jan 8, 2017
simulator-doc.txt Refactor types and remove ModifyPokemon Feb 17, 2016
sockets.js Remove .js extension from requires (#2725) Aug 30, 2016
team-validator.js Only switch to Ash Greninja if we're not already using a custom templ… Jan 17, 2017
tools.js Support passing format name to /learn Dec 7, 2016
users.js Implement /sharedip (#2870) Dec 25, 2016
verifier.js ProcessManager: subclass to extend ProcessManager, unit tests setup (#… Sep 9, 2016


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 6).

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 this isn't possible on certain internet connections).



(Requires Node.js 6+)

Detailed installation instructions

Pokémon Showdown requires you to have Node.js installed, 6.x or later.

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 "Save" icon button near the top right (next to "Download ZIP"), or if you're really lazy, you can use the "Download ZIP" button. I recommend the Save method - it's more time-consuming to set up, but much easier to update.

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.


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



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


  • Chris Monsanto [chaos] - Sysadmin
  • Juanma Serrano [Joim] - Development, 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

Major Contributors

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


  • Andrew Goodsell [Zracknel] - Art (battle weather backdrops)
  • Bär Halberkamp [bumbadadabum] - Development
  • Ben Davies [Morfent] - Development
  • Ben Frengley [TalkTakesTime] - Development
  • Cody Thompson [Rising_Dusk] - Development
  • Ian Clail [Layell] - Art (battle graphics, sprites)
  • Jacob Zimmer [SolarisFox] - Development
  • Jeremy Piemonte [panpawn] - Development
  • Neil Rashbrook [urkerab] - Development
  • Robin Vandenbrande [Quinella] - Development
  • [Ridaz] - Art (battle animations)

Special thanks