The Beginner's Guide to Pokémon Showdown

By Alter.


  1. Introduction and Background
  2. Settings
  3. Commands
  4. Teambuilder
  5. Battling
  6. Community
  7. Rooms
  8. Resources and Links

Introduction and Background

Pokémon Showdown, often formatted as Pokémon Showdown!, is a popular competitive Pokémon simulator. It was created by Zarel and opened in October of 2011, but it was not until July 2, 2012 that it was adopted as Smogon's official battle simulator. Pokémon Showdown is a web-based project available on all major browsers and also has a downloadable client. This means you can play Pokémon Showdown on web browsers such as Google Chrome or download it from the internet and play it straight from your desktop.

Pokémon Showdown was designed to simulate the conditions of WiFi Pokémon games in a more stable environment, which creates a more efficient method in which to be involved in the competitive Pokémon setting. The aim of this guide is to explain to new users to the way in which Pokémon Showdown operates and integrate said users into the community as a whole. This guide may also contain sections which help give understanding to aspects of the program to veterans of the site, as well.


Pokémon Showdown also allows users to customize their settings to their own preference. In order to change those settings, one should navigate their cursor to the top right of the main menu when logged in and hit on the gear button to open up the settings menu.

Currently, it is possible to change one's avatar, change the background, disable animations, and change chat preferences. Most of these options are purely aesthetic, so feel free to alter them to whichever way you prefer. Using commands, it is also possible to change some settings relating to battles. This will be covered more in-depth in the next section.


Within any of the chats it is possible to type in commands (messages beginning with /) in order to perform a particular action. A wide variety of these commands exist, with some only available to certain users. For instance, the /wall command is only available to Drivers (%) and above. Similarly, only users ranked Leaders (&) and above (~, #) are able to promote other users within a room.

These ranks will be explained later in the guide in more depth. For more information, see the "Community" section. The commands listed will be separated into Useful & Commonly Used Commands, Battle Commands, Highlights, Room Commands, and Miscellaneous Commands. A brief description will be provided next to each command, explaining what it does.

Useful & Commonly Used

This is a list of the most commonly used or practical commands that you will use on Pokémon Showdown.

  • /rules - Links to Pokémon Showdown's general rules. This may also show specific room rules of the room you are in.
  • /msg OR /whisper OR /pm OR /w [username], [message] - Send a private message to a user.
  • /rating OR /ranking OR /ladder OR /rank [username] - Get user's rating on all of the ladders they have battled in. Leave [username] blank if you want to view your own rank.
  • /learn [pokemon], [move, move, ...] - Displays how a Pokémon can learn the given moves, if it can at all.
  • /calc - Provides a link to a damage calculator.
  • /dexsearch [type], [move], [move],...
    • Search categories are: type, tier, color, moves, ability, gen.
    • Valid colors are: green, red, blue, white, brown, yellow, purple, pink, gray and black.
    • Valid tiers are: Uber/OU/BL/UU/BL2/RU/BL3/NU/BL4/PU/NFE/LC/CAP/Illegal.
    • Types must be followed by " type", e.g., "dragon type".
  • /data OR /info OR /stats [pokemon/item/move/ability/nature] - Obtain details on this Pokémon/item/move/ability/nature.
  • /dt [pokemon/item/move/ability] - Provides more details than /data. For Pokémon, it includes dex number, generation, height, weight, dex colour, egg group, and evolutions; for items, it includes generation introduced in and Fling Base Power; and for moves, it tells you the priority, generation introducted in, whether it makes contact and/or has a secondary effect, and what Pokemon it targets.
  • /nick [new username] - Change your username to [new username]. If the username is already registered you will be prompted to enter a password.
  • /challenge [username] - opens up the option to send a battle challenge to another online user
  • /help [x] - Gives information on a specific subject. Replace x with a different command, subject, or 'all.'
  • /away - Blocks challenges and PMs. Cannot block from staff.
  • /back - Unlocks challenges and PMs. (opposite of /away)
  • /blockpm OR /blockpms - Blocks other users from PMing you. Cannot block messages from staff.
  • /unblockpm OR /unblockpms - Unblocks other users from PMing you.
  • /blockchallenges OR /bch - Blocks other users from challenging you.
  • /unblockchallenges - Unblocks other users from challenging you.
  • /ignore [username] - negates messages from and ignores another online user. Note that you cannot ignore PMs from global staff members.
  • /unignore [username] - Opposite of /ignore [username].
  • /formatshelp - Brings up a list of Smogon Tiers, Tiering FAQ, and the banlists for each tier.
  • /formatshelp [format] - Brings up a list of all links related to a specific format.


These commands are useful in battle rooms. When you are battling, you are temporarily given a rank called Player (★). These commands can only be used by Players and any global staff members who join the battle room.

  • /timer on - Turns the battle timer on.
  • /timer off - Turns the battle timer off.
  • /roomvoice [username] - Makes user a room Voice.
  • /roomdevoice [username] - Removes someone's room Voice.
  • /modchat + - Makes it so only room Voices and Players can talk.
  • /modchat ac - Makes it so only autoconfirmed users, which are users who have won one rated battle and have been registered for a week, can talk.
  • /modchat off - Turns off any modchat.
  • /modjoin - Makes the room hidden and adds /modchat +
  • /hiddenroom on - Hides the room so other users can't join unless they have a link to the battle.
  • /hiddenroom off - Makes the room public again.
  • /savereplay - Saves a replay of the battle so you can share it with others!


If you've spent any time in the Lobby, you may notice users refer to a concept of 'highlights.' In a nutshell, highlights are words that trigger a message to appear at the corner of your screen, akin to private message alerts. You may choose to highlight on specific words such as your name so that you know when people are directing discussion, questions, or answers towards you specifically.

  • /highlight add, word - add a new word to the highlight list.
  • /highlight list - list all words that currently highlight you.
  • /highlight delete, word - delete a word from the highlight list.
  • /highlight delete - clear the highlight list.


The commands listed below are all relevant to the rooms. This topic is discussed more in-depth in the Rooms subsection.

  • /rooms [username] - Show what rooms a user is in. Omit [username] to see your own rooms.
  • /roomauth [room] - Shows the particular staff for a room in a pop-up. Without [room] it shows you the roomauth of the room you used the command in.
  • /roomhelp - Gives information on all commands that a staff member in a room can use.
  • /roomintro - Shows the room intro of the room you are in, which usually has helpful links and relevant information pertaining to the room.
  • /roomdesc - Shows the general description of the room you are in.


This is a list of the rest of the commands which aren't as commonly used or don't fit under any other specific categories. Here you will find commands you may have never even heard of, such as /faq doubles or /opensource!

  • /reply OR /r [message] - Send a private message to the last person you received a message from, or sent a message to.
  • /ip - Get your own IP address.
  • /avatar [new avatar number] - Change your trainer sprite.
  • /whois [username] - Get details on a username: group, and rooms.
  • /effectiveness [type1], [type2] - Provides the effectiveness of a [type1] attack to a [type2] Pokémon.
  • /user [username] - opens up a small tab which gives you the option to challenge, PM, and check the rooms / rank of another online user
  • /analysis [pokemon], [generation] - Links to the Smogon University analysis for this Pokémon in the given generation.
  • /smogdex [pokemon], [generation] - Same as above.
  • /groups - Explains what the + % @ & ~ next to people's names mean. (This is also covered later in the guide)
  • /opensource OR /git - Links to PS's source code repository.
  • /avatars OR /avatar - Explains how to change avatars.
  • /intro - Provides an introduction to competitive Pokémon.
  • /cap - Provides an introduction to the Create-A-Pokémon project.
  • /om OR /othermetas - Provides links to information on the Other Metagames.
  • /weakness [pokemon/type] - Returns the type weaknesses for a specific Pokémon or type.
  • /faq [theme] - Provides a link to the FAQ. Add deviation, doubles, randomcap, restart, or staff for a link to these questions. Add all for all of them.
  • /clear - Clears the chat that you're currently in of all text
  • /restarthelp - Gives information regarding server restarts
  • /om month - Links to explanation of the Other Metagame of the month.
  • /userauth [username] - See what rank a user has in all public rooms.
  • /uptime - Tells you how long the server has been up.
  • /staff - Links to a list of global staff members.
    • /auth - Same as /staff, but instead of a link it gives you a pop-up list of all global staff members.
  • /timestamps [all/lobby/pms], [minutes/seconds/off] - Sets your timestamps preferences.
    • all - Changes all timestamp preferences.
    • lobby - Changes only lobby timestamp preferences.
    • pms - Changes only PM preferences.
    • off - Sets timestamps off.
    • minutes - Shows timestamps in the form of [hh:mm].
    • seconds - Shows timestamps in the form of [hh:mm:ss].


The teambuilder is a large part of Pokémon Showdown and enables users to create their own teams from scratch, important other people's teams, or edit any of their currently existing ones. Some formats on the simulator will not require you to create a team and let you jump straight into battle. An example of this is the very popular 'Random Battle' mode, or as it is commonly referred to, 'Randbats' for short.

Other tiers and formats, such as OU, Ubers, RU, and NU will require the user to create a team that coincides for the rules of that tier. If you'd like a listing of what you can and can't use for each tier, click here. If you intend to create a team for playing the Sixth Generation, there are different rulesets for each tier, which are also listed on the same page. In order to create a team, click on the 'Teambuilder' button in the main menu.

Building a team is fairly self-explanatory with the teambuilder guiding you along each stage of the process. You can select a Pokémon's Item, Ability, Moves, Stats, and other details such as its Level (from 1 to 100), its Gender (None, Random, Male, or Female), Happiness, and whether or not it is Shiny. Keep in mind that some sets may require a Pokémon to have particular attributes. For example, Entei can only obtain the moves Flare Blitz, Extreme Speed, Crush Claw, or Howl from a specific event which dictates that it must have an Adamant nature and be Shiny. If you attempt to enter a battle with an moveset which doesn't abide by these rules, you will be prompted to alter it before you battle.

Other features of the Teambuilder include the ability to rearrange the team slots (the "Move" button on the top right of the above image), delete existing Pokémon or teams, or import/export text versions of the team so that you can share your team with friends or the community.


Organising a battle on Pokémon Showdown is a very easy task to do. One can either opt to play in a ladder game (in which you receive a random opponent), or to challenge a specific user. To play in a ladder game, select your format and team in the top left hand corner using the drop-down boxes. If your team is accepted and deemed legal by the server for that specific format, you will be put in a queue amongst other players to join a match. The server matches you with people with the closest rank to you ideally, but expands the parameters as time progresses.

Alternatively, you can type /challenge username into chat or click on a person's name to challenge them manually. However, these types of games will not change your ranking on the ladder. From the point of two players entering a game, you'll either be thrown straight into a battle or into the Team Preview. Team Preview occurs in the majority of formats, in which case you will be given time to choose your leading Pokémon based on your opponent's team. After you've made your choice, the battle will begin almost identically to in the actual games themselves.

The process of choosing your moves and switching Pokémon is quite straightforward altogether. If you wish to Mega Evolve a Pokémon, click the checkbox located next to the moves and the Pokémon will then turn into the respective Mega forme. If you're interested in improving your battling skills or learning more about a particular metagame, the Battling 101 section of Smogon can aid newer players. To learn more about this program, click the the link provided.


Pokémon Showdown itself is coupled with a unique and vast community which ranges from each room on the simulator as well as its forums. If you're frequently in the Lobby, you will notice regular users who discuss a range of subjects in the chat. Because of this, if one has any questions, asking them in this Lobby chat might not be the ideal way of getting a response; for this reason, if your question isn't particularly complicated, feel free to join the Help room and ask it there. In the case that you believe your question is too difficult to answer accurately through the common knowledge of others, asking said question on the Pokémon Showdown forums is also an option. Alternatively, one can also post the question in its respective Simple Questions / Simple Answers (SQSA) thread.

One of the most common questions I see on Pokémon Showdown would be, "How do you get that plus sign?", or "How do you become a mod?". These different symbols (+, %, @, &, and ~) all denote a particular level amongst staff or that the user is a "Voice."

It is no mystery that people are interested in contributing to the site or gaining status and this can be done in a range of different ways. Primarily, one can potentially be promoted through user ranks for chat contributions. This essentially means being a good influence in chat by leading strong and intelligent discussion, answering questions of other users, and not breaking the rules. One can also gain the Voice status by being a well-known and distinguished member of the community, completing the (discontinued) Voice challenges, or contributing to the simulator itself.

Being voiced marks you as a particularly good user, granting you a position at the top of the userlist, the ability to speak in moderated chat, and shows that you are a respected member to other users. Asking for status will not aid your cause and is most likely to set you back. In a similar vein, sucking up to staff is not beneficial and is not encouraged at all.

The staff members of Pokémon Showdown have a particular set of roles. Above all else, these users will enforce the rules of Pokémon Showdown if they are breached. Exceptions exist for those that are given staff membership for programming abilities or are more focussed on Smogon Policy. It is recommended that users don't direct questions towards staff, especially Administrators, if they are answerable by regular users.

According to the Staff FAQ, below is a list of ways one can be promoted. Take note that just because you fulfill these requirements doesn't mean you will instantly become ranked and that these requirements exist to set a standard, and help users understand what they can do to contribute to the site. Following these points will not ensure that you're added to staff; indeed, they are merely guidelines which can help you understand how you can join staff.

  • Be on Pokémon Showdown regularly and contribute regularly to the chat. Being a staff member requires both a high level of activity and quality. Being on the chat regularly gives a good indication of your intelligence and will ensure, with good behaviour, that you earn respect from other users.
  • Do not flame, be argumentative, or be a poor user in general. You obviously won't be given any power if you insult other users, break rules, or otherwise make more work for the staff. As well as the above, sycophancy is not beneficial and will not aid your cause.
  • Know what you're talking about when answering questions or having discussions. Although you don't need to be a great battler by any means to be a staff member, it does help if you know the metagame, so as to make it easier for you to help others.
  • Show that you are mature and level-headed enough to have the privilege of power, and the responsibilities that come with it.
  • Moderators have the power of banning users for long periods of time, and to earn this power, you must show that you are level-headed enough to only use this and other Moderator powers when absolutely required.
  • Most importantly, gain the respect of the users and staff members. You will only be considered for a staff position when you have the respect of all of the Pokémon Showdown staff and users.


While the main room used on Pokémon Showdown is the Lobby, a variety of different rooms exist for different purposes. These rooms can range from different language rooms, rooms for people with particular hobbies or those dedicated to a particular playable format. Rooms can either be official, public (which means they're listed under "chat rooms") or they can be private.

There are three official public rooms, and they are Lobby, Tournaments, and Help. Lobby is where most discussion and activity resides, Tournaments is a room that hosts scripted challenges constantly, and Help is the room to go to if you have any questions. Examples of public rooms include the Wi-Fi and Spanish (Español) rooms, which anyone may join provided they are not room banned. Private rooms are undisclosed to the public are generally for private communities or staff areas.

Resources and Links

  • Pokémon Showdown is Smogon's official competitive simulator and is the basis of this guide.
    • Pokémon Showdown Forums are the forums section of Pokémon Showdown. One may report bugs, suggest ideas, or appeal bans here. There are several important threads here as well, such as How to Contact Senior Staff, suggestions, and bug reports, as well as threads that advertise contests happening in different rooms across Pokémon Showdown.
  • The Rules outline what are punishable offences on Pokémon Showdown.
  • Replays contains all uploaded videos of Pokémon Showdown battles which have been saved to the server. One can search for specific battles here.
  • News contains an archive of the Pokémon Showdown news bulletins that have been published on the server.
  • Antar's Guide to the PS Ladder Mechanics is a guide to Pokémon Showdown's conventional rating systems.
  • The Guide to the PS Mystery Ratings is a guide to Pokémon Showdown's suspect testing requirements rating system, written by their creator, Antar.
  • Elo Hell-o: Rating Systems on Showdown and You is a guide written by scalarmotion that explains the rating systems used on Pokémon Showdown.
  • #showdown is the official IRC channel.