Skip to main content
The pokemon.txt file defines all Pokémon species in the game, including their stats, types, abilities, moves, and other characteristics.

​
File Format

Each Pokémon is defined using a section header with its National Pokédex number, followed by field definitions: 
[1]
Name=Bulbasaur
InternalName=BULBASAUR
Type1=GRASS
Type2=POISON
BaseStats=45,49,49,45,65,65

​
Required Fields

​
[Number]
Integer
The Pokémon’s National Pokédex number in square brackets. This starts each Pokémon definition.
[1]  # Bulbasaur
[25] # Pikachu
​
Name
String
The display name of the Pokémon as shown to players.
Name=Bulbasaur
Name=Pikachu
​
InternalName
String
The internal identifier used in code. Must be UPPERCASE and unique.
InternalName=BULBASAUR
InternalName=PIKACHU
​
Type1
Type
The Pokémon’s primary type. See type list below.
Type1=GRASS
Type1=ELECTRIC
​
BaseStats
Stats Array
Six comma-separated values: HP, Attack, Defense, Speed, Sp.Atk, Sp.Def
BaseStats=45,49,49,45,65,65  # Bulbasaur
BaseStats=35,55,40,90,50,50  # Pikachu
​
GenderRate
Gender Rate
Determines male/female ratio. Valid values:
  • AlwaysMale - 100% male
  • AlwaysFemale - 100% female
  • Genderless - No gender
  • FemaleOneEighth - 12.5% female
  • Female25Percent - 25% female
  • Female50Percent - 50% female
  • Female75Percent - 75% female
GenderRate=FemaleOneEighth  # Starters
GenderRate=Female50Percent  # Most Pokémon
​
GrowthRate
Growth Rate
Experience growth rate. Valid values:
  • Fast - 800,000 exp to level 100
  • Medium - 1,000,000 exp
  • Slow - 1,250,000 exp
  • Parabolic - 1,059,860 exp
  • Erratic - 600,000 exp
  • Fluctuating - 1,640,000 exp
GrowthRate=Parabolic  # Starters
GrowthRate=Medium     # Common
​
BaseEXP
Integer
Base experience yield when defeated.
BaseEXP=64   # Bulbasaur
BaseEXP=105  # Pikachu
​
EffortPoints
EV Array
Six comma-separated effort values awarded: HP, Atk, Def, Speed, SpAtk, SpDef
EffortPoints=0,0,0,0,1,0  # +1 Sp.Atk
EffortPoints=0,0,0,2,0,0  # +2 Speed
​
Rareness
Integer
default:"255"
Catch rate. Lower = harder to catch (0-255).
Rareness=45   # Starters (hard)
Rareness=255  # Common (easy)
​
Happiness
Integer
default:"70"
Base friendship value (0-255).
Happiness=70   # Standard
Happiness=140  # Clefairy (friendly)
​
Abilities
Ability List
Comma-separated list of abilities (up to 2 regular abilities).
Abilities=OVERGROW                    # Single ability
Abilities=KEENEYE,TANGLEDFEET        # Two abilities
​
Compatibility
Egg Group List
Comma-separated egg groups for breeding.
Compatibility=Monster,Grass
Compatibility=Field,Fairy
​
StepsToHatch
Integer
Egg cycles × 255. Typical values: 2805, 4080, 5355, 6630, 8905, 10200, 20480, 30720.
StepsToHatch=5355  # Standard
StepsToHatch=2805  # Fast hatching
​
Height
Float
Height in meters.
Height=0.7  # Bulbasaur (0.7m)
Height=0.4  # Pikachu (0.4m)
​
Weight
Float
Weight in kilograms.
Weight=6.9   # Bulbasaur
Weight=6.0   # Pikachu
​
Color
Color
Pokédex color. Valid: Red, Blue, Yellow, Green, Black, Brown, Purple, Gray, White, Pink
Color=Green
Color=Yellow

​
Optional Fields

​
Type2
Type
Secondary type. Omit for single-type Pokémon.
Type2=POISON   # Bulbasaur is Grass/Poison
Type2=FLYING   # Charizard is Fire/Flying
​
HiddenAbility
Ability
Hidden ability (Dream World ability).
HiddenAbility=CHLOROPHYLL
HiddenAbility=LIGHTNINGROD
​
Moves
Move List
Comma-separated: Level,MOVE,Level,MOVE,...Use 0 for moves known upon evolution, 1 for starting moves.
Moves=1,TACKLE,3,GROWL,7,LEECHSEED,9,VINEWHIP,13,POISONPOWDER
Moves=0,PETALBLIZZARD,1,TACKLE,1,GROWL,7,LEECHSEED
​
EggMoves
Move List
Comma-separated list of egg moves.
EggMoves=AMNESIA,CHARM,CURSE,ENDURE,GIGADRAIN,GRASSWHISTLE
​
Evolutions
Evolution Data
Evolution method and parameters. Format: SPECIES,Method,ParameterCommon methods:
  • Level,X - Level up to X
  • Item,ITEMNAME - Use evolution stone
  • Happiness - Friendship evolution
  • HappinessDay - Friendship during day
  • HappinessNight - Friendship during night
  • Trade - Trade evolution
  • TradeItem,ITEMNAME - Trade holding item
  • HasMove,MOVENAME - Level up knowing move
  • LevelForm0,X - Level X (form 0)
  • ItemForm1,ITEMNAME - Use item (form 1)
Evolutions=IVYSAUR,Level,16
Evolutions=RAICHU,Item,THUNDERSTONE
Evolutions=ESPEON,HappinessDay,
Evolutions=CROBAT,Happiness,
Evolutions=ANNIHILAPE,HasMove,RAGEFIST
Leave empty if no evolution:
Evolutions=
​
Habitat
Habitat
Natural habitat. Valid: Cave, Forest, Grassland, Mountain, RoughTerrain, Sea, Urban, WatersEdge
Habitat=Grassland
Habitat=Forest
​
RegionalNumbers
Number List
Comma-separated regional Pokédex numbers.
RegionalNumbers=1,0      # Kanto #1
RegionalNumbers=26,0     # Kanto #26
​
Kind
String
Species category (e.g., “Seed Pokémon”).
Kind=Semilla      # Seed
Kind=Ratón        # Mouse
​
Pokedex
String
Pokédex entry text.
Pokedex=A Bulbasaur es fácil verle echándose una siesta al sol.
​
FormNames
Form List
Comma-separated form names. First entry is base form (can be empty).
FormNames=,Mega Venusaur           # Base + Mega
FormNames=Forma Normal,Forma Alola # Regional forms
FormNames=,Mega Charizard X,Mega Charizard Y  # Multiple megas
​
BattlerPlayerY
Integer
default:"0"
Vertical offset for player-side sprite positioning.
BattlerPlayerY=24  # Higher on screen
BattlerPlayerY=0   # Default position
​
BattlerEnemyY
Integer
default:"0"
Vertical offset for enemy-side sprite positioning.
BattlerEnemyY=32
BattlerEnemyY=8
​
BattlerAltitude
Integer
default:"0"
Height above ground for flying/levitating Pokémon.
BattlerAltitude=0   # Ground
BattlerAltitude=15  # Flying high
​
WildItemCommon
Item
Item commonly held by wild Pokémon (50% chance).
WildItemCommon=ORANBERRY
WildItemCommon=RAWSTBERRY
​
WildItemUncommon
Item
Item uncommonly held (5% chance).
WildItemUncommon=SITRUSBERRY
WildItemUncommon=LIGHTBALL  # Pikachu
​
WildItemRare
Item
Item rarely held (1% chance).
WildItemRare=LIGHTBALL
WildItemRare=COMETSHARD

​
Type List

Valid type values:
  • NORMAL, FIRE, WATER, ELECTRIC, GRASS, ICE
  • FIGHTING, POISON, GROUND, FLYING, PSYCHIC
  • BUG, ROCK, GHOST, DRAGON, DARK, STEEL, FAIRY

​
Egg Group List

Valid egg groups:
  • Monster, Water1, Water2, Water3
  • Bug, Flying, Field, Fairy
  • Grass, HumanLike, Mineral, Amorphous
  • Dragon, Ditto, Undiscovered

​
Complete Example

[1]
Name=Bulbasaur
InternalName=BULBASAUR
Type1=GRASS
Type2=POISON
BaseStats=45,49,49,45,65,65
GenderRate=FemaleOneEighth
GrowthRate=Parabolic
BaseEXP=64
EffortPoints=0,0,0,0,1,0
Rareness=45
Happiness=70
Abilities=OVERGROW
HiddenAbility=CHLOROPHYLL
Moves=1,TACKLE,3,GROWL,7,LEECHSEED,9,VINEWHIP,13,POISONPOWDER,13,SLEEPPOWDER,15,TAKEDOWN
EggMoves=AMNESIA,CHARM,CURSE,ENDURE,GIGADRAIN,GRASSWHISTLE
Compatibility=Monster,Grass
StepsToHatch=5355
Height=0.7
Weight=6.9
Color=Green
Habitat=Grassland
RegionalNumbers=1,0
Kind=Semilla
Pokedex=A Bulbasaur es fácil verle echándose una siesta al sol.
BattlerPlayerY=24
BattlerEnemyY=32
BattlerAltitude=0
Evolutions=IVYSAUR,Level,16
Terastal Forms: To add a Terastal type, append the type after the ball parameter in trainer Pokémon definitions (see trainers.txt documentation).
Regional forms use FormNames and form-specific evolution methods:
[52]
Name=Meowth
InternalName=MEOWTH
Type1=NORMAL
BaseStats=40,45,35,90,40,40
# ... other fields ...
FormNames=Forma Normal,Forma Alola,Forma Galar
Evolutions=PERSIAN,LevelForm0,28,PERSIAN,HappinessForm1,,PERRSERKER,LevelForm2,28
  • Form 0 = Normal Meowth → Persian at level 28
  • Form 1 = Alola Meowth → Persian via Happiness
  • Form 2 = Galar Meowth → Perrserker at level 28
[6]
Name=Charizard
InternalName=CHARIZARD
Type1=FIRE
Type2=FLYING
BaseStats=78,84,78,100,109,85
# ... other fields ...
FormNames=,Mega Charizard X,Mega Charizard Y
Mega Evolutions are triggered during battle via Mega Stone items.

Build docs developers (and LLMs) love

Get started for freeTalk to us