Tutorials may use diff syntax to show edits:

```diff
 this is some code
-delete red - lines
+add green + lines
```


## Contents

- [Miscellaneous](#miscellaneous)
- [How to add a new…](#how-to-add-a-new)
- [How to edit the…](#how-to-edit-the)
- [Upgrades to existing features](#upgrades-to-existing-features)
- [Removing features](#removing-features)
- [Features from different generations](#features-from-different-generations)
- [To do](#to-do)


## Miscellaneous

- [Tips and tricks](Tips-and-tricks)


## How to add a new…

- [Map and landmark](Add-a-new-map-and-landmark)
- [Tileset (with custom palette)](Add-a-new-tileset)
- [Pokémon species (up to 253)](Add-a-new-Pokémon)
- [Trainer class](Add-a-new-trainer-class)
- [Type (Fairy)](Add-a-new-type)
- [Move (up to 255)](Add-a-new-move)
- [Move effect](Add-a-new-move-effect)
- [Field move effect](Add-a-new-field-move-effect)
- [Item (up to 254, with various effects)](Add-a-new-item)
- [TM or HM (up to 120)](Add-a-new-TM-or-HM)
- [Party menu icon (up to 254)](Add-a-new-party-menu-icon)
- [Overworld sprite](Add-a-new-overworld-sprite)
- [Map object movement behavior](Add-a-new-map-object-movement-behavior)
- [Mart (with new dialog and more items)](Add-a-new-Mart)
- [Music song](Add-a-new-music-song)
- [Pack pocket](Add-a-new-Pack-pocket)
- [Radio channel](Add-a-new-radio-channel)
- [Wild Pokémon slot](Add-a-new-wild-Pokémon-slot)
- [Unown form](Add-a-new-Unown-form)
- [Unown puzzle chamber](Add-a-new-Unown-puzzle-chamber)
- [Fishing rod](Add-a-new-fishing-rod)
- [Battle transition](Add-a-new-battle-transition)


## How to edit the…

- [Town Map](Edit-the-Town-Map)
- [Battle HUD](Edit-the-battle-HUD) (*TODO*)
- [Male and female player colors](Recolor-the-male-and-female-players) (*TODO*)


## Upgrades to existing features

- [Expand tilesets from 192 to 255 tiles](Expand-tilesets-from-192-to-255-tiles)
- [Allow map tiles to appear above sprites (so NPCs can walk behind tiles) with `PRIORITY` colors](Allow-map-tiles-to-appear-above-sprites-\(so-NPCs-can-walk-behind-tiles\)-with-PRIORITY-colors)
- [Allow tiles to have different attributes in different blocks (including X and Y flip)](Allow-tiles-to-have-different-attributes-in-different-blocks-\(including-X-and-Y-flip\))
- [Allow more than 15 `object_event`s per map](Allow-more-than-15-object_events-per-map)
- [Improve the outdoor sprite system](Improve-the-outdoor-sprite-system)
- [Increase Pokémon sprite animation size](Increase-Pokémon-sprite-animation-size)
- [Allow more trainer parties, with individual DVs, stat experience, and nicknames](Allow-more-trainer-parties,-with-individual-DVs,-stat-experience,-and-nicknames)
- [Colored trainer card badges](Colored-trainer-card-badges)
- [Show the tops of leaders' heads on the trainer card](Show-the-tops-of-leaders-heads-on-the-trainer-card)
- [Print text when you lose a trainer battle](Print-text-when-you-lose-a-trainer-battle)
- [Correct grammar for plural trainers like Twins](Correct-grammar-for-plural-trainers-like-Twins)
- [Custom order for the Old Pokédex mode](Custom-order-for-the-Old-Pokédex-mode)
- [Short beeping noise for low HP](Short-beeping-noise-for-low-HP)
- [Remove the artificial save delay](Remove-the-artificial-save-delay)


## Removing features

- [Remove Pokémon sprite animations](Remove-Pokémon-sprite-animations)
- [Remove the 25% failure chance for AI status moves](Remove-the-25%25-failure-chance-for-AI-status-moves)
- [Remove the redundant move grammar table](Remove-the-redundant-move-grammar-table)


## Features from different generations

- [Physical/Special split](Physical-Special-split)
- [Replace stat experience with EVs](Replace-stat-experience-with-EVs)
- [Don't gain experience at level 100](Don't-gain-experience-at-level-100)
- [Erratic and Fluctuating experience growth rates](Erratic-and-Fluctuating-experience-growth-rates)
- [Show move names when you receive a TM or HM](Show-move-names-when-you-receive-a-TM-or-HM)
- [Infinitely reusable TMs](Infinitely-reusable-TMs)
- [Automatically reuse Repel](Automatically-reuse-Repel)
- [Evolution moves](Evolution-moves)
- [Running Shoes](Running-Shoes)
- [Rock Climb](Rock-Climb)
- [Dive](Dive)
- [Automatic battle weather on certain maps](Automatic-battle-weather-on-certain-maps)
- [Puddles that splash when you walk](Puddles-that-splash-when-you-walk)
- [Use G/S SGB palettes for maps](Use-GS-SGB-palettes-for-maps)


## To do

Feel free to contribute one of these!

- Decoration for your room
- Spawn point (for Fly or Teleport)
- Wild data
- Roaming Pokémon
- Animated tiles
- Object facing
- Map event script command
- Move effect script command
- Example map scripts (for common cases like an NPC that gives you an item)
- Scene for an existing map (aka triggers; auto-running event scripts)
- Evolution methods (location, held item, move, [etc](https://gitgud.io/pfero/axyllagame/commit/81914d43eb89195734caee724c0a40d4686a0bab))
- More daily and weekly events
- Third trainer card page for Kanto badges
- Fourth stats page for caught data
- Colored party menu icons (overworld or battle sprite colors)
- Option to show shiny colors in Pokédex
- Implement dynamic overhead+underfoot bridges
- Sideways stairs, with step types for diagonal movement and collisions to trigger it
- Pan the camera for cutscenes by making the player invisible
- Gain experience from catching Pokémon
- Trainer dialog and music change for their last Pokémon
- Items that act like overworld moves
- Safari Game
- Ghost and Silph Scope
- Nuzlocke mode (an in-game enforced [Nuzlocke Challenge](https://bulbapedia.bulbagarden.net/wiki/Nuzlocke_Challenge))
- Useful unused content (`COLL_CURRENT_*`, `HELD_PREVENT_*`, `ENVIRONMENT_5`, `TRADE_GENDER_MALE`, `GROWTH_SLIGHTLY_*`, `SPRITE_UNUSED_GUY`, `PAL_NPC_PINK`, etc)