G2 support

docs/gold-walkthrough/asm-walk/section-24-snorlax-and-pewter-city-gym.md

@@ -0,0 +1,919 @@
+# Section 24 - Snorlax and Pewter City Gym
+
+Source: `../section-24-snorlax-and-pewter-city-gym.txt`
+(the FAQ numbers this chapter "30 > Snorlax and Pewter City Gym"; the file index
+is 24)
+
+Maps covered: `MAP_ROUTE_19`, `MAP_ROUTE_19_FUCHSIA_GATE`, `MAP_VERMILION_CITY`,
+`MAP_VERMILION_POKECENTER_1F`, `MAP_DIGLETTS_CAVE`, `MAP_ROUTE_2`,
+`MAP_ROUTE_2_NUGGET_HOUSE`, `MAP_ROUTE_2_GATE`, `MAP_PEWTER_CITY`,
+`MAP_PEWTER_POKECENTER_1F`, `MAP_PEWTER_GYM`
+
+Badges / key milestones in this section:
+
+- Level 50 **SNORLAX** caught in Vermilion City, holding LEFTOVERS
+  (`BATTLETYPE_FORCEITEM`); clearing it opens the DIGLETT'S CAVE door
+- **SILVER_WING** (Gold) / **RAINBOW_WING** (Silver) from the Pewter City gramps
+- **NUGGET** from the Route 2 house
+- CARBOS, DIRE_HIT, ELIXER, MAX_POTION item balls on Route 2
+- **BOULDERBADGE** from BROCK (`ENGINE_BOULDERBADGE`)
+
+---
+
+## 1. Route order
+
+| # | Map constant | asm file | Enter via | Leaves via | Why (walkthrough beat) |
+|---|---|---|---|---|---|
+| 0 | `FUCHSIA_CITY` | - | previous section | south connection, or `ROUTE_19_FUCHSIA_GATE` warps 1/2 at (4,0)/(5,0) | **Belongs to the previous section**; only the hop south is listed |
+| 1 | `ROUTE_19_FUCHSIA_GATE` | `maps/Route19FuchsiaGate.asm` | warps 1/2 at (4,0)/(5,0) from `FUCHSIA_CITY` 10/11 | warps 3/4 at (4,7)/(5,7) -> `ROUTE_19` 1 | Officer explains why Route 19 is shut |
+| 2 | `ROUTE_19` | `maps/Route19.asm` | warp 1 at (7,3) from the gate | dead end - back through warp 1 | **Blocked.** `Route19ClearRocksCallback` paints six boulders while `EVENT_CINNABAR_ROCKS_CLEARED` is clear |
+| 3 | `VERMILION_CITY` | `maps/VermilionCity.asm` | FLY (`ENGINE_FLYPOINT_VERMILION`, set by `VermilionCityFlypointCallback`) | warp 10 at (34,7) -> `DIGLETTS_CAVE` 1 | Wake and battle the SNORLAX at (34,8) with the POKe FLUTE radio channel |
+| 4 | `VERMILION_POKECENTER_1F` | `maps/VermilionPokecenter1F.asm` | city warp 2 at (9,5) | warps 1/2 at (3,7)/(4,7) back | Heal and withdraw the caught SNORLAX |
+| 5 | `DIGLETTS_CAVE` | `maps/DiglettsCave.asm` | warp 1 at (3,33) from `VERMILION_CITY` 10 | warp 3 at (15,5) -> `ROUTE_2` 5 | Ladder chain 2->5, long cave, ladder 6->4, then the door |
+| 6 | `ROUTE_2` | `maps/Route2.asm` | warp 5 at (12,7) from `DIGLETTS_CAVE` 3 | north connection to `PEWTER_CITY` | Carbos, Nugget house, Elixer, three Bug Catchers, two cut trees |
+| 7 | `ROUTE_2_NUGGET_HOUSE` | `maps/Route2NuggetHouse.asm` | Route 2 warp 1 at (15,15) | warps 1/2 at (2,7)/(3,7) back | `Route2NuggetHouseFisherScript` -> `verbosegiveitem NUGGET` |
+| 8 | `ROUTE_2_GATE` | `maps/Route2Gate.asm` | Route 2 warps 3/4 at (16,27)/(17,27) | warps 3/4 at (4,7)/(5,7) -> `ROUTE_2` 2 at (15,31) | The "route-changing house" that drops you further south on the same route |
+| 9 | `PEWTER_CITY` | `maps/PewterCity.asm` | south connection from `ROUTE_2` (`connection north, PewterCity, PEWTER_CITY, -5`) | five warps, see below | Sets `ENGINE_FLYPOINT_PEWTER`; gramps hands over the wing |
+| 10 | `PEWTER_POKECENTER_1F` | `maps/PewterPokecenter1F.asm` | city warp 4 at (13,25) | warps 1/2 at (3,7)/(4,7) back | Heal; `Chris` runs `trade NPC_TRADE_CHRIS` (GLOOM -> RAPIDASH) |
+| 11 | `PEWTER_GYM` | `maps/PewterGym.asm` | city warp 2 at (16,17) | warps 1/2 at (4,13)/(5,13) back | Camper Jerry, then **BROCK** for the BOULDERBADGE |
+
+Spillover: the FAQ's video-link header also names Tin Tower, Ho-Oh, Routes 1-4
+and Pallet Town. Nothing in the prose of this section enters those maps - the
+Routes 3/4 and Pallet beats belong to the following section and are not covered
+here.
+
+---
+
+## 2. Maps
+
+### MAP_ROUTE_19
+
+- Script: `maps/Route19.asm`
+- Blocks: `maps/Route19.blk`
+- Header: `data/maps/maps.asm:196` -> `TILESET_KANTO, ROUTE, LANDMARK_ROUTE_19, MUSIC_ROUTE_3, FALSE (phone allowed), PALETTE_AUTO, FISHGROUP_SHORE`
+- Dimensions: `constants/map_constants.asm:180` `map_const ROUTE_19, 10, 18` (group `CINNABAR`, id 5) = 20 x 36 cells
+- Attributes / border: `data/maps/attributes.asm:287` `map_attributes Route19, ROUTE_19, $43`
+- Connections: `connection north, FuchsiaCity, FUCHSIA_CITY, 0`; `connection west, Route20, ROUTE_20, 9`
+
+**Warps** (`def_warp_events`)
+
+| idx | x | y | destination map | dest warp |
+|---|---|---|---|---|
+| 1 | 7 | 3 | `ROUTE_19_FUCHSIA_GATE` | 3 |
+
+**Coord events** (`def_coord_events`)
+
+none.
+
+**BG events** (`def_bg_events`)
+
+| x | y | type | script/item |
+|---|---|---|---|
+| 11 | 13 | `BGEVENT_READ` | `Route19Sign` |
+| 11 | 1 | `BGEVENT_READ` | `CarefulSwimmingSign` |
+
+**Object events** (`def_object_events`)
+
+| const | sprite | x | y | movement | type | script label | event flag |
+|---|---|---|---|---|---|---|---|
+| `ROUTE19_SWIMMER_GIRL` | `SPRITE_SWIMMER_GIRL` | 9 | 23 | `SPRITEMOVEDATA_STANDING_LEFT` | `OBJECTTYPE_TRAINER` (sight 0) | `TrainerSwimmerfDawn` | -1 |
+| `ROUTE19_SWIMMER_GUY1` | `SPRITE_SWIMMER_GUY` | 13 | 28 | `SPRITEMOVEDATA_SPINRANDOM_FAST` | `OBJECTTYPE_TRAINER` (sight 3) | `TrainerSwimmermHarold` | -1 |
+| `ROUTE19_SWIMMER_GUY2` | `SPRITE_SWIMMER_GUY` | 11 | 17 | `SPRITEMOVEDATA_SPINRANDOM_FAST` | `OBJECTTYPE_TRAINER` (sight 3) | `TrainerSwimmermJerome` | -1 |
+| `ROUTE19_SWIMMER_GUY3` | `SPRITE_SWIMMER_GUY` | 8 | 23 | `SPRITEMOVEDATA_STANDING_UP` | `OBJECTTYPE_TRAINER` (sight 0) | `TrainerSwimmermTucker` | -1 |
+| `ROUTE19_FISHER1` | `SPRITE_FISHER` | 9 | 5 | `SPRITEMOVEDATA_STANDING_DOWN` | `OBJECTTYPE_SCRIPT` (sight 1) | `Route19Fisher1Script` | -1 |
+| `ROUTE19_FISHER2` | `SPRITE_FISHER` | 11 | 5 | `SPRITEMOVEDATA_WALK_LEFT_RIGHT` (radius 1,0) | `OBJECTTYPE_SCRIPT` (sight 1) | `Route19Fisher2Script` | -1 |
+
+**Scripts of interest**
+
+- `Route19ClearRocksCallback` (`callback MAPCALLBACK_TILES`). `checkevent
+  EVENT_CINNABAR_ROCKS_CLEARED` / `iftrue .Done`; otherwise it runs six
+  `changeblock` writes that lay a rock block (`$7a`) over block coordinates
+  `(6,6) (8,6) (10,6) (12,8) (4,8) (10,10)`. This is the wall the FAQ hits.
+  Block coordinates, so the blocked cells are `x = 2*bx .. 2*bx+1`,
+  `y = 2*by .. 2*by+1`.
+- `Route19Fisher1Script` / `Route19Fisher2Script` both branch on
+  `EVENT_CINNABAR_ROCKS_CLEARED` for flavour text only. Neither one clears the
+  rocks - see "Blockers and gates".
+
+**Flags and events**
+
+| constant | defined in | read/written by | meaning for a bot |
+|---|---|---|---|
+| `EVENT_CINNABAR_ROCKS_CLEARED` | `constants/event_flags.asm:214` | read by `Route19ClearRocksCallback`, `Route19Fisher1Script`, `Route19Fisher2Script`, `Route19FuchsiaGateOfficerScript`; **set** by `Route20ClearRocksCallback` (`maps/Route20.asm:13`, `MAPCALLBACK_NEWMAP`) | Route 19 stays blocked until the player has stood on Route 20, which is reached from the Cinnabar side (Pallet -> Route 21 -> Cinnabar -> Route 20) |
+
+**Items** - none on this map.
+
+**Trainers** - four Swimmers, all reachable only by Surf and all beyond the
+boulders in the FAQ's play order; not part of this section's critical path.
+
+---
+
+### MAP_ROUTE_19_FUCHSIA_GATE
+
+- Script: `maps/Route19FuchsiaGate.asm`
+- Header: `data/maps/maps.asm:194` -> `TILESET_GATE, GATE, LANDMARK_ROUTE_19, MUSIC_ROUTE_3, FALSE, PALETTE_DAY, FISHGROUP_SHORE`
+- Dimensions: `constants/map_constants.asm:178` `map_const ROUTE_19_FUCHSIA_GATE, 5, 4` (group `CINNABAR`, id 3)
+- Attributes: `data/maps/attributes.asm:512` `map_attributes Route19FuchsiaGate, ROUTE_19_FUCHSIA_GATE, $00`; no connections
+
+**Warps** (`def_warp_events`)
+
+| idx | x | y | destination map | dest warp |
+|---|---|---|---|---|
+| 1 | 4 | 0 | `FUCHSIA_CITY` | 10 |
+| 2 | 5 | 0 | `FUCHSIA_CITY` | 11 |
+| 3 | 4 | 7 | `ROUTE_19` | 1 |
+| 4 | 5 | 7 | `ROUTE_19` | 1 |
+
+**Coord events** - none. **BG events** - none.
+
+**Object events**
+
+| const | sprite | x | y | movement | type | script label | event flag |
+|---|---|---|---|---|---|---|---|
+| `ROUTE19FUCHSIAGATE_OFFICER` | `SPRITE_OFFICER` | 0 | 4 | `SPRITEMOVEDATA_STANDING_RIGHT` | `OBJECTTYPE_SCRIPT` | `Route19FuchsiaGateOfficerScript` | -1 |
+
+**Scripts of interest**
+
+- `Route19FuchsiaGateOfficerScript`: `checkevent EVENT_CINNABAR_ROCKS_CLEARED`,
+  two text branches. Pure flavour; the officer does not gate the warp.
+
+---
+
+### MAP_VERMILION_CITY
+
+- Script: `maps/VermilionCity.asm`
+- Blocks: `maps/VermilionCity.blk`
+- Header: `data/maps/maps.asm:296` -> `TILESET_KANTO, TOWN, LANDMARK_VERMILION_CITY, MUSIC_VERMILION_CITY, FALSE, PALETTE_AUTO, FISHGROUP_OCEAN`
+- Dimensions: `constants/map_constants.asm:273` `map_const VERMILION_CITY, 20, 18` (group `VERMILION`, id 3) = 40 x 36 cells
+- Attributes: `data/maps/attributes.asm:342` `map_attributes VermilionCity, VERMILION_CITY, $43`
+- Connections: `connection north, Route6, ROUTE_6, 5`; `connection east, Route11, ROUTE_11, 0`
+
+**Warps** (`def_warp_events`)
+
+| idx | x | y | destination map | dest warp |
+|---|---|---|---|---|
+| 1 | 5 | 5 | `VERMILION_FISHING_SPEECH_HOUSE` | 1 |
+| 2 | 9 | 5 | `VERMILION_POKECENTER_1F` | 1 |
+| 3 | 7 | 13 | `POKEMON_FAN_CLUB` | 1 |
+| 4 | 13 | 13 | `VERMILION_MAGNET_TRAIN_SPEECH_HOUSE` | 1 |
+| 5 | 21 | 13 | `VERMILION_MART` | 2 |
+| 6 | 21 | 17 | `VERMILION_DIGLETTS_CAVE_SPEECH_HOUSE` | 1 |
+| 7 | 10 | 19 | `VERMILION_GYM` | 1 |
+| 8 | 19 | 31 | `VERMILION_PORT_PASSAGE` | 1 |
+| 9 | 20 | 31 | `VERMILION_PORT_PASSAGE` | 2 |
+| 10 | 34 | 7 | `DIGLETTS_CAVE` | 1 |
+
+**Coord events** (`def_coord_events`) - none.
+
+**BG events** (`def_bg_events`)
+
+| x | y | type | script/item |
+|---|---|---|---|
+| 25 | 3 | `BGEVENT_READ` | `VermilionCitySign` |
+| 5 | 19 | `BGEVENT_READ` | `VermilionGymSign` |
+| 5 | 13 | `BGEVENT_READ` | `PokemonFanClubSign` |
+| 33 | 9 | `BGEVENT_READ` | `VermilionCityDiglettsCaveSign` |
+| 27 | 15 | `BGEVENT_READ` | `VermilionCityPortSign` |
+| 10 | 5 | `BGEVENT_READ` | `VermilionCityPokecenterSign` (`jumpstd PokecenterSignScript`) |
+| 22 | 13 | `BGEVENT_READ` | `VermilionCityMartSign` (`jumpstd MartSignScript`) |
+| 12 | 19 | `BGEVENT_ITEM` | `VermilionCityHiddenFullHeal` -> `hiddenitem FULL_HEAL, EVENT_VERMILION_CITY_HIDDEN_FULL_HEAL` |
+
+**Object events** (`def_object_events`)
+
+| const | sprite | x | y | movement | type | script label | event flag |
+|---|---|---|---|---|---|---|---|
+| `VERMILIONCITY_TEACHER` | `SPRITE_TEACHER` | 18 | 9 | `SPRITEMOVEDATA_WANDER` (1,1) | `OBJECTTYPE_SCRIPT` | `VermilionCityTeacherScript` | -1 |
+| `VERMILIONCITY_GRAMPS` | `SPRITE_GRAMPS` | 23 | 6 | `SPRITEMOVEDATA_STANDING_RIGHT` | `OBJECTTYPE_SCRIPT` | `VermilionMachopOwner` | -1 |
+| `VERMILIONCITY_MACHOP` | `SPRITE_MACHOP` | 26 | 7 | `SPRITEMOVEDATA_POKEMON` | `OBJECTTYPE_SCRIPT` | `VermilionMachop` | -1 |
+| `VERMILIONCITY_SUPER_NERD` | `SPRITE_SUPER_NERD` | 14 | 16 | `SPRITEMOVEDATA_WANDER` (1,1) | `OBJECTTYPE_SCRIPT` | `VermilionCitySuperNerdScript` | -1 |
+| `VERMILIONCITY_BIG_SNORLAX` | `SPRITE_BIG_SNORLAX` | 34 | 8 | `SPRITEMOVEDATA_BIGDOLLSYM` | `OBJECTTYPE_SCRIPT` | `VermilionSnorlax` | `EVENT_VERMILION_CITY_SNORLAX` |
+| `VERMILIONCITY_POKEFAN_M` | `SPRITE_POKEFAN_M` | 31 | 12 | `SPRITEMOVEDATA_STANDING_DOWN` | `OBJECTTYPE_SCRIPT` | `VermilionGymBadgeGuy` | -1 |
+
+Note the object-flag polarity (`CheckObjectFlag`,
+`engine/overworld/map_objects_2.asm:32`): an object with an `EVENT_*` flag is
+**masked when the flag is set**. So the SNORLAX is present only while
+`EVENT_VERMILION_CITY_SNORLAX` is clear, and `disappear` is what sets it.
+
+**Scripts of interest**
+
+- `VermilionSnorlax` (`4f:5291`). `opentext` -> `special SnorlaxAwake` ->
+  `iftrue .Awake`. Asleep branch writes `VermilionCitySnorlaxSleepingText` and
+  ends. `.Awake` writes `VermilionCityRadioNearSnorlaxText`, `pause 15`,
+  `cry SNORLAX`, then
+  `loadvar VAR_BATTLETYPE, BATTLETYPE_FORCEITEM` /
+  `loadwildmon SNORLAX, 50` / `startbattle` /
+  `disappear VERMILIONCITY_BIG_SNORLAX` / `setevent EVENT_FOUGHT_SNORLAX` /
+  `reloadmapafterbattle`.
+  The `disappear` and `setevent` run **unconditionally after the battle**, so a
+  fled-from or fainted Snorlax is still gone: catching it is a one-shot.
+- `SnorlaxAwake` (`engine/events/specials.asm:358`, symbol `03:45d6`). Returns
+  `TRUE` only when *both* hold:
+  1. `[wMapMusic] == MUSIC_POKE_FLUTE_CHANNEL`;
+  2. the player stands on one of `.ProximityCoords`
+     (`engine/events/specials.asm:399`): `(33,8) (34,10) (35,10) (36,8) (36,9)`.
+  The POKe FLUTE channel is the Pokegear radio at knob 78 / "20.0"
+  (`engine/pokegear/pokegear.asm:1447`, `.PokeFluteRadio` at 1487): it needs
+  **not-Johto** and `POKEGEAR_EXPN_CARD_F` in `wPokegearFlags`. Tuning the radio
+  and closing the Pokegear leaves that song as `wMapMusic`.
+- `VermilionGymBadgeGuy`: `checkevent EVENT_GOT_HP_UP_FROM_VERMILION_GUY`, then
+  `readvar VAR_BADGES` with `ifequal NUM_BADGES` / `ifgreater 13` /
+  `ifgreater 9`. `verbosegiveitem HP_UP` only at all 16 badges. Not this
+  section's business, but a bot walking Vermilion will trip the text.
+- `VermilionCityFlypointCallback` (`MAPCALLBACK_NEWMAP`):
+  `setflag ENGINE_FLYPOINT_VERMILION`. This is what makes the FAQ's "fly back to
+  Vermilion City" legal - it must already have been visited on foot.
+
+**Flags and events**
+
+| constant | defined in | read/written by | meaning for a bot |
+|---|---|---|---|
+| `EVENT_VERMILION_CITY_SNORLAX` | `constants/event_flags.asm:1298` | object flag on `VERMILIONCITY_BIG_SNORLAX`; set by `disappear` in `VermilionSnorlax` | clear = Snorlax on the map; set = gone, cave door walkable |
+| `EVENT_FOUGHT_SNORLAX` | `constants/event_flags.asm:1266` | set by `VermilionSnorlax`; read by `VermilionPokecenter1FFishingGuruScript` (`maps/VermilionPokecenter1F.asm:18`) and used as the object flag of the right Black Belt in `maps/VictoryRoadGate.asm:119` | "the Snorlax encounter has happened" |
+| `ENGINE_FLYPOINT_VERMILION` | `constants/engine_flags.asm:72` | `VermilionCityFlypointCallback` | Fly destination unlocked |
+| `POKEGEAR_EXPN_CARD_F` | `constants/ram_constants.asm:280` | read by `.PokeFluteRadio` | without the EXPN CARD the flute channel is static and `SnorlaxAwake` can never be true |
+| `EVENT_VERMILION_CITY_HIDDEN_FULL_HEAL` | `constants/event_flags.asm:252` | `VermilionCityHiddenFullHeal` | hidden FULL_HEAL at (12,19) |
+
+**Items**
+
+| item | how obtained | source (label / bg_event / hidden) | one-time flag |
+|---|---|---|---|
+| `LEFTOVERS` | attached to the wild SNORLAX | `data/pokemon/base_stats/snorlax.asm:9` `db LEFTOVERS, LEFTOVERS` forced by `BATTLETYPE_FORCEITEM` (`engine/battle/core.asm:5771`) | - |
+| `FULL_HEAL` | hidden | `bg_event 12, 19, BGEVENT_ITEM, VermilionCityHiddenFullHeal` | `EVENT_VERMILION_CITY_HIDDEN_FULL_HEAL` |
+
+**Wild encounters** - the scripted SNORLAX is not a table entry; it is
+`loadwildmon SNORLAX, 50`. Level 50 learnset from
+`data/pokemon/evos_attacks.asm:1932`: the four most recent are SNORE (36),
+REST (36), BODY_SLAM (43), ROLLOUT (50) - which is exactly the FAQ's "Rest" and
+"Rollout". Catch rate 25, base exp 154 (`data/pokemon/base_stats/snorlax.asm`).
+
+---
+
+### MAP_VERMILION_POKECENTER_1F
+
+- Script: `maps/VermilionPokecenter1F.asm`
+- Header: `data/maps/maps.asm` (`VERMILION` group); dimensions
+  `constants/map_constants.asm:275` `map_const VERMILION_POKECENTER_1F, 5, 4`
+
+Only the one script matters here:
+
+- `VermilionPokecenter1FFishingGuruScript`: `checkevent EVENT_FOUGHT_SNORLAX`,
+  two text branches ("A sleeping #MON is lying in front of DIGLETT'S CAVE" ->
+  after-text). It is a read-only confirmation that the Snorlax beat is done; the
+  PC withdraw the FAQ asks for is the standard `POKECENTER_2F` / PC menu, not a
+  map script.
+
+---
+
+### MAP_DIGLETTS_CAVE
+
+- Script: `maps/DiglettsCave.asm`
+- Blocks: `maps/DiglettsCave.blk` (180 bytes = 10 x 18 blocks)
+- Header: `data/maps/maps.asm:153` -> `TILESET_CAVE, CAVE, LANDMARK_DIGLETTS_CAVE, MUSIC_MT_MOON, TRUE (no phone), PALETTE_NITE, FISHGROUP_SHORE`
+- Dimensions: `constants/map_constants.asm:140` `map_const DIGLETTS_CAVE, 10, 18` (group `DUNGEONS`, id 75) = 20 x 36 cells
+- Attributes: `data/maps/attributes.asm:487` `map_attributes DiglettsCave, DIGLETTS_CAVE, $09`; no connections
+
+**Warps** (`def_warp_events`)
+
+| idx | x | y | destination map | dest warp |
+|---|---|---|---|---|
+| 1 | 3 | 33 | `VERMILION_CITY` | 10 |
+| 2 | 5 | 31 | `DIGLETTS_CAVE` | 5 |
+| 3 | 15 | 5 | `ROUTE_2` | 5 |
+| 4 | 17 | 3 | `DIGLETTS_CAVE` | 6 |
+| 5 | 17 | 33 | `DIGLETTS_CAVE` | 2 |
+| 6 | 3 | 3 | `DIGLETTS_CAVE` | 4 |
+
+Warps 2<->5 and 4<->6 are the two internal ladders. Reading `DiglettsCave.blk`
+against `data/tilesets/kanto_collision.asm` (block `$1f`/`$1b` = ladder, `$24` =
+door) the map is three disconnected pockets:
+
+- pocket A (bottom-left, blocks (1,15)-(2,17)): warp 1 (VERMILION door) + warp 2
+  (ladder);
+- pocket B (the long cave): warp 5 at (17,33) up to warp 6 at (3,3);
+- pocket C (top-right, blocks (7,1)-(8,3)): warp 4 (ladder) + warp 3 (ROUTE_2
+  door).
+
+So the traversal is: `(3,33)` -> ladder `(5,31)` -> emerge `(17,33)` -> walk the
+long cave to `(3,3)` -> ladder -> emerge `(17,3)` -> door `(15,5)` -> Route 2
+`(12,7)`. That is exactly the FAQ's "down the ladder, ride up, up that ladder,
+exit the door".
+
+**Coord events** - none.
+
+**BG events**
+
+| x | y | type | script/item |
+|---|---|---|---|
+| 6 | 11 | `BGEVENT_ITEM` | `DiglettsCaveHiddenMaxRevive` -> `hiddenitem MAX_REVIVE, EVENT_DIGLETTS_CAVE_HIDDEN_MAX_REVIVE` |
+
+**Object events**
+
+| const | sprite | x | y | movement | type | script label | event flag |
+|---|---|---|---|---|---|---|---|
+| `DIGLETTSCAVE_POKEFAN_M` | `SPRITE_POKEFAN_M` | 3 | 31 | `SPRITEMOVEDATA_STANDING_DOWN` | `OBJECTTYPE_SCRIPT` | `DiglettsCavePokefanMScript` | -1 |
+
+**Trainers** - none, matching the FAQ.
+
+**Items**
+
+| item | how obtained | source | one-time flag |
+|---|---|---|---|
+| `MAX_REVIVE` | hidden (ITEMFINDER / bump) | `bg_event 6, 11, BGEVENT_ITEM` | `EVENT_DIGLETTS_CAVE_HIDDEN_MAX_REVIVE` (`constants/event_flags.asm:228`) |
+
+**Wild encounters** - `data/wild/kanto_grass.asm:5` `def_grass_wildmons
+DIGLETTS_CAVE`, rates `4 / 2 / 8` percent (morn/day/nite). All three time slots
+carry the same seven rows:
+
+| slot | level | species |
+|---|---|---|
+| 1 | 15 | DIGLETT |
+| 2 | 17 | DIGLETT |
+| 3 | 19 | DIGLETT |
+| 4 | 13 | DIGLETT |
+| 5 | 19 | DUGTRIO |
+| 6 | 24 | DUGTRIO |
+| 7 | 29 | DUGTRIO |
+
+The FAQ's "capture both Diglett and Dugtrio here" is correct, and night is the
+best time (8% vs 2% by day).
+
+The FAQ's "ride your bike" is legal here: `BikeFunction`'s `.CheckEnvironment`
+(`engine/events/overworld.asm:1665`) allows outdoor maps, `CAVE` and `GATE`.
+
+---
+
+### MAP_ROUTE_2
+
+- Script: `maps/Route2.asm`
+- Blocks: `maps/Route2.blk` (270 bytes = 10 x 27 blocks)
+- Header: `data/maps/maps.asm:455` -> `TILESET_KANTO, ROUTE, LANDMARK_ROUTE_2, MUSIC_ROUTE_2, FALSE, PALETTE_AUTO, FISHGROUP_SHORE`
+- Dimensions: `constants/map_constants.asm:421` `map_const ROUTE_2, 10, 27` (group `VIRIDIAN`, id 1) = 20 x 54 cells
+- Attributes: `data/maps/attributes.asm:255` `map_attributes Route2, ROUTE_2, $0f`
+- Connections: `connection north, PewterCity, PEWTER_CITY, -5`;
+  `connection south, ViridianCity, VIRIDIAN_CITY, -5`
+
+**Warps** (`def_warp_events`)
+
+| idx | x | y | destination map | dest warp |
+|---|---|---|---|---|
+| 1 | 15 | 15 | `ROUTE_2_NUGGET_HOUSE` | 1 |
+| 2 | 15 | 31 | `ROUTE_2_GATE` | 3 |
+| 3 | 16 | 27 | `ROUTE_2_GATE` | 1 |
+| 4 | 17 | 27 | `ROUTE_2_GATE` | 2 |
+| 5 | 12 | 7 | `DIGLETTS_CAVE` | 3 |
+
+**Coord events** - none.
+
+**BG events**
+
+| x | y | type | script/item |
+|---|---|---|---|
+| 7 | 51 | `BGEVENT_READ` | `Route2Sign` |
+| 11 | 9 | `BGEVENT_READ` | `Route2DiglettsCaveSign` |
+| 7 | 23 | `BGEVENT_ITEM` | `Route2HiddenMaxEther` -> `hiddenitem MAX_ETHER, EVENT_ROUTE_2_HIDDEN_MAX_ETHER` |
+| 4 | 14 | `BGEVENT_ITEM` | `Route2HiddenFullHeal` -> `hiddenitem FULL_HEAL, EVENT_ROUTE_2_HIDDEN_FULL_HEAL` |
+| 4 | 27 | `BGEVENT_ITEM` | `Route2HiddenFullRestore` -> `hiddenitem FULL_RESTORE, EVENT_ROUTE_2_HIDDEN_FULL_RESTORE` |
+| 11 | 30 | `BGEVENT_ITEM` | `Route2HiddenRevive` -> `hiddenitem REVIVE, EVENT_ROUTE_2_HIDDEN_REVIVE` |
+
+**Object events**
+
+| const | sprite | x | y | movement | type | script label | event flag |
+|---|---|---|---|---|---|---|---|
+| `ROUTE2_BUG_CATCHER1` | `SPRITE_BUG_CATCHER` | 10 | 45 | `SPRITEMOVEDATA_STANDING_LEFT` | `OBJECTTYPE_TRAINER` (sight 5) | `TrainerBugCatcherRob` | -1 |
+| `ROUTE2_BUG_CATCHER2` | `SPRITE_BUG_CATCHER` | 5 | 5 | `SPRITEMOVEDATA_STANDING_RIGHT` (radius 1,0) | `OBJECTTYPE_TRAINER` (sight 4) | `TrainerBugCatcherEd` | -1 |
+| `ROUTE2_BUG_CATCHER3` | `SPRITE_BUG_CATCHER` | 4 | 43 | `SPRITEMOVEDATA_STANDING_UP` (radius 1,0) | `OBJECTTYPE_TRAINER` (sight 5) | `TrainerBugCatcherDoug` | -1 |
+| `ROUTE2_POKE_BALL1` | `SPRITE_POKE_BALL` | 0 | 29 | `SPRITEMOVEDATA_STILL` | `OBJECTTYPE_ITEMBALL` | `Route2DireHit` (`itemball DIRE_HIT`) | `EVENT_ROUTE_2_DIRE_HIT` |
+| `ROUTE2_POKE_BALL2` | `SPRITE_POKE_BALL` | 2 | 23 | `SPRITEMOVEDATA_STILL` | `OBJECTTYPE_ITEMBALL` | `Route2MaxPotion` (`itemball MAX_POTION`) | `EVENT_ROUTE_2_MAX_POTION` |
+| `ROUTE2_POKE_BALL3` | `SPRITE_POKE_BALL` | 19 | 2 | `SPRITEMOVEDATA_STILL` | `OBJECTTYPE_ITEMBALL` | `Route2Carbos` (`itemball CARBOS`) | `EVENT_ROUTE_2_CARBOS` |
+| `ROUTE2_POKE_BALL4` | `SPRITE_POKE_BALL` | 14 | 50 | `SPRITEMOVEDATA_STILL` | `OBJECTTYPE_ITEMBALL` | `Route2Elixer` (`itemball ELIXER`) | `EVENT_ROUTE_2_ELIXER` |
+| `ROUTE2_FRUIT_TREE` | `SPRITE_FRUIT_TREE` | 10 | 14 | `SPRITEMOVEDATA_STILL` | `OBJECTTYPE_SCRIPT` | `Route2FruitTree` (`fruittree FRUITTREE_ROUTE_2`) | -1 |
+
+**Cut trees** (not asm rows - decoded from `maps/Route2.blk` against the
+`CUT_TREE` entries of `data/tilesets/kanto_collision.asm`, which are blocks
+`$00 $32 $33 $34 $35 $60`)
+
+| block (bx,by) | block id | covered cells (x, y) | which FAQ beat |
+|---|---|---|---|
+| (2, 4) | `$32` | 4-5, 8-9 | near the Diglett's Cave door, not used by the FAQ |
+| (7, 9) | `$32` | 14-15, 18-19 | "cut the tree to the south" (just below the Nugget house at (15,15)) |
+| (5, 20) | `$34` | 10-11, 40-41 | not named by the FAQ |
+| (6, 23) | `$34` | 12-13, 46-47 | not named by the FAQ |
+| (6, 25) | `$34` | 12-13, 50-51 | "cut the tree just left of it" (immediately left of the Elixer at (14,50)) |
+
+**Scripts of interest**
+
+- `TrainerBugCatcherRob` / `TrainerBugCatcherEd` / `TrainerBugCatcherDoug`
+  (`4d:5bc2`, `4d:5bd6`, `4d:5bea`): each is the plain `trainer CLASS, MEMBER,
+  EVENT_*, seen, beaten, 0, .Script` header with an `endifjustbattled` +
+  after-battle text body. No items, no flags beyond the beaten event.
+- `Route2FruitTree`: `fruittree FRUITTREE_ROUTE_2` ->
+  `data/items/fruit_trees.asm:28` `db PSNCUREBERRY`. This is the FAQ's
+  "PSNCure Berry".
+
+**Flags and events**
+
+| constant | defined in | read/written by | meaning for a bot |
+|---|---|---|---|
+| `EVENT_ROUTE_2_DIRE_HIT` | `constants/event_flags.asm:1318` | item ball object flag | clear = ball present |
+| `EVENT_ROUTE_2_MAX_POTION` | `constants/event_flags.asm:1319` | item ball object flag | clear = ball present |
+| `EVENT_ROUTE_2_CARBOS` | `constants/event_flags.asm:1320` | item ball object flag | clear = ball present |
+| `EVENT_ROUTE_2_ELIXER` | `constants/event_flags.asm:1321` | item ball object flag | clear = ball present |
+| `EVENT_ROUTE_2_HIDDEN_MAX_ETHER` | `constants/event_flags.asm:237` | `Route2HiddenMaxEther` | hidden pickup |
+| `EVENT_ROUTE_2_HIDDEN_FULL_HEAL` | `constants/event_flags.asm:238` | `Route2HiddenFullHeal` | hidden pickup |
+| `EVENT_ROUTE_2_HIDDEN_FULL_RESTORE` | `constants/event_flags.asm:239` | `Route2HiddenFullRestore` | hidden pickup |
+| `EVENT_ROUTE_2_HIDDEN_REVIVE` | `constants/event_flags.asm:240` | `Route2HiddenRevive` | hidden pickup |
+| `EVENT_BEAT_BUG_CATCHER_ROB` | `constants/event_flags.asm:840` | `TrainerBugCatcherRob` | trainer beaten |
+| `EVENT_BEAT_BUG_CATCHER_ED` | `constants/event_flags.asm:841` | `TrainerBugCatcherEd` | trainer beaten |
+| `EVENT_BEAT_BUG_CATCHER_DOUG` | `constants/event_flags.asm:850` | `TrainerBugCatcherDoug` | trainer beaten |
+
+**Items**
+
+| item | how obtained | source (label / bg_event / hidden) | one-time flag |
+|---|---|---|---|
+| `CARBOS` | item ball at (19,2) | `Route2Carbos` | `EVENT_ROUTE_2_CARBOS` |
+| `MAX_POTION` | item ball at (2,23) | `Route2MaxPotion` | `EVENT_ROUTE_2_MAX_POTION` |
+| `DIRE_HIT` | item ball at (0,29) | `Route2DireHit` | `EVENT_ROUTE_2_DIRE_HIT` |
+| `ELIXER` | item ball at (14,50) | `Route2Elixer` | `EVENT_ROUTE_2_ELIXER` |
+| `PSNCUREBERRY` | fruit tree object at (10,14) | `FRUITTREE_ROUTE_2`, `data/items/fruit_trees.asm:28` | daily reset, not an event flag |
+| `MAX_ETHER` | hidden at (7,23) | bg_event | `EVENT_ROUTE_2_HIDDEN_MAX_ETHER` |
+| `FULL_HEAL` | hidden at (4,14) | bg_event | `EVENT_ROUTE_2_HIDDEN_FULL_HEAL` |
+| `FULL_RESTORE` | hidden at (4,27) | bg_event | `EVENT_ROUTE_2_HIDDEN_FULL_RESTORE` |
+| `REVIVE` | hidden at (11,30) | bg_event | `EVENT_ROUTE_2_HIDDEN_REVIVE` |
+| `NUGGET` | Route 2 Nugget House NPC | `Route2NuggetHouseFisherScript` | `EVENT_GOT_NUGGET_FROM_GUY` |
+
+**Trainers**
+
+| const | class | id | party (`data/trainers/parties.asm` label) | script label | rematch/phone |
+|---|---|---|---|---|---|
+| `ROB` (`constants/trainer_constants.asm:314`) | `BUG_CATCHER` | 2 | `BugCatcherGroup` "ROB" (`data/trainers/parties.asm:1416`): L32 BEEDRILL, L32 BUTTERFREE, `TRAINERTYPE_NORMAL` | `TrainerBugCatcherRob` | no |
+| `DOUG` (`constants/trainer_constants.asm:324`) | `BUG_CATCHER` | 12 | `BugCatcherGroup` "DOUG" (`data/trainers/parties.asm:1482`): L34 ARIADOS | `TrainerBugCatcherDoug` | no |
+| `ED` (`constants/trainer_constants.asm:315`) | `BUG_CATCHER` | 3 | `BugCatcherGroup` "ED" (`data/trainers/parties.asm:1422`): L30 BEEDRILL x3 | `TrainerBugCatcherEd` | no |
+
+`BUG_CATCHER` base reward 4 (`data/trainers/attributes.asm:215`); prize =
+base x last mon level (`ComputeTrainerReward`,
+`engine/battle/read_trainer_party.asm:300`).
+
+**Wild encounters** - `data/wild/kanto_grass.asm:259` `def_grass_wildmons
+ROUTE_2`, rates `10 / 10 / 10`. Gold (`IF DEF(_GOLD)`):
+
+| slot | morn | day | nite |
+|---|---|---|---|
+| 1 | L3 CATERPIE | L3 CATERPIE | L3 HOOTHOOT |
+| 2 | L3 PIDGEY | L3 PIDGEY | L3 SPINARAK |
+| 3 | L5 METAPOD | L5 METAPOD | L5 HOOTHOOT |
+| 4 | L7 BUTTERFREE | L7 PIDGEY | L7 NOCTOWL |
+| 5 | L7 PIDGEOTTO | L7 PIDGEOTTO | L7 ARIADOS |
+| 6 | L4 PIKACHU | L4 PIKACHU | L4 PIKACHU |
+| 7 | L4 PIKACHU | L4 PIKACHU | L4 PIKACHU |
+
+(The Silver table under `ELIF DEF(_SILVER)` swaps the Caterpie line for
+Weedle/Kakuna/Beedrill and Spinarak for Ledyba.)
+
+---
+
+### MAP_ROUTE_2_NUGGET_HOUSE
+
+- Script: `maps/Route2NuggetHouse.asm`
+- Header: `data/maps/maps.asm:465` -> `TILESET_HOUSE, INDOOR, LANDMARK_ROUTE_2, MUSIC_VIRIDIAN_CITY, FALSE, PALETTE_DAY, FISHGROUP_SHORE`
+- Dimensions: `constants/map_constants.asm:431` `map_const ROUTE_2_NUGGET_HOUSE, 4, 4`
+- Attributes: `data/maps/attributes.asm:664`; no connections
+
+**Warps**
+
+| idx | x | y | destination map | dest warp |
+|---|---|---|---|---|
+| 1 | 2 | 7 | `ROUTE_2` | 1 |
+| 2 | 3 | 7 | `ROUTE_2` | 1 |
+
+**Coord events** - none. **BG events** - none.
+
+**Object events**
+
+| const | sprite | x | y | movement | type | script label | event flag |
+|---|---|---|---|---|---|---|---|
+| `ROUTE2NUGGETHOUSE_FISHER` | `SPRITE_FISHER` | 2 | 4 | `SPRITEMOVEDATA_WALK_UP_DOWN` (radius 0,2) | `OBJECTTYPE_SCRIPT` | `Route2NuggetHouseFisherScript` | -1 |
+
+**Scripts of interest**
+
+- `Route2NuggetHouseFisherScript` (`5f:4e26`): `faceplayer` / `opentext` /
+  `checkevent EVENT_GOT_NUGGET_FROM_GUY` -> `.GotNugget`; otherwise text,
+  `promptbutton`, `verbosegiveitem NUGGET`, `iffalse .NoRoom`,
+  `setevent EVENT_GOT_NUGGET_FROM_GUY`. A full bag skips the flag, so the gift
+  is re-offerable.
+
+**Flags and events**
+
+| constant | defined in | read/written by | meaning for a bot |
+|---|---|---|---|
+| `EVENT_GOT_NUGGET_FROM_GUY` | `constants/event_flags.asm:199` | `Route2NuggetHouseFisherScript` | one-time NUGGET |
+
+---
+
+### MAP_ROUTE_2_GATE
+
+- Script: `maps/Route2Gate.asm`
+- Header: `data/maps/maps.asm:466` -> `TILESET_GATE, GATE, LANDMARK_ROUTE_2, MUSIC_ROUTE_2, FALSE, PALETTE_DAY, FISHGROUP_SHORE`
+- Dimensions: `constants/map_constants.asm:432` `map_const ROUTE_2_GATE, 5, 4`
+- Attributes: `data/maps/attributes.asm:665`; no connections
+
+**Warps**
+
+| idx | x | y | destination map | dest warp |
+|---|---|---|---|---|
+| 1 | 4 | 0 | `ROUTE_2` | 3 |
+| 2 | 5 | 0 | `ROUTE_2` | 4 |
+| 3 | 4 | 7 | `ROUTE_2` | 2 |
+| 4 | 5 | 7 | `ROUTE_2` | 2 |
+
+Both sides land back on Route 2 - this is the FAQ's "route-changing house...
+You'll still be in Route 2". North side (y=0) <-> Route 2 (16,27)/(17,27);
+south side (y=7) <-> Route 2 (15,31).
+
+**Coord events** - none. **BG events** - none.
+
+**Object events**
+
+| const | sprite | x | y | movement | type | script label | event flag |
+|---|---|---|---|---|---|---|---|
+| `ROUTE2GATE_SCIENTIST` | `SPRITE_SCIENTIST` | 6 | 4 | `SPRITEMOVEDATA_WALK_UP_DOWN` (radius 0,2) | `OBJECTTYPE_SCRIPT` | `Route2GateScientistScript` | -1 |
+
+`Route2GateScientistScript` is `jumptextfaceplayer` only (Oak's aide flavour).
+
+---
+
+### MAP_PEWTER_CITY
+
+- Script: `maps/PewterCity.asm`
+- Blocks: `maps/PewterCity.blk`
+- Header: `data/maps/maps.asm:322` -> `TILESET_KANTO, TOWN, LANDMARK_PEWTER_CITY, MUSIC_VIRIDIAN_CITY, FALSE, PALETTE_AUTO, FISHGROUP_SHORE`
+- Dimensions: `constants/map_constants.asm:297` `map_const PEWTER_CITY, 20, 18` (group `PEWTER`, id 2) = 40 x 36 cells
+- Attributes: `data/maps/attributes.asm:251` `map_attributes PewterCity, PEWTER_CITY, $0f`
+- Connections: `connection south, Route2, ROUTE_2, 5`; `connection east, Route3, ROUTE_3, 5`
+
+**Warps** (`def_warp_events`)
+
+| idx | x | y | destination map | dest warp |
+|---|---|---|---|---|
+| 1 | 29 | 13 | `PEWTER_NIDORAN_SPEECH_HOUSE` | 1 |
+| 2 | 16 | 17 | `PEWTER_GYM` | 1 |
+| 3 | 23 | 17 | `PEWTER_MART` | 2 |
+| 4 | 13 | 25 | `PEWTER_POKECENTER_1F` | 1 |
+| 5 | 7 | 29 | `PEWTER_SNOOZE_SPEECH_HOUSE` | 1 |
+
+There is **no museum warp**: the FAQ's "they even filled the doorway in" is
+literally true in the asm - the museum exists only as a sign.
+
+**Coord events** - none.
+
+**BG events**
+
+| x | y | type | script/item |
+|---|---|---|---|
+| 25 | 23 | `BGEVENT_READ` | `PewterCitySign` |
+| 11 | 17 | `BGEVENT_READ` | `PewterGymSign` |
+| 15 | 9 | `BGEVENT_READ` | `PewterMuseumSign` ("closed for renovations") |
+| 33 | 19 | `BGEVENT_READ` | `PewterCityMtMoonGiftShopSign` |
+| 19 | 29 | `BGEVENT_READ` | `PewterCityWelcomeSign` |
+| 14 | 25 | `BGEVENT_READ` | `PewterCityPokecenterSign` (`jumpstd PokecenterSignScript`) |
+| 24 | 17 | `BGEVENT_READ` | `PewterCityMartSign` (`jumpstd MartSignScript`) |
+
+No hidden items in Pewter City.
+
+**Object events**
+
+| const | sprite | x | y | movement | type | script label | event flag |
+|---|---|---|---|---|---|---|---|
+| `PEWTERCITY_COOLTRAINER_F` | `SPRITE_COOLTRAINER_F` | 19 | 11 | `SPRITEMOVEDATA_WANDER` (2,2) | `OBJECTTYPE_SCRIPT` | `PewterCityCooltrainerFScript` | -1 |
+| `PEWTERCITY_BUG_CATCHER` | `SPRITE_BUG_CATCHER` | 14 | 29 | `SPRITEMOVEDATA_WANDER` (2,2) | `OBJECTTYPE_SCRIPT` | `PewterCityBugCatcherScript` | -1 |
+| `PEWTERCITY_GRAMPS` | `SPRITE_GRAMPS` | 29 | 17 | `SPRITEMOVEDATA_WALK_LEFT_RIGHT` (radius 2,0) | `OBJECTTYPE_SCRIPT` | `PewterCityGrampsScript` | -1 |
+| `PEWTERCITY_FRUIT_TREE1` | `SPRITE_FRUIT_TREE` | 32 | 3 | `SPRITEMOVEDATA_STILL` | `OBJECTTYPE_SCRIPT` | `PewterCityFruitTree1` (`fruittree FRUITTREE_PEWTER_CITY_1`) | -1 |
+| `PEWTERCITY_FRUIT_TREE2` | `SPRITE_FRUIT_TREE` | 30 | 3 | `SPRITEMOVEDATA_STILL` | `OBJECTTYPE_SCRIPT` | `PewterCityFruitTree2` (`fruittree FRUITTREE_PEWTER_CITY_2`) | -1 |
+
+**Scripts of interest**
+
+- `PewterCityGrampsScript` (`4d:583e`). `faceplayer` / `opentext` / `checkver`
+  / `iftrue .RainbowWing`. `checkver` leaves `GS_VERSION` in `wScriptVar`
+  (0 = Gold, 1 = Silver), so:
+  - **Gold**: `checkevent EVENT_GOT_SILVER_WING` -> `.GotSilverWing`; otherwise
+    text, `promptbutton`, `verbosegiveitem SILVER_WING`,
+    `setevent EVENT_GOT_SILVER_WING`. Note there is **no `iffalse` guard** on
+    this `verbosegiveitem`: the flag is set whether or not the bag had room.
+  - **Silver**: `checkevent EVENT_GOT_RAINBOW_WING` -> `.GotSilverWing`;
+    otherwise `verbosegiveitem RAINBOW_WING`, `setevent EVENT_GOT_RAINBOW_WING`,
+    `setevent EVENT_TEAM_ROCKET_DISBANDED`.
+  This gramps is the *second* source for the wing pair: the Radio Tower director
+  (`maps/RadioTower5F.asm:120-140`) gives the opposite one on the same
+  `checkver` split.
+- `PewterCityFlypointCallback` (`MAPCALLBACK_NEWMAP`):
+  `setflag ENGINE_FLYPOINT_PEWTER`.
+
+**Flags and events**
+
+| constant | defined in | read/written by | meaning for a bot |
+|---|---|---|---|
+| `EVENT_GOT_SILVER_WING` | `constants/event_flags.asm:130` | Gold branch of `PewterCityGrampsScript`; also `maps/RadioTower5F.asm:139` (Silver) | one-time |
+| `EVENT_GOT_RAINBOW_WING` | `constants/event_flags.asm:129` | Silver branch of `PewterCityGrampsScript`; also `maps/RadioTower5F.asm:129` (Gold); read by `maps/EcruteakTinTowerEntrance.asm:62` | one-time; gates Tin Tower entry |
+| `EVENT_TEAM_ROCKET_DISBANDED` | `constants/event_flags.asm:1283` | set by the Silver branch here | side effect of the Rainbow Wing gift |
+| `ENGINE_FLYPOINT_PEWTER` | `constants/engine_flags.asm:69` | `PewterCityFlypointCallback` | Fly destination |
+
+**Items**
+
+| item | how obtained | source | one-time flag |
+|---|---|---|---|
+| `SILVER_WING` (Gold) / `RAINBOW_WING` (Silver) | talk to `PEWTERCITY_GRAMPS` at (29,17) | `PewterCityGrampsScript` | `EVENT_GOT_SILVER_WING` / `EVENT_GOT_RAINBOW_WING` |
+| `ICE_BERRY` | fruit tree at (32,3) | `FRUITTREE_PEWTER_CITY_1`, `data/items/fruit_trees.asm:31` | daily |
+| `MINT_BERRY` | fruit tree at (30,3) | `FRUITTREE_PEWTER_CITY_2`, `data/items/fruit_trees.asm:32` | daily |
+
+**Wild encounters** - none (TOWN, no grass table).
+
+---
+
+### MAP_PEWTER_POKECENTER_1F
+
+- Script: `maps/PewterPokecenter1F.asm`
+- Header: `data/maps/maps.asm:326` -> `TILESET_POKECENTER, INDOOR, LANDMARK_PEWTER_CITY, MUSIC_POKEMON_CENTER, FALSE, PALETTE_DAY, FISHGROUP_SHORE`
+- Dimensions: `constants/map_constants.asm:301` `map_const PEWTER_POKECENTER_1F, 5, 4`
+- Attributes: `data/maps/attributes.asm:583`
+
+**Warps**
+
+| idx | x | y | destination map | dest warp |
+|---|---|---|---|---|
+| 1 | 3 | 7 | `PEWTER_CITY` | 4 |
+| 2 | 4 | 7 | `PEWTER_CITY` | 4 |
+| 3 | 0 | 7 | `POKECENTER_2F` | 1 |
+
+**Coord events** - none. **BG events** - none.
+
+**Object events**
+
+| const | sprite | x | y | movement | type | script label | event flag |
+|---|---|---|---|---|---|---|---|
+| `PEWTERPOKECENTER1F_NURSE` | `SPRITE_NURSE` | 3 | 1 | `SPRITEMOVEDATA_STANDING_DOWN` | `OBJECTTYPE_SCRIPT` | `PewterPokecenter1FNurseScript` (`jumpstd PokecenterNurseScript`) | -1 |
+| `PEWTERPOKECENTER1F_TEACHER` | `SPRITE_TEACHER` | 8 | 6 | `SPRITEMOVEDATA_STANDING_DOWN` | `OBJECTTYPE_SCRIPT` | `PewterPokecenter1FTeacherScript` | -1 |
+| `PEWTERPOKECENTER1F_JIGGLYPUFF` | `SPRITE_JIGGLYPUFF` | 1 | 3 | `SPRITEMOVEDATA_POKEMON` | `OBJECTTYPE_SCRIPT` | `PewterJigglypuff` | -1 |
+| `PEWTERPOKECENTER1F_BUG_CATCHER` | `SPRITE_BUG_CATCHER` | 2 | 3 | `SPRITEMOVEDATA_STANDING_DOWN` | `OBJECTTYPE_SCRIPT` | `PewterPokecenter1FBugCatcherScript` | -1 |
+| `PEWTERPOKECENTER1F_CHRIS` | `SPRITE_POKEFAN_M` | 7 | 2 | `SPRITEMOVEDATA_STANDING_DOWN` | `OBJECTTYPE_SCRIPT` | `Chris` | -1 |
+
+**Scripts of interest**
+
+- `Chris` (`5a:46f5`): `faceplayer` / `opentext` / `trade NPC_TRADE_CHRIS` /
+  `waitbutton` / `closetext` / `end`. The trade row is
+  `data/events/npc_trades.asm:18`:
+  `npctrade TRADE_DIALOGSET_HAPPY, GLOOM, RAPIDASH, "RUNNY", $96, $66,
+  BURNT_BERRY, 15616, "CHRIS", TRADE_GENDER_EITHER` - the player gives GLOOM and
+  receives a RAPIDASH nicknamed RUNNY, DVs `$96/$66`, holding a BURNT_BERRY, OT
+  "CHRIS" ID 15616. The FAQ's "trade a Gloom for a Rapidash" is exact. Note the
+  NPC sprite is `SPRITE_POKEFAN_M`, not a lady.
+
+---
+
+### MAP_PEWTER_GYM
+
+- Script: `maps/PewterGym.asm`
+- Blocks: `maps/PewterGym.blk`
+- Header: `data/maps/maps.asm:324` -> `TILESET_TOWER, INDOOR, LANDMARK_PEWTER_CITY, MUSIC_GYM, TRUE (no phone), PALETTE_DAY, FISHGROUP_SHORE`
+- Dimensions: `constants/map_constants.asm:299` `map_const PEWTER_GYM, 5, 7` (group `PEWTER`, id 4) = 10 x 14 cells
+- Attributes: `data/maps/attributes.asm:581` `map_attributes PewterGym, PEWTER_GYM, $00`; no connections
+
+**Warps** (`def_warp_events`)
+
+| idx | x | y | destination map | dest warp |
+|---|---|---|---|---|
+| 1 | 4 | 13 | `PEWTER_CITY` | 2 |
+| 2 | 5 | 13 | `PEWTER_CITY` | 2 |
+
+**Coord events** - none. There is no lock-in trip-wire in this gym.
+
+**BG events**
+
+| x | y | type | script/item |
+|---|---|---|---|
+| 2 | 11 | `BGEVENT_READ` | `PewterGymStatue` |
+| 7 | 11 | `BGEVENT_READ` | `PewterGymStatue` |
+
+**Object events**
+
+| const | sprite | x | y | movement | type | script label | event flag |
+|---|---|---|---|---|---|---|---|
+| `PEWTERGYM_BROCK` | `SPRITE_BROCK` | 5 | 1 | `SPRITEMOVEDATA_STANDING_DOWN` | `OBJECTTYPE_SCRIPT` | `PewterGymBrockScript` | -1 |
+| `PEWTERGYM_YOUNGSTER` | `SPRITE_YOUNGSTER` | 2 | 5 | `SPRITEMOVEDATA_STANDING_RIGHT` | `OBJECTTYPE_TRAINER` (sight 3) | `TrainerCamperJerry` | -1 |
+| `PEWTERGYM_GYM_GUIDE` | `SPRITE_GYM_GUIDE` | 6 | 11 | `SPRITEMOVEDATA_STANDING_DOWN` | `OBJECTTYPE_SCRIPT` (sight 1) | `PewterGymGuideScript` | -1 |
+
+**Scripts of interest**
+
+- `PewterGymBrockScript` (`5a:405f`). `faceplayer` / `opentext` /
+  `checkflag ENGINE_BOULDERBADGE` / `iftrue .FightDone`. Otherwise:
+  `writetext BrockIntroText`, `waitbutton`, `closetext`,
+  `winlosstext BrockWinLossText, 0`, `loadtrainer BROCK, BROCK1`,
+  `startbattle`, `reloadmapafterbattle`, `setevent EVENT_BEAT_BROCK`,
+  **`setevent EVENT_BEAT_CAMPER_JERRY`**, then `opentext` /
+  `writetext ReceivedBoulderBadgeText` / `playsound SFX_GET_BADGE` / `waitsfx` /
+  `setflag ENGINE_BOULDERBADGE` / `writetext BrockBoulderBadgeText` /
+  `waitbutton` / `closetext` / `end`.
+  Two consequences for a bot: (1) Camper Jerry is optional - beating Brock marks
+  him beaten; (2) the badge is a `setflag` on the ENGINE namespace, not an
+  `EVENT_*`.
+- `TrainerCamperJerry` (`5a:4093`): standard `trainer CAMPER, JERRY,
+  EVENT_BEAT_CAMPER_JERRY, ...` header, sight range 3 facing right from (2,5).
+- `PewterGymGuideScript`: `checkevent EVENT_BEAT_BROCK`, two text branches.
+- `PewterGymStatue`: `checkflag ENGINE_BOULDERBADGE`; unbeaten -> `jumpstd
+  GymStatue1Script`, beaten -> `gettrainername STRING_BUFFER_4, BROCK, BROCK1`
+  then `jumpstd GymStatue2Script`.
+
+**Flags and events**
+
+| constant | defined in | read/written by | meaning for a bot |
+|---|---|---|---|
+| `ENGINE_BOULDERBADGE` | `constants/engine_flags.asm:47` (row `data/events/engine_flags.asm`, backed by `wKantoBadges`) | checked and set by `PewterGymBrockScript`; checked by `PewterGymStatue` | the gym's own re-entry guard, and the ROCK-type damage boost via `BadgeTypeBoosts` |
+| `EVENT_BEAT_BROCK` | `constants/event_flags.asm:715` | set by `PewterGymBrockScript`; read by `PewterGymGuideScript` | gym cleared |
+| `EVENT_BEAT_CAMPER_JERRY` | `constants/event_flags.asm:545` | `TrainerCamperJerry`, and also set by `PewterGymBrockScript` | trainer beaten / skipped |
+
+**Trainers**
+
+| const | class | id | party (`data/trainers/parties.asm` label) | script label | rematch/phone |
+|---|---|---|---|---|---|
+| `JERRY` (`constants/trainer_constants.asm:566`) | `CAMPER` | 18 | `CamperGroup` "JERRY" (`data/trainers/parties.asm:2811`): L37 SANDSLASH, `TRAINERTYPE_NORMAL` | `TrainerCamperJerry` | no |
+| `BROCK1` (`constants/trainer_constants.asm:91`, class `BROCK` = 11 at line 90) | `BROCK` | 1 | `BrockGroup` (`data/trainers/parties.asm:270`, symbol `0e:5cda`), `TRAINERTYPE_MOVES` | `PewterGymBrockScript` | no phone |
+
+`BrockGroup` party, in asm order:
+
+| # | level | species | moves |
+|---|---|---|---|
+| 1 | 41 | GRAVELER | DEFENSE_CURL, ROCK_SLIDE, ROLLOUT, EARTHQUAKE |
+| 2 | 41 | RHYHORN | FURY_ATTACK, SCARY_FACE, EARTHQUAKE, HORN_DRILL |
+| 3 | 42 | OMASTAR | BITE, SURF, PROTECT, SPIKE_CANNON |
+| 4 | 44 | ONIX | BIND, ROCK_SLIDE, BIDE, SANDSTORM |
+| 5 | 42 | KABUTOPS | SLASH, SURF, ENDURE, GIGA_DRAIN |
+
+Class attributes (`data/trainers/attributes.asm:101`): item1 `HYPER_POTION`,
+base reward 25, AI `AI_BASIC | AI_SETUP | AI_SMART | AI_AGGRESSIVE |
+AI_CAUTIOUS | AI_STATUS | AI_RISKY`, `CONTEXT_USE | SWITCH_SOMETIMES`. Camper
+base reward 5 (`data/trainers/attributes.asm:323`).
+
+**Wild encounters** - none.
+
+---
+
+## 3. Blockers and gates
+
+| Gate | Enforced by (file:label) | Requirement | Unlock condition |
+|---|---|---|---|
+| Route 19 boulders | `maps/Route19.asm:Route19ClearRocksCallback` (`4e:4f09`), six `changeblock ... $7a` writes under `callback MAPCALLBACK_TILES` | `EVENT_CINNABAR_ROCKS_CLEARED` | Set only by `maps/Route20.asm:Route20ClearRocksCallback` (`MAPCALLBACK_NEWMAP`) - i.e. by reaching Route 20 from the Cinnabar side. Nothing in this section can clear it; the FAQ is right that you must turn around. |
+| SNORLAX blocking the DIGLETT'S CAVE door | `maps/VermilionCity.asm` object at (34,8) with a `SPRITEMOVEDATA_BIGDOLLSYM` 2x2 footprint sitting directly under warp 10 at (34,7) | `EVENT_VERMILION_CITY_SNORLAX` clear = present | `disappear VERMILIONCITY_BIG_SNORLAX` at the end of `VermilionSnorlax`, which only runs after `startbattle` |
+| SNORLAX will not wake | `engine/events/specials.asm:358 SnorlaxAwake` | `wMapMusic == MUSIC_POKE_FLUTE_CHANNEL` **and** player on one of (33,8), (34,10), (35,10), (36,8), (36,9) | Pokegear radio tuned to knob 78 / "20.0" |
+| POKe FLUTE radio channel is static | `engine/pokegear/pokegear.asm:1487 .PokeFluteRadio` | not in Johto (`.InJohto`, landmark >= `KANTO_LANDMARK`) **and** `POKEGEAR_EXPN_CARD_F` set in `wPokegearFlags` | EXPN CARD, obtained earlier (Lavender radio director) |
+| Route 2 cut trees | tileset collision `COLL_CUT_TREE` (`constants/collision_constants.asm:16`), tested by `CheckCutCollision` (`engine/overworld/tile_events.asm:76`) | HM01 CUT + `ENGINE_HIVEBADGE` (`engine/events/overworld.asm:133 CutFunction.CheckAble`) | already held long before this section |
+| Diglett's Cave traversal | `maps/DiglettsCave.blk` geometry - the three pockets are joined only by warps 2<->5 and 6<->4 | none beyond walking | - |
+| Pewter Gym re-fight | `maps/PewterGym.asm:PewterGymBrockScript` `checkflag ENGINE_BOULDERBADGE / iftrue .FightDone` | badge not yet held | one-shot |
+| Pewter museum | no warp exists in `PewterCity_MapEvents`; only `bg_event 15, 9 PewterMuseumSign` | - | permanently closed in GS |
+
+---
+
+## 4. Bot checklist
+
+Coordinates are asm cell coordinates. "clear" / "set" refer to event flags.
+
+1. `ROUTE_19_FUCHSIA_GATE` -> `ROUTE_19`: walk warp 3/4 at (4,7)/(5,7).
+   Precondition: none. Expect to be stopped; `EVENT_CINNABAR_ROCKS_CLEARED` is
+   clear, so blocks `(6,6) (8,6) (10,6) (12,8) (4,8) (10,10)` are rock. Turn
+   around through warp 1 at (7,3).
+2. FLY to `VERMILION_CITY`. Precondition: `ENGINE_FLYPOINT_VERMILION` set.
+3. Open the Pokegear, RADIO card, tune the knob to 78 ("20.0"). Precondition:
+   `POKEGEAR_EXPN_CARD_F` set and the landmark is Kanto. Postcondition:
+   `wMapMusic == MUSIC_POKE_FLUTE_CHANNEL`.
+4. Close the Pokegear and walk to one of (33,8) / (34,10) / (35,10) / (36,8) /
+   (36,9). Face `VERMILIONCITY_BIG_SNORLAX` at (34,8) and press A.
+   Precondition: `EVENT_VERMILION_CITY_SNORLAX` clear.
+   Effect: `SnorlaxAwake` returns TRUE -> wild L50 SNORLAX with LEFTOVERS forced.
+5. Battle: catch or defeat. Either way, postcondition
+   `EVENT_VERMILION_CITY_SNORLAX` set (object removed) and
+   `EVENT_FOUGHT_SNORLAX` set. **Save before step 4** - a failed catch is not
+   repeatable.
+6. Optional: `VERMILION_CITY` warp 2 at (9,5) -> `VERMILION_POKECENTER_1F`, heal
+   and withdraw SNORLAX; back out warps 1/2 at (3,7)/(4,7).
+7. `VERMILION_CITY` warp 10 at (34,7) -> `DIGLETTS_CAVE` warp 1 at (3,33).
+8. `DIGLETTS_CAVE`: walk (3,33) -> (5,31) (warp 2, ladder). Land at (17,33).
+9. Walk the long cave (17,33) -> (3,3) (warp 6, ladder). Land at (17,3).
+   Optional en route: hidden `MAX_REVIVE` at (6,11),
+   flag `EVENT_DIGLETTS_CAVE_HIDDEN_MAX_REVIVE`.
+10. Walk (17,3) -> (15,5) (warp 3, door) -> `ROUTE_2` warp 5 at (12,7).
+11. `ROUTE_2`: item ball `ROUTE2_POKE_BALL3` at (19,2) = CARBOS.
+    Precondition `EVENT_ROUTE_2_CARBOS` clear; postcondition set.
+12. Warp 1 at (15,15) -> `ROUTE_2_NUGGET_HOUSE`. Talk to
+    `ROUTE2NUGGETHOUSE_FISHER` at (2,4). Precondition
+    `EVENT_GOT_NUGGET_FROM_GUY` clear and >=1 bag slot; postcondition set,
+    NUGGET in bag. Exit warps 1/2 at (2,7)/(3,7).
+13. Optional: fruit tree `ROUTE2_FRUIT_TREE` at (10,14) = PSNCUREBERRY (daily).
+14. CUT the tree covering cells (14-15, 18-19). Precondition: HM01 in bag and
+    `ENGINE_HIVEBADGE` set.
+15. Warp 3/4 at (16,27)/(17,27) -> `ROUTE_2_GATE` -> warps 3/4 at (4,7)/(5,7) ->
+    `ROUTE_2` warp 2 at (15,31). Still Route 2.
+16. Item ball `ROUTE2_POKE_BALL4` at (14,50) = ELIXER.
+    Flag `EVENT_ROUTE_2_ELIXER`.
+17. CUT the tree covering cells (12-13, 50-51), then head north.
+18. Battle `TrainerBugCatcherRob` - object at (10,45), facing left, sight 5.
+    Party L32 BEEDRILL / L32 BUTTERFREE. Postcondition
+    `EVENT_BEAT_BUG_CATCHER_ROB`.
+19. Battle `TrainerBugCatcherDoug` - object at (4,43), facing up, sight 5.
+    Party L34 ARIADOS. Postcondition `EVENT_BEAT_BUG_CATCHER_DOUG`.
+20. Optional pickups on the way north: item ball at (0,29) = DIRE_HIT
+    (`EVENT_ROUTE_2_DIRE_HIT`); item ball at (2,23) = MAX_POTION
+    (`EVENT_ROUTE_2_MAX_POTION`); hidden MAX_ETHER at (7,23), hidden FULL_HEAL
+    at (4,14), hidden FULL_RESTORE at (4,27), hidden REVIVE at (11,30).
+21. Battle `TrainerBugCatcherEd` - object at (5,5), facing right, sight 4.
+    Party L30 BEEDRILL x3. Postcondition `EVENT_BEAT_BUG_CATCHER_ED`.
+22. Walk off the north edge of `ROUTE_2` into `PEWTER_CITY`
+    (`connection north, PewterCity, PEWTER_CITY, -5`). Postcondition
+    `ENGINE_FLYPOINT_PEWTER` set by `PewterCityFlypointCallback`.
+23. Talk to `PEWTERCITY_GRAMPS` at (29,17) (he paces x 27..31 on y=17).
+    Precondition `EVENT_GOT_SILVER_WING` clear (Gold).
+    Postcondition: SILVER_WING in bag, `EVENT_GOT_SILVER_WING` set.
+    On Silver: RAINBOW_WING, `EVENT_GOT_RAINBOW_WING` and
+    `EVENT_TEAM_ROCKET_DISBANDED` set.
+24. Optional: warp 4 at (13,25) -> `PEWTER_POKECENTER_1F`. Heal at
+    `PEWTERPOKECENTER1F_NURSE` (3,1). Talk to `Chris` at (7,2) to trade a GLOOM
+    for RAPIDASH "RUNNY". Optional: fruit trees at (32,3) = ICE_BERRY and
+    (30,3) = MINT_BERRY.
+25. `PEWTER_CITY` warp 2 at (16,17) -> `PEWTER_GYM` (arrive at warp 1, (4,13)).
+26. Optional: battle `TrainerCamperJerry`, object at (2,5), facing right,
+    sight 3. L37 SANDSLASH.
+27. Talk to `PEWTERGYM_BROCK` at (5,1). Precondition `ENGINE_BOULDERBADGE`
+    clear. Battle `loadtrainer BROCK, BROCK1` (5 mon, L41-44).
+    Postconditions: `EVENT_BEAT_BROCK`, `EVENT_BEAT_CAMPER_JERRY`,
+    `ENGINE_BOULDERBADGE`.
+28. Exit warps 1/2 at (4,13)/(5,13) -> `PEWTER_CITY` warp 2; heal.
+
+---
+
+## 5. Port coverage
+
+| Beat | Port file | Status |
+|---|---|---|
+| All maps / warps / objects / bg events for this section | `src/import/RomExtractorGen2.lua` (`MAP_GROUP_COUNT = 26`, line 47; the group walk at line 527) | implemented - every Kanto group is extracted, so these maps are data, not hand-ported code |
+| `MAPCALLBACK_TILES` + `changeblock` (Route 19 boulders) | `src/script/gen2/Opcodes.lua:127` (`changeblock`), driver `tests/drivers/gold_map_callbacks.lua` | implemented |
+| `special SnorlaxAwake` | `src/script/gen2/Specials.lua:1562` `H.SnorlaxAwake`, with `Specials.SNORLAX_PROXIMITY` transcribing `.ProximityCoords` and `Specials.POKE_FLUTE_SONG = "Music_PokeFluteChannel"`; hooks `currentMusic` / `playerCell` at `src/world/gen2/World.lua:2712` and `:2723` | implemented |
+| POKe FLUTE radio channel (knob 78 / 20.0) + EXPN CARD gate | `src/ui/gen2/Pokegear.lua:812-815` (the `knob = 78` row, `ctx.inJohto` / `ctx.expnCard`) | implemented |
+| `BATTLETYPE_FORCEITEM` -> Snorlax holds LEFTOVERS | `src/world/gen2/World.lua:111` and `:4576` | implemented |
+| `loadwildmon` / `startbattle` / `reloadmapafterbattle` / `disappear` | `src/script/gen2/Vm.lua:806-841` | implemented |
+| Catching a wild mon (Ultra Balls on Snorlax) | `src/battle/gen2/Catching.lua` | implemented |
+| Trainer battles from `OBJECTTYPE_TRAINER` rows (Rob / Doug / Ed / Jerry) | `src/world/gen2/Trainers.lua`, `src/script/gen2/Vm.lua:806` (`loadtrainer`) | implemented |
+| Gym leader script shape (`checkflag`/`winlosstext`/`setflag ENGINE_BOULDERBADGE`) | `src/script/gen2/Vm.lua:208` (`setflag`/`clearflag`), `src/world/gen2/World.lua:1296-1340` (`engineFlags`) | implemented |
+| `BadgeTypeBoosts` - BOULDERBADGE boosting ROCK moves (`data/types/badge_type_boosts.asm`, `engine/battle/misc.asm:146 DoBadgeTypeBoosts`) | no match anywhere in `src/battle/gen2/` | **missing** (the Gen 1 port has its own badge table in `src/battle/Damage.lua:28`, but nothing in the Gen 2 battle path reads badges) |
+| Item ball pickup (Route 2 CARBOS / DIRE_HIT / ELIXER / MAX_POTION) | extracted into `obj.itemball` at `src/import/RomExtractorGen2.lua:2874` and `:2968`, but no consumer exists in `src/world/gen2/`; `src/script/gen2/CallAsm.lua:550` stubs `TryReceiveItem` with "wItemBallItemID / wItemBallQuantity are set by a script path this port does not run" | **missing** |
+| Hidden items (Diglett's Cave MAX_REVIVE, the four Route 2 hidden items, Vermilion FULL_HEAL) | `src/world/gen2/HiddenItems.lua`, wired at `src/world/gen2/World.lua:5291` and the ITEMFINDER path at `:3423` | implemented |
+| `verbosegiveitem` (NUGGET, SILVER_WING/RAINBOW_WING) | `src/script/gen2/Opcodes.lua:163`, `src/script/gen2/Vm.lua:501` / `:1201` | implemented |
+| `fruittree` (PSNCUREBERRY, ICE_BERRY, MINT_BERRY) | `src/script/gen2/Opcodes.lua:160`, `src/world/gen2/World.lua:1058` (`fruitTreeItem`) | implemented |
+| `trade NPC_TRADE_CHRIS` (GLOOM -> RAPIDASH) | `src/core/gen2/NpcTrade.lua`, `src/script/gen2/Opcodes.lua:155` | implemented |
+| `checkver` Gold/Silver split in `PewterCityGrampsScript` | `src/script/gen2/Vm.lua:774`, `src/world/gen2/World.lua:1287` (`gsVersion`) | implemented |
+| `setflag ENGINE_FLYPOINT_PEWTER` / `_VERMILION` and Fly | `src/world/gen2/World.lua:5628` | implemented |
+| CUT field move + HIVEBADGE check | `src/world/gen2/FieldMoves.lua` (badge table at lines 100-101) | implemented |
+| Bike allowed in `CAVE` (Diglett's Cave) | `src/world/gen2/Bike.lua` | partial - the file exists and comments the `hiddenitem`/BICYCLE interaction, but the `.CheckEnvironment` outdoor/CAVE/GATE test was not located; verify before relying on it |
+| `gettrainername` for the beaten-gym statue | `src/script/gen2/Vm.lua:407` | implemented |
+
+---
+
+## 6. Unresolved / verify by hand
+
+- **Brock's party order.** The FAQ lists Graveler, Omastar, Rhyhorn, Onix,
+  Kabutops. `data/trainers/parties.asm:270` `BrockGroup` is Graveler (41),
+  **Rhyhorn (41), Omastar (42)**, Onix (44), Kabutops (42) - slots 2 and 3 are
+  swapped relative to the FAQ. Levels and species set match.
+- **All the FAQ's prize money figures are exactly 4x the asm value.**
+  `ComputeTrainerReward` (`engine/battle/read_trainer_party.asm:300`) is
+  `base reward x last mon level`, with no multiplier. Brock 25 x 42 = 1050 (FAQ
+  says 4,200); Rob 4 x 32 = 128 (FAQ 512); Doug 4 x 34 = 136 (FAQ 544); Ed
+  4 x 30 = 120 (FAQ 480); Jerry 5 x 37 = 185 (FAQ 740). The FAQ's EXP figures
+  likewise do not come from GS. Treat the money/EXP numbers in this section as
+  belonging to a different game (most likely HeartGold/SoulSilver, which the
+  text references) and ignore them for a GS bot.
+- **"Viridian Forest".** The FAQ says the Max Potion is "in Viridian Forest".
+  There is no Viridian Forest map in `constants/map_constants.asm`; the
+  MAX_POTION is `ROUTE2_POKE_BALL2` at (2,23) on `ROUTE_2`, in the area the
+  forest used to occupy.
+- **"the man just to the right of the Pokemart".** `PEWTERCITY_GRAMPS` spawns at
+  (29,17) with a `WALK_LEFT_RIGHT` radius of 2 (so x 27..31); the mart door is
+  warp 3 at (23,17). He is to the right of the mart but not adjacent.
+- **"The Pokemon Center has a lady".** The trade NPC is `Chris`, sprite
+  `SPRITE_POKEFAN_M` at (7,2). Male sprite, name CHRIS.
+- **Which cut tree the FAQ means.** The two trees named in step 14 and step 17
+  above are inferred from the block dump of `maps/Route2.blk` plus the item/warp
+  positions; they are not labelled anywhere in asm. Three other `CUT_TREE`
+  blocks exist on Route 2 (see the cut-tree table) and one of those may be the
+  intended route instead. Verify with a real walk.
+- **Diglett's Cave pocket connectivity.** The three-pocket reading is derived by
+  hand from `maps/DiglettsCave.blk` block ids against
+  `data/tilesets/kanto_collision.asm`; the per-tile collision of the "long cave"
+  interior was not fully traced, only that every warp block is reachable within
+  its pocket. The FAQ's described route is consistent with it.
+- **"the route is cleared to Diglett's Cave and through Route 8".** Nothing in
+  `maps/VermilionCity.asm` or `maps/Route11.asm` gates Route 11 / Route 8 on the
+  Snorlax; the only thing `EVENT_FOUGHT_SNORLAX` unlocks outside Vermilion is the
+  right-hand Black Belt object in `maps/VictoryRoadGate.asm:119`. The Snorlax
+  blocks only the Diglett's Cave door tile at (34,7).
+- **"Keep around those four Ultra Balls"** and the Rest/Thunder Wave catch
+  advice are strategy, not asm; nothing enforces a ball count.
+- **`src/world/gen2/Bike.lua` CAVE permission.** Marked partial in section 5 -
+  the port file was read but the equivalent of `BikeFunction.CheckEnvironment`
+  (`engine/events/overworld.asm:1665`) was not located, so "you can bike through
+  Diglett's Cave in the port" is unverified.