- For the main page about Pokémon, see Pokémon.
- For defining the differences between a species' multiple forms, see Multiple 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:
X is a property and
Y is the value or values associated with it. For example:
 Name=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
Some pieces of information must be defined for every species, while other pieces of information are optional and can be excluded if they don't apply. The order of the lines does not matter, except for the ID line which must be first.
|[ID]|| This line must come first in a section, because, as mentioned above, this line is defined as one which begins a new section. 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 or equal to 1 (it cannot be 0). While you can skip numbers, minor bugs can occur if you do so, so it is recommended that you don't. The order in which species are numbered is not important; however, keeping them in order will make it easier to spot gaps or mistakes.
This ID number is the default National Pokédex number of the species. If there are no Regional Pokédex lists defined, or if viewing the default Pokédex list in the Pokédex, that list will contain all the defined Pokémon species sorted by this number.
|Name||The name of the species, as seen by the player.|
|InternalName||This is how the scripts refer to the species. Typically this is the species name, but written in all capital letters and with no spaces or symbols. The internal name is never seen by the player.|
| The internal name(s) of the species' primary and secondary elemental types.
|BaseStats|| Six comma-separated values, corresponding to:
Each value can be between 0 and 255.
|GenderRate|| The likelihood of a Pokémon of the species being a certain gender. Must be one of the following words:
|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 words:
|BaseEXP|| The base amount of Experience gained from defeating a Pokémon of this species. It must be a whole number between 0 and 65535.
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 numbers, corresponding to:
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. Is a number between 0 and 255. The higher the number, the more likely a capture (0 means it cannot be caught by anything except a Master Ball).|
|Happiness||The amount of happiness a newly caught Pokémon of the species will have. Is a number between 0 and 255, although it is typically 70.|
|Moves|| The moves that all Pokémon of the species learn as they level up. There are two (comma-separated) parts to each move:
These couplets are also comma-separated in this line.
|Compatibility|| The egg groups that the species belongs to. Is either one or two (comma-separated) of the following words:
"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 either egg group is "Undiscovered", the species cannot breed.
|StepsToHatch||The number of steps it takes to hatch an egg of the species. Note that this is not the number of egg cycles for the species, but the actual number of steps.|
|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 metres 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 colour of the species. Must be one of the colours defined in the script section PBColors, which by default are:
|Kind||The species' kind, 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.|
|Abilities||The internal name(s) of one or two abilities that the species can have. If there are two abilities, separate them with a comma.|
|HiddenAbility|| The internal names of up to four additional abilities that the species can have. Each ability is separated with commas from the other ones.
Pokémon cannot have any hidden ability naturally, and must be specially given one.
|EggMoves||A comma-separated list of the internal names 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).|
|Habitat|| The kind of location that the species can typically be found in. Is one of the following words:
"Rare" can be taken to mean "unknown" here.
This information is unused in Pokémon Essentials.
|RegionalNumbers||One or more comma-separated numbers. Each number is the Pokédex number of the species in the corresponding Regional Pokédex. A number of 0 means that the species does not appear in that Regional Pokédex.|
| The internal names of items that a wild Pokémon of the species may be found holding. Each line can only list 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.
|BattlerPlayerY||Affects the positioning of the back sprite of the species in battle. A higher number means the back sprite is placed lower down the screen. This number can be positive or negative, and is 0 by default.|
|BattlerEnemyY||Affects the positioning of the front sprite of the species in battle. A higher number means the front sprite is placed lower down the screen. This number can be positive or negative, and is 0 by default.|
|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, and is 0 by default.
If this value is greater than 0, the Pokémon's shadow is shown in battle, thus giving it the impression of being airborne. Pokémon without shadows are assumed to be grounded.
|Evolutions|| The evolution paths this species can take. For each possible evolution of this species, there are three parts:
See the page Evolution for more details.
|FormNames|| The names of each form of the species, separated by commas. These names also determine how many forms can be viewed in the Pokédex's Forms page; unnamed forms can still be coded and used, but they will not be viewable in the Pokédex even if encountered.
If the first name is blank, then its form name as shown in the Pokédex's Forms page will be "Male"/"Female" if the species is gendered, or "One form" if genderless.
|Incense|| The internal name of an item that needs to be held by a parent when breeding in order for the egg to be the 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 evolve into a species which can. That is, the species should be a "baby" species. Not all baby species need this line.
Graphics and audio
A Pokémon species has one of each of the following:
- A 128x64 pixel two-frame icon, used mainly in the party screen and Pokémon storage screen
- Four battle sprites, used in a variety of places in-game:
- Front normal
- Rear normal
- Front shiny
- Rear shiny
- A 32x32 graphic depicting its footprint, for use in the Pokédex
- An audio file depicting its cry, played in various places
The icon is composed of two 64x64 pictures side by side, and is animated automatically in the party screen (it is not animated in the Pokémon storage screen). It is placed in the folder "Graphics/Icons", with the name "
iconXXX.png", where "
XXX" is either the internal name of that species or its ID number padded to 3 digits (e.g. Bulbasaur is "
001", Pikachu is "
025", Mewtwo is "
The battle sprites can be any size, and are placed in the folder "Graphics/Battlers" with the following names (the "
XXX" is as above):
XXX.png- Front normal
XXXb.png- Rear normal
XXXs.png- Front shiny
XXXsb.png- Rear shiny
The footprint graphic is placed in the folder "Graphics/Icons/Footprints" with the name "
The cry file is placed in the folder "Audio/SE/Cries" with the name "
cryXXX", and can be of any supported audio type.
If a Pokémon species has more than one form (including having male/female versions or Mega Evolutions), then it will need additional graphics and possibly additional cries to depict them. The scripts may also need to be modified depending on how different the extra forms are to the original (e.g. if one has a different type/ability to another).