RESEARCH.md

Games

Gen 1

• constants/
  • battle_constants.asm
    • "battle status" (volatiles)
  • move_constants.asm / move_effect_constants.asm (pointers to "handlers" for moves)
  • pokedex_constants.asm / pokemon_data_constants.asm
  • type_constants.asm
• data/
  • battle/
    • stat_modifiers.asm
    • "special" moves: residual_effects_1.asm, residual_effects_2.asm
  • moves/
    • move data
  • pokemon/
    • species data
    • learnsets
  • types/
    • type_matchups.asm
      • typechart, linear scan to lookup
• engine/battle/
  • move_effects/ - special handlers (like PS statuses / scripts)
  • core.asm
  • decrement_pp.asm
  • effects.asm
• wram.asm
  • macros
  • unmodified stats and mods
  • active move
  • battle data
    • "battle status" (volatiles)

Gen 2

• constants/
  • battle_constants.asm
  • item_constants.asm / item_data_constants.asm
  • move_constants.asm / move_effect_constants.asm
  • pokemon_constants.asm
  • type_constants.asm
• data/
  • battle/
    • Accuracy / Critical Hits / Stat Modifiers / Weather
  • items/
    • attributes
  • moves/
    • move data
    • effects (pointers, priorities)
    • Flail / Magnitude / Present / Metronome / Hidden Power
  • pokemon/
    • species data
    • learnset level up / egg
  • types/
    • type_matchups.asm
    • type_boost_items.asm
• engine/battle/
  • move_effects/ - handlers
  • core.asm
  • effect_commands.asm
  • /home/battle_vars.asm
• wram.asm
  • battle data, macros
• random (Random, BattleRandom)

Gen 3

• include/
  • battle (util / scripts / main)
  • random
  • pokemon
  • item
• include/constants/
  • abilities
  • species
  • types / nature
  • moves / move effects
  • held item effects
  • battle / misc
• src/data/
  • species data
    • evolutions / egg moves / level up
  • move data
  • item data
• src/
  • battle: main / util
  • pokemon
  • random
• data/battle_scripts_1.s

Gen 4

TODO

Appendix

Engines

• Pokemon Showdown!: documentation (new / current / old)
• PokemonBattleEngine
• pokebattle
• Pokemon Online documentation (RBY)
• PokemonLab / Shoddy Battle
• Poke Engine (poke-engine)
• Pokemon Battle Simulator
• PokeSim
• ninjax

RNG

• Pseudorandom number generation in Pokémon
• Admiral-Fish/PokeFinder RNG implementations
• Pokémon Gen 1 RNG Mechanics
• Pokémon Yellow DSUM Manipulation

Glitches

• List of glitches (Generation I)
• Pokémon Crystal - Bugs & Glitches
• Compilation of Red/Blue UE errors - Crystal_
• Pokémon Showdown RBY Bugs

Other

• Technical Machine - david stone
• Gen I Main Battle Function - Crystal_
• the ultimate POKéMON CENTER - Peter O
• Gen II Move effect handling flow
• Pokémon Showdown protocol by Generation

Benchmarks

• Setup:
  • Perf measurement environment on Linux
  • LLVM Benchmarking tips
  • Performance Tracking for Zig
  • uarch_bench.sh
• Tools:
  • google/benchmark
  • Benchmark.js
  • hyperfine
  • perf