- For the main page about Pokémon, see Pokémon.
- For defining the differences between a species' multiple forms, see Forms.
This page describes how to define a Pokémon species.
Defining a species
A Pokémon species begins with its definition. This means that it is listed in the PBS file "pokemon.txt", so that it can be recognised by the game as a species.
Note that this only defines the basic properties common to all individual Pokémon of that species (e.g. base stats, move sets, evolution paths, etc.).
In addition to this, a species will require a number of graphics files depicting that species in different ways, as well as an audio file which plays its cry. See below for more information.
PBS file "pokemon.txt"
The PBS file "pokemon.txt" lists all the defined Pokémon species in the game. Each section in this file is one separate species, where a section begins with a line containing an ID number in square brackets and ends when the next section begins. Each line in a section is one separate piece of information about that species.
Aside from the ID line, every line in a section follows the format:
XXX = YYY
XXX is a property and
YYY is the value or values associated with it (the spaces are optional). For example:
 Name = Bulbasaur InternalName = BULBASAUR Type1 = GRASS Type2 = POISON BaseStats = 45,49,49,45,65,65 GenderRate = FemaleOneEighth BaseEXP = 64 Moves = 1,TACKLE,3,GROWL,7,LEECHSEED,9,VINEWHIP,13,POISONPOWDER,13,SLEEPPOWDER,15,TAKEDOWN,19,RAZORLEAF,21,SWEETSCENT,25,GROWTH,27,DOUBLEEDGE,31,WORRYSEED,33,SYNTHESIS,37,SEEDBOMB Height = 0.7 Pokedex = Bulbasaur can be seen napping in bright sunlight. There is a seed on its back. By soaking up the sun's rays, the seed grows progressively larger. Evolutions = IVYSAUR,Level,16
