Platinum stability, EU/German Platinum and Renegade Platinum support, gamepad lower-screen cursor

README.md

@@ -22,7 +22,7 @@ items, and the Gold/Silver title sequence.
 It has since grown well past Generation II. The same launcher now imports and
 runs **FireRed** and **Emerald** (Gen 3), **Platinum**, **HeartGold** and
 **SoulSilver** (Gen 4), and **Black** and **White** (Gen 5), plus the
-**Polished Crystal** and **Prism** romhacks — all side by side, all from your
+**Polished Crystal**, **Prism** and **Renegade Platinum** romhacks — all side by side, all from your
 own cartridge dumps. Around the games sit the **Monster Walker** (a
 next-gen Pokéwalker with minigames and a Watt Shop), a **Map Editor**, a
 **Save Editor**, machine **translation** into 25 languages, **cloud saves**,
@@ -80,10 +80,18 @@ revision) so you know why — see [docs/rom-revisions.md](docs/rom-revisions.md)
 | Emerald | GBA | Alpha | `f3ae088181bf583e55daf962a92bb46f4f1d07b7` |
 | Platinum (Rev 1) | DS | Pre-alpha | `0862ec35b24de5c7e2dcb88c9eea0873110d755c` |
 | Platinum (Rev 0) | DS | Pre-alpha | `ce81046eda7d232513069519cb2085349896dec7` |
+| Platinum (Europe, English) | DS | Pre-alpha | `8d15cd443d4e83e20493c79d3f9dc408c4f51ae0` |
+| Platin Edition (Germany) | DS | Pre-alpha | `5d009a175c77d4387cde26d34efb71aee825a938` |
 | HeartGold (USA) | DS | Pre-alpha | `4fcded0e2713dc03929845de631d0932ea2b5a37` |
 | SoulSilver (USA) | DS | Pre-alpha | `f8dc38ea20c17541a43b58c5e6d18c1732c7e582` |
 | Black (USA/EU) | DS | Pre-alpha | `26ad0b9967aa279c4a266ee69f52b9b2332399a5` |
 | White (USA/EU) | DS | Pre-alpha | `bc696a0dfb448c7b3a8a206f0f8214411a039208` |
+| Renegade Platinum (over Platinum USA Rev 1) | DS | Pre-alpha | `381f9eef44564602a5f6469ee8c390fbb8ebac3a` |
+
+All four Platinum dumps import as the same game and share one save. The
+German cartridge plays in German (its own text, names and localized art); the
+European one is the US game with the European Game Corner. See
+[docs/rom-revisions.md](docs/rom-revisions.md#platinum-europe-and-germany).
 
 HeartGold, SoulSilver, Black and White dumps that have had their trailing `FF`
 padding trimmed are also accepted, as long as every game byte is intact — see
@@ -123,6 +131,10 @@ Everything below arrived since this README was last updated.
   including Professor Juniper's intro in BW — as **PRE-ALPHA** builds.
 - **Polished Crystal** (beta) and **Prism** (experimental) romhacks, with
   audio, overworld rendering and feature-parity fixes.
+- **Renegade Platinum** (pre-alpha) imports as its own game on the Platinum
+  engine. It has the hack's species, moves, trainers and encounters, the
+  Fairy type (its chart, names and icons) and its 1/512 shiny odds. See
+  [docs/renegade-platinum.md](docs/renegade-platinum.md).
 - **Mass ROM import**: pick a folder's worth of dumps at once.
 
 ### Monster Walker

docs/controller.md

@@ -0,0 +1,61 @@
+# Xbox controller (Gen 4 and the launcher)
+
+SDL game-controller mapping through `love.gamepad*` (an "Xbox One For Windows"
+pad reports as a gamepad; the triggers arrive as axes and are edge-detected at
+0.5 / 0.3 in `Input.AXIS_BUTTONS`). Raw `joystick*` events are used only for
+sticks SDL has no mapping for.
+
+| Xbox | Action | Gen 4 meaning |
+|---|---|---|
+| A | A | confirm / talk / tap (cursor mode) |
+| B | B | cancel; hold to run in the field |
+| Y (north) | X | field start menu (DS X) |
+| X (west) | Y | registered key item (DS Y) |
+| Start | Start | start menu |
+| Back/View | Select | Select (reorder moves / bag items, Pokétch clear) |
+| LB | L | raises the Pokétch from the field (L or B lowers it) |
+| RB | R | next Pokétch app; camera tilt in the field |
+| D-pad / left stick | directions | move, menus (held = repeat) |
+| RT | TOUCH | toggle the lower-screen cursor (below) |
+| LT | CHAT | online chat only |
+| L3 / R3 | zoom out / in | field zoom |
+
+All rows are rebindable in the CONTROLS screen (pad capture works for buttons,
+triggers and right-stick directions; the TOUCH row is new).
+
+## Left stick
+
+Press at 0.5, release under 0.3. Eight-way input maps to four directions with
+a 1.3x diagonal bias: a held direction keeps its axis until the other axis is
+clearly stronger, so a 45-degree wobble does not flip between two directions.
+With two controllers the one deflected furthest drives the stick; each pad has
+its own button sources, so two pads holding a button are one press and the
+button stays held until both release.
+
+## Lower-screen cursor (the DS touch screen)
+
+RT toggles a crosshair in the bottom screen's 256x192 space (dual-screen games
+only). While it is on: left stick and D-pad move it (the stick is quadratic for
+fine control), A presses and drags (hold A and move), and every other button
+keeps its normal job (B still backs out). It maps through
+`SecondScreen.fromLocal`, the inverse of what every screen's touch handler
+already does, so it works in swap, inset, vertical/horizontal and `display`
+modes and drives every pointer-only screen: Pokétch apps (drawing pad,
+dowsing, calendar, calculator, roulette, move tester, party apps), the battle
+bag/party touch screens, Underground, contest and photo dress-up, Poffin
+cooking, mining, naming-screen touch keys. It switches itself off whenever the
+top screen changes (so the stick can never stay stolen), and refuses to start
+over the field when no lower screen is showing.
+
+Pokétch without the cursor: LB opens it, D-pad left/right or RB change app, A
+presses the app's main button, B/L/Start close.
+
+## Hotplug
+
+`love.joystickadded` is forwarded (the touch overlay steps aside); removal
+resets input and lifts the virtual finger. Controllers added or reconnected
+mid-game send ordinary gamepad events.
+
+## Tests
+
+`python tools/run_lua_check.py tools/gen4_xbox_pad_check.lua`

docs/gen4-platinum.md

@@ -106,6 +106,12 @@ Rev 0 (`ce81046eda7d232513069519cb2085349896dec7`) is registered as an
 alternate hash. pokeplatinum builds both and the filesystem layout is the same
 in each, which is what the extractor reads.
 
+The English European cartridge (`8d15cd44…`, CPUE rev 10) and the German
+Platin Edition (`5d009a17…`, CPUD) are alternates too. The German build moves
+its 32 language archives under `/resource/ger/`, which
+`src/import/Gen4Regions.lua` answers at the filesystem. See
+[rom-revisions.md](rom-revisions.md#platinum-europe-and-germany).
+
 ### Files that will matter
 
 | Path | Bytes | What |

docs/platinum-parity-progress.md

@@ -2135,3 +2135,58 @@ it is the clock exclusion); nothing animating that is not on those lists, since
 the union only ever adds; no prop drawn twice, since twelve models have just
 changed pass; and a stutter check on a waterfall route or in Canalave, for the
 14 extra chunks today and 41 after the flipbooks land.
+
+## Story playthrough pass (November 2026)
+
+The automated playthrough (`tools/gen4_playthrough/platinum.lua`, 78 beats from
+the bedroom to the Hall of Fame) passed every beat on a USA Rev 1 cache before
+this pass. The fixes below come from what the log showed while the beats still
+passed — scenes that played to missing actors, no-op commands, stalls — and
+from the beats added past the credits. Each is checked against pret's
+pokeplatinum.
+
+- **Cynthia rides the Distortion World lifts.** 1F's lift (progress 2) and
+  B6F's (progress 7) carry Cynthia down with the player
+  (`DistWorldElevatorPlatform_BeginMovement` / `_ChangeMaps`): the same map
+  object, renumbered for the next floor (B1F 128; B7F 128 with script 6). The
+  next floor's object table has no Cynthia for that moment, so B1F's and B7F's
+  first-entry scenes moved a local id that was not there ("no object with
+  localId 128") and played to an empty platform. `Gen4DistPlatforms` now
+  takes the passenger at the start of the ride, lifts her with the platform,
+  and places her on the arrival floor at the world tile she rode on (B7F: she
+  then walks to exactly the tile B7F's own table gives her at progress 8).
+  Check: `tools/gen4_dist_surface_check.lua <cache>/data/generated` (53).
+- **The playthrough now goes past the credits** (91 beats, all passing in one
+  unbroken run on USA Rev 1). New beats: Eterna Forest with Cheryl as the
+  partner (her two-on-two trainers, the Soothe Bell); the Elite Four and the
+  Champion walked room to room — out by the door each win removes, up each
+  lift room's `TriggerPlatformLift`, walked in by the next room's frame
+  script — instead of teleported into; the credits to the title and a
+  CONTINUE at the house 2F (Mom's post-game scene); the National Dex at
+  Rowan's lab (a cheat, said as one: the Sinnoh dex marked seen); the
+  S.S. Spiral (Cynthia's send-off) to the Fight Area; Barry, Palmer and Buck
+  there; Route 227 (Crasher Wake and Barry, Buck's patrol request); Stark
+  Mountain — the grunts, Mars and Jupiter, Buck as the partner through room 2
+  (Rock Smash at (41,15), the Strength boulder at (29,12) pushed to (48,12),
+  his multi battles), Charon's arrest and Looker outside; the Battleground's
+  Buck; Heatran. Trainer-defeated flags are read from `save.gen4TrainerFlags`
+  (where the port keeps TRAINER_DEFEATED_FLAGS_START + id), not `save.flags`.
+- **`PT_CONTINUE=1`** (tools/gen4_playthrough/runner.lua): save and continue
+  between every two beats — the field's `captureSave`, the save through the
+  codec, and `Game:restoreSave` as the title's CONTINUE — so each beat runs on
+  what a reload brings back. Off by default; shared by every game's beats.
+- **Platinum Pokémon have a met location again.** The cartridge stamps a
+  caught, given or hatched Pokémon with the map's label
+  (`MapHeader_GetMapLabelTextID`, a place-name bank 433 index; egg_hatch.c,
+  field_battle_data_transfer.c). The port passed `BattleState.metHere`, a
+  Gen 3 region-map section that is nil on every Gen 4 map, so every Platinum
+  Pokémon was met nowhere: the Hall of Fame at the end of the story printed
+  "Met at ." and the summary left the line out. `Gen4Origin.stamp` now takes
+  the label of the map the player is on (the live field map — `save.player.map`
+  is only written by a save, so it named wherever the last save was: the
+  starter came out "met in Twinleaf Town"), and the Hall of Fame and the
+  summary name a numeric location from bank 433 (which also names the
+  locations NDS-imported Pokémon carry). HeartGold/SoulSilver, whose place
+  names are another bank, are left as they were. The starter now reads
+  "Route 201, Lv. 5". Check: `tools/gen4_met_location_check.lua
+  [<cache>/data/generated]` (13).