Creating Items
Items are defined inPBS/items.txt. This includes everything from Potions and Poké Balls to evolution stones, TMs, and held items.
Item Entry Structure
Each item is defined on a single line with comma-separated values:Real Examples
Basic Item
Evolution Stone
Potion
Poké Ball
TM (Technical Machine)
Field Definitions
Unique identifier for the item. Must be sequential starting from 1.
Internal code name in uppercase. Used in scripts and PBS files.Example:
POTION, FIRESTONE, POKEBALLSingular display name shown to players.
Plural form of the item name.Example:
Pociones, Piedras Fuego, Poké BallsWhich bag pocket the item goes in:
1- Items (general items, stones, held items)2- Medicine (Potions, status healers)3- Poké Balls4- TMs & HMs5- Berries6- Mail7- Battle items8- Key items
Buy price at Poké Marts. Sell price is half. Use
0 for items that can’t be bought.Item description shown in bag. Enclosed in quotes.
How the item can be used outside of battle:
0- Cannot be used1- Use on Pokémon (most items)2- Use directly (Repels, Escape Rope)3- TMs/HMs (can be taught)
How the item can be used in battle:
0- Cannot be used in battle1- Use on Pokémon (Potions, status healers)2- Use on throw (Poké Balls)3- Direct use4- On enemy Pokémon
Special flags for the item:
0- No special flags1- Consumable (disappears after use)2- Can be held by Pokémon4- Can be registered to quick access
For TMs/HMs only: the internal name of the move taught.Example:
HONECLAWS, THUNDERBOLT, SURFItem Categories
Medicine Items
Evolution Stones
Poké Balls
Held Items
TMs (Technical Machines)
Stat-Enhancing Items
Type-Boosting Held Items
Creating a New Item
FieldUse: 0 (none), 1 (on Pokémon), 2 (direct), 3 (TM)BattleUse: 0 (none), 1 (on Pokémon), 2 (ball), 3 (direct), 4 (on enemy)Valuables and Sellable Items
Items that exist primarily to be sold:Fossils
Fossil revival mechanics need to be implemented in events or scripts. The fossils themselves are just items until you create a system to revive them.
Battle Items
Items used during battle for strategic advantage:Berries
Berries are special items that typically go in pocket 5:Berry mechanics (growing, harvesting) are typically implemented through map events and scripts, not just the PBS files.
Mega Stones and Special Items
Key Items
Key items are plot-important and cannot be sold or discarded:Item Icons
Each item needs a corresponding icon graphic inGraphics/Items/. The filename should match the internal name:
Testing Items
Next Steps
- Creating Pokémon - Define Pokémon that can hold items
- Creating Moves - TMs teach moves
- Creating Trainers - Give items to trainers