The only required lines of information are the
Name and the
InternalName. All other pieces of information are optional, but most of them will have default values if they are not defined. The order of the lines does not matter, except for the ID number line in square brackets which must be first.
|[ID number]||This line must come first in a section, because, as mentioned above, this line defines when a new section begins. This line contains a number inside square brackets, e.g.
This number must be different for each species. It must be a whole number greater than 0. You cannot skip numbers. The ID number is used as the National Pokédex number, and also affects the order in which species are listed in some Debug mode features.
|Name||The name of the species, as seen by the player.||This line is required|
|InternalName||This must be different for each species. Also known as the ID, this is how the scripts refer to the species. Typically this is the same as the species name, but written in all capital letters and with no spaces or symbols. In the scripts, the ID is used as a symbol (i.e. with a colon in front of it, e.g. :BULBASAUR). The ID is never seen by the player.||This line is required|
|The ID of the primary and secondary elemental types of the species.||NORMAL (for Type1)|
|BaseStats||Six comma-separated values, corresponding to the order that main stats are defined. By default, the order is:
Each value can be 1 or higher.
|GenderRate||The likelihood of a Pokémon of the species being a certain gender. Must be one of the following:
|GrowthRate||The rate at which a Pokémon of the species gains levels (i.e. how much Experience is needed to level up). Must be one of the following:
|BaseEXP||The base amount of Experience gained from defeating a Pokémon of the species. It must be a whole number that is 1 or higher.
This base amount is used in a calculation to determine the actual number of Exp. points awarded for defeating a Pokémon of the species.
|EffortPoints||The number of EVs gained by defeating a Pokémon of the species. Is six comma-separated values, corresponding to the order that main stats are defined. By default, the order is:
Each value can be 0 or higher. As a rule, the total of these numbers should be between 1 and 3, and higher evolutions tend to give more EVs.
|Rareness||The catch rate of the species. It can be 0 or higher (typically the highest is 255). The higher the number, the more likely a capture (0 means it cannot be caught by anything except a Master Ball).||255|
|Happiness||The amount of happiness a newly caught Pokémon of the species will have. It can be 0 or higher, although it is typically 70. The game treats 255 as the highest attainable happiness.||70|
|Abilities||The IDs of one or two abilities that the species can have. If there are two abilities, separate them with a comma.||none|
|HiddenAbility||The IDs of any number of additional abilities that the species can have. If there are multiple abilities here, they are separated by commas.
Pokémon cannot have any Hidden Ability naturally, and must be specially given one.
|Moves||The moves that all Pokémon of the species learn as they level up. This line consists of comma-separated level/move pairs which are themselves comma-separated, i.e.
A level of 0 means the move will be learned when a Pokémon evolves into the species, and not at any other point (except via the Move Relearner).
|TutorMoves||A comma-separated list of the IDs of moves that a Pokémon of the species can be taught by a HM, TM, TR or Move Tutor. If a move is not listed here, it cannot be taught by those methods, even if the move appears in its Moves or EggMoves properties.||none|
|EggMoves||A comma-separated list of the IDs of moves that a Pokémon of the species can only learn as an egg (obtained through breeding). Only species that can be in eggs should have this line (typically only unevolved species).||none|
|Compatibility||The egg group(s) that the species belongs to. If there are multiple egg groups here, they are separated by commas. The default available egg group are:
"Water1" is for sea creatures, "Water2" is for fish, and "Water3" is for shellfish. "Ditto" should contain only Ditto, as a species in that group can breed with any other breedable Pokémon. If any egg group is "Undiscovered", the species cannot breed.
|StepsToHatch||The number of steps it takes to hatch an egg of the species. It can be 1 or higher. Note that this is not the number of egg cycles for the species, but the actual number of steps. Only species that can be in eggs should have this line (typically only unevolved species).||1|
|Height||The height of the species in meters, to one decimal place. Use a period for the decimal point, and do not use commas for thousands.
The Pokédex will automatically show this height in feet/inches if the game recognises that the player is in the USA. This is only cosmetic; the rest of the scripts still perform calculations using the meters value defined.
|Weight||The weight of the species in kilograms, to one decimal place. Use a period for the decimal point, and do not use commas for thousands.
The Pokédex will automatically show this weight in pounds if the game recognises that the player is in the USA. This is only cosmetic; the rest of the scripts still perform calculations using the kilograms value defined.
|Color||The main body color of the species. The default available body colors are:
|Shape||The body shape of the species. The Pokédex can search for Pokémon of particular shapes. The default available body shapes are:
|Habitat||The kind of location that the species can typically be found in. The default available habitats are:
"Rare" can be taken to mean "unknown" here.
This information is unused in Essentials.
|Kind||The species' category, which is displayed in the Pokédex. For example, Bulbasaur is the Seed Pokémon. The word "Pokémon" is automatically added to the end, so only "Seed" needs to be here.||"???"|
|Pokedex||The Pokédex entry.||"???"|
|FormName||The name of this form of the species (form 0), if it has one.
If this is blank, then its form name as shown in the Pokédex's Forms page will be "Male"/"Female" if the species is gendered. If the species is genderless, its form name will instead be "Genderless" (if this is the only form for the species) or "One Form" (if the species also has other forms).
|Generation||A number representing the generation of Pokémon games in which this species first appeared. This information is unused in Essentials.||0|
|The IDs of items that a wild Pokémon of the species may be found holding. Each line can only have one item.
The chances of holding the item are 50%, 5% and 1% respectively. If all three are the same item, then the chance of holding it is 100% instead.
|Affects the positioning of the back sprite of the species in battle. A higher number means the back sprite is placed further right/lower down in the screen. Can be positive or negative.||0|
|Affects the positioning of the front sprite of the species in battle. A higher number means the front sprite is placed further right/lower down in the screen. Can be positive or negative.||0|
|BattlerAltitude||Affects the positioning of the front sprite of the species in battle relative to its base. A higher number means the front sprite is placed further up the screen. Can only be positive or 0.
This property is typically unused because
|BattlerShadowX||Affects the horizontal positioning of the shadow beneath the front sprite of the species in battle. A higher number means the shadow is placed further right on the screen. Can be positive or negative.||0|
|BattlerShadowSize||A number that determines which shadow graphic to place underneath the front sprite of the species in battle. It can be 0 or higher. By default, there are three possible shadow graphics (in the folder "Graphics/Pokemon/Shadow"), ranging from 1 (smallest) to 3 (largest).||2|
|Evolutions||The evolution paths the species can take. For each possible evolution of the species, there are three parts:
If there are multiple evolution paths, they are separated by commas. The three parts of each evolution path are also separated by commas. Be careful to include the correct number of commas when writing an evolution path whose method doesn't use a parameter.
|Incense||The ID of an item that needs to be held by a parent when breeding in order for the egg to be this species. If neither parent is holding the required item, the egg will be the next evolved species instead.
The only species that should have this line are ones which cannot breed, but which evolve into a species that can. That is, the species should be a "baby" species. Not all baby species need this line. Note that Essentials does not have any formal definition of what a "baby" species is.
Graphics and audio
A Pokémon species has one of each of the following:
- Four battle sprites, used in a variety of places in-game (they can be any size):
- Front normal
- Rear normal
- Front shiny
- Rear shiny
- A two-frame icon (each frame is square, with the second frame placed to the right of the first). Used mainly in the party screen (animated) and Pokémon storage screen (not animated).
- A graphic depicting its footprint, for use in the Pokédex,
- An audio file depicting its cry, played in various places,
The battle sprites, icons and footprints all go into corresponding folders in the folder "Graphics/Pokemon". The names of each of these graphics are all the same, and are the ID (internal name) of the species, e.g. "BULBASAUR.png".
A species may have a unique egg sprite. If so, both the sprite and the icon depicting the egg go in the same folder, which is "Graphics/Pokemon/Eggs":
- The egg's sprite will be named as above, e.g. "BULBASAUR.png".
- The egg's icon will have the suffix "_icon", e.g. "BULBASAUR_icon.png".
- If the egg has unique crack graphics (shown when the egg is hatching), it goes in the same folder and has the suffix "_cracks", e.g. "BULBASAUR_cracks.png". If the egg does not have unique crack graphics, it will use the "000_cracks.png" graphic instead.
It is not possible to have different egg graphics for shiny Pokémon.
The shiny versions of the battle sprites and icon are not necessary. If they do not exist, the regular versions will be used instead.
The cry file is placed in the folder "Audio/SE/Cries" with the same name as above (e.g. "BULBASAUR.wav"), and can be of any supported audio type.
Female Pokémon can have different sprites/icons to male Pokémon of the same species. If so, they are placed in the same folders as the male versions of those sprites/icons, but they have the filename suffix "_female", e.g. "BULBASAUR_female.png".
Female Pokémon of a species cannot have different egg sprites/icons, footprint graphics or cries to the males.
If a Pokémon species has more than one form (including having mechanically different male/female versions, and Mega Evolutions), then it will need additional graphics and possibly additional cries to depict them.
Alternate forms are defined in the PBS file "pokemonforms.txt", which is laid out in much the same way as "pokemon.txt".