Beta Update

Earlier beta notes, preserved as originally published.

This is the archive of earlier beta notes. New notes are on the main updates page.

Update 2.69

6/10/2026

Blitzball Recruits Editor: UI to change WHO is recruited at each location (game-file; writer `v2.67.0` proven). New module/tab `Blitzball Recruits 🏐` (`Modules/BlitzballRecruitEditor`) that edits free-agent recruitment straight in the game file: it lists the ~34 recruitment field events (Luca/Kilika/Guadosalam/Calm Lands/Airship/Besaid/…, corpus-derived via the signature `AE 28 00 14 AE <id> 00 A3`), and per event shows each recruit site with a dropdown of the 60 players (names resolved from `macrodic.dcp` via `BlitzballPlayerNames`) to re-point who is recruited there. It consumes the already-proven writer `BlitzballRecruit_File`/`Event_File.PatchScriptByte` (gate `--blitzball-recruit-rt0`) through a per-event `ByteSnapshotEditorSession` (save/undo/restore-original/auto-save, a mirror of the multi-source MacroExplorer). Registered in `Main_Window` (nav + `SetModule`). Honesty: "Writable (Lab)" badge — re-points the recruit's player-id only (game-file, no EXE patch; RT0 isolation proven, in-game RT2 pending); each player usually has 2 sites (two code branches) → change both to fully re-point; recruitment availability/gating stays in the event logic; player stats = the Blitzball Roster tab, names = Macro Explorer. MINOR (NEW module/tab; precedent: Blitzball Roster Editor `v2.68.0` = MINOR). Reuses the existing writer/`Event_File`/`MacroDictionary_File`/`BlitzballPlayerNames`/`ByteSnapshotEditorSession`; does not add a new writer or touch save/runtime/SIN/other lanes. Build 0 errors / 361 warnings; `--blitzball-recruit-rt0` PASS.

Read notes

SeymourBETAMINOR

Update 2.68

6/10/2026

updateruntime-hook

Blitzball Roster Editor: visual UI for the 60 players' stats/growth (game-file; writer `v2.66.0` proven). New module/tab `Blitzball Roster 🏐` (`Modules/BlitzballRosterEditor`) that visually edits the 60 players' stat-growth curves inside `bltz0002.ebp`: a player list (with read-only names resolved from `macrodic.dcp` via `BlitzballPlayerNames`) + an editor for the 8 stats (HP/SP/AT/EN/PA/SH/BL/CA), each with the 4 editable floats `a/b/c/growthType`, a live value preview at Lv 1/50/99, and the formula. It consumes the already-proven writer `BlitzballRoster_File` (gate `--blitzball-roster-rt0`) through `ByteSnapshotEditorSession` (save/undo/restore-original/auto-save, an exact mirror of `TreasureEditor`). Registered in `Main_Window` (nav + `SetModule`). Honesty: "Writable (Lab)" badge — writes the stat-growth tables only (RT0 byte-identity proven, in-game RT2 pending); names are read-only here (edit them in Macro Explorer); techs/level/EXP/cost are save-side; the match engine / technique effects are EXE-native (see the address map). MINOR (NEW module/tab; precedent: Blitzball Prize Explorer `v2.62.0` = MINOR). Reuses the existing writer/`Event_File`/`MacroDictionary_File`/`BlitzballPlayerNames`; does not add a new writer or touch other lanes/runtime/save/SIN. Build 0 errors / 361 warnings; `--blitzball-roster-rt0` PASS.

Read notes

SeymourBETAMINOR

Update 2.67

6/10/2026

updateruntime-hook

Blitzball: RECRUITMENT editable in the GAME FILE — ATEL immediate patcher in the `.ebp` (RT0 proven). Who gets recruited at each location is a 1-byte immediate in the field event's ATEL bytecode: the signature `AE 28 00 14 AE <playerId> 00 A3` (`PUSHII 40 · ADD · PUSHII <playerId> · write-array`) appends to YOUR team (`BlitzballTeamPlayers[count+40]`). New primitive `Event_File.PatchScriptByte` (1-byte patch of the ATEL chunk, length-preserving via `ScriptChunkOverride`) + `FfxLib/Blitzball/BlitzballRecruit_File.cs` (`FindSites`/`SetRecruit`/`SetRecruitAt`) + gate `Tools/BlitzballRecruitRt0.cs` (`--blitzball-recruit-rt0`). PROVEN on `guad0000.ebp`: 6 sites (Giera `0x1F`/Auda `0x22`/Nav `0x21` × 2 branches), no-edit Read→Write byte-identical (189,696 B), re-pointing Giera→Wakka (`0x1F`→`0x33`) isolated to 2 bytes at the predicted offsets, re-read confirms the new recruit. Signature validated vs `guad0000`/`lchb0000`/`hiku0500` (full Al Bhed Psyches). Honesty: changes WHO is recruited where (game-file, no EXE patch); recruitment availability/gating stays in the event logic. MINOR (NEW recruitment writer; first of its kind). Only ADDS files + 1 `Program.cs` dispatch; does not touch the save/runtime/SIN/other lanes. Build 0 errors / 361 warnings; `--blitzball-recruit-rt0` PASS. Doc: `docs/reverse/FFX_BLITZBALL_ENGINE_IDA_SCOUT_2026-06-10.md`.

Read notes

SeymourBETAREVISION

Update 2.66

6/10/2026

updateruntime-hook

Blitzball ROSTER (60 players' stats/growth) NOW EDITABLE in the GAME FILE — `.ebp` ATEL-variable writer PROVEN (RT0 byte-identical + mutation-isolated). The first writer that edits the blitzball base in a GAME FILE, not the save. The 60 players' base stats + growth curves live INSIDE `bltz0002.ebp` as ATEL variables `0x126..0x12E` (8 stats × 60 players × 4 floats `a,b,c,growthType`; growth formula decoded: `gt -1`→1, `0`→a+b·Lv, `1`→a+b·Lv^c, `2`→a+b·Lv−c·Lv², `3`→a+b·Lv+c·Lv²). New primitive `Event_File.PatchEventDataElement(varId, idx, bytes)` (`FfxLib/Event/Event_File.AtelVar.cs`): an in-place ATEL eventData-variable patcher, length-preserving via the existing `ScriptChunkOverride` hook → `Write()` re-packs byte-identical except the edited slice. New read/write file-class `FfxLib/Blitzball/BlitzballRoster_File.cs` (decodes/edits the 60×8 growth) + gate `Tools/BlitzballRosterRt0.cs` (`--blitzball-roster-rt0`). PROVEN: byte-exact read vs the FFXDataParser dump (player0 HP = `70 + 30·Lv + 0.711·Lv²`); no-edit Read→Write byte-identical (5,445,248 B); 480/480 growthType valid; a single-float patch isolated to the 4 target-element bytes at the predicted offset (`@0x491680`). RE (the missing piece): the variables' value-base = `worker0_header + 0x30` (robustly resolved, no hardcode). Honesty: ONLY stats/growth are file-data; names = string macro `0x700+idx` (writer exists, wiring pending), positions/technique-definitions/match-engine = EXE (IDA-pending), learned-techs/cost/contract/level/EXP = save (out of game-file scope). No UI yet (next = `BlitzballRosterEditor`). MINOR (NEW capability: first blitzball roster writer into a game file). Does not touch the save (CHAPPU/checksum), runtime, SIN, or other lanes; only ADDS new files + 1 `Program.cs` dispatch. Build 0 errors / 361 warnings; `--blitzball-roster-rt0` PASS (no-edit byte-identical + mutation isolated). Docs: `docs/reverse/FFX_BLITZBALL_ROSTER_BASE_RE_2026-06-10.md` + `docs/ai/BLITZBALL_100PCT_EDITOR_CHECKLIST_2026-06-10.md`.

Read notes

SeymourBETAPATCH

Update 2.65

6/10/2026

updatemonster-ai

PC/Player Growth in the Spira Data Atlas (read-only, `proved-candidate`, byte-grounded, work/-independent). Plugs the REAL source of PC growth/stats into the provider: new `SpiraDataAtlasDetailKind.PlayerGrowthStat` + value-guarded accessor `SpiraDataAtlasCatalog.TryGetPlayerGrowthStat(source, characterIndex, field, currentRawValue)`. Source = `ply_save.bin` (base/current stats) + `ply_rom.bin` (growth ROM: AP-requirement curve `ApReq A/B/C/Max` + per-stat auto-growth coefficients `CoefA/B`), the SAME tables the `PlayerGrowthEditor` edits (parser `PlayerKernel_File`, RT0-proved by `--player-rt0`). The 20 slots (0–6 PC, 7 guest=Seymour, 8–17 Aeons, 18–19 unmapped) come from a byte-grounded compiled table (`FfxLib/SpiraDataAtlas/PlayerGrowthData.cs`, generated by `tools/ffxdataparser_bridge/build_player_growth_index.ps1 -EmitCSharp` from the `.bin` files), so they exist in ANY build WITHOUT `work/` (unlike `PcAeonFineStat`, which depends on `work/pc_save_stats_catalog.csv` and is only a snapshot). Labels resolve at runtime via `Character_Enum` (single source of truth). Honesty (non-obvious): the stat-growth coefficients are Aeon-only — PC/guest slots carry ZERO coefficients (PCs grow stats via the Sphere Grid); the only PC growth knob in this ROM is the AP-requirement curve. This is a DIFFERENT axis from BRASKA's `sum_grow.bin` (auto-level ≠ customization recipe). REGION-SPECIFIC: `ply_save`/`ply_rom` are NOT locale-invariant (the `new_uspc` data section differs from jppc/inpc; compiled table = `new_uspc`, the region the editor loads). The in-game AP-per-level / per-coefficient gain formula is `RT2-pending` (bytes/fields proved, runtime arithmetic not reversed). Value-guard = same value-space the editor edits → editing the field (raw mismatch), or an unknown slot/source/field → accessor `false` → badge hides (mirror of Aeon/Shop/Mix). Gate `--spiraatlas-rt0` `21296 → 21316` (+20; all unique) + 18 new asserts (count 20/8/10/2; PC coef zero; Aeon coef non-zero; region uspc; lookup Tidus BaseHp 520 / ply_rom AP max 22000 / Valefor HpCoef 6; value-guard `9999` hides; out-of-range slot/source/field miss; domain search; BIBLE domain player-growth). Read-only: no writer/UI/runtime/SIN; does not touch `WriteSave`/`WriteRom`, the `PlayerGrowthEditor` UI, ANIMA's `Common` engine (consumed only), or BRASKA/AURON/JECHT/RIKKU/WAKKA/VALEFOR/AURORA/SIN. Build 0 errors / 361 warnings; `--player-rt0` + `--spiraatlas-rt0` + `--aicmdmeta-rt0` PASS. Docs: `docs/ai/ATLAS_TIDUS_PC_GROWTH_PROVIDER_RESULT_2026-06-10.md` + scout `docs/ai/ATLAS_TIDUS_PC_GROWTH_SCOUT_RESULT_2026-06-10.md`.

Read notes

SeymourBETA

Update 2.64

6/10/2026

updateruntime-hook

Aeon growth/customization in the Spira Data Atlas (read-only, `proved-candidate`, Aeon-only, compiled). Plugs `sum_grow.bin` (FFX's Aeon customization table) into the provider as a read-only detail kind: new `SpiraDataAtlasDetailKind.AeonGrowthRecipe` + value-guarded accessor `SpiraDataAtlasCatalog.TryGetAeonGrowthRecipe(entryIndex, currentResultRaw, currentItemRaw)`. Aeon-ONLY: `sum_grow.bin` is 636 bytes (`0x14` header + 77 × 8B entries, `Target` always `0x007F`=Aeon, `jppc`==`inpc` byte-identical) → 67 ability recipes (Result cat 3 → Commands) + 10 stat recipes (Result cat 0 → StatOptions, Secondary=1). No PC rows and no Sphere-Grid rows (`PcAeonFineStat` is a separate corpus; grid topology lives in `sphere.bin`/`panel.bin`). Non-`work/` source: the 77 rows come from a byte-grounded compiled table (`FfxLib/SpiraDataAtlas/SumGrowAeonRecipeData.cs`, generated by `build_sum_grow_aeon_fine_index.ps1 -EmitCSharp` from `sum_grow.bin`), so they exist in ANY build without `work/` (unlike Mix/Sphere/Shop). Names/labels are resolved at runtime by the editor's own `AeonCustomizationEntry`+dictionaries (single source of truth, RT0-proved by `--customization-rt0`), never re-invented. Stat-recipe cost = `partial` (the editor renders `Primary× item`; in-game cost is 1 item/application and `Primary` is the increment) — surfaced in the `evidence` column (`;cost-semantics-partial`), not just prose. Gate `--spiraatlas-rt0` `21219 → 21296` details (+77 Aeon; all unique) + 13 new asserts (count 77/67/10; Aeon-only; no PC; no Sphere; ability lookup 66→Ultima/Supreme Gem; stat lookup 67→HP+100/Power Sphere/cost-partial; value-guard `0x9999` hides; out-of-range index miss; domain search; BIBLE domain aeon-growth). Read-only: no writer/UI/runtime/SIN; does not touch RIKKU/WAKKA/JECHT/BAHAMUT/AURORA, ANIMA's `Common` badge engine, or `WriteAeon`/save paths. Unblocks YUNA backlog Q1 (was `blocked`). Verified by a 4-lens adversarial workflow in the scout. Build 0 errors / 361 warnings; `--customization-rt0` + `--spiraatlas-rt0` + `--aicmdmeta-rt0` PASS. Docs: `docs/ai/ATLAS_BRASKA_SUM_GROW_FINE_SCOUT_RESULT_2026-06-10.md` + `docs/ai/HANDOFF_BRASKA_SUM_GROW_FINE_INDEXER_NEXT_2026-06-10.md`.

Read notes

SeymourBETA

Update 2.63

6/10/2026

updateruntime-hook

Mix detail kind in the Spira Data Atlas (read-only, `proved-candidate`, value-guarded). The first honest Mix anchor in the Atlas: new `SpiraDataAtlasDetailKind.MixCombination` + accessor `SpiraDataAtlasCatalog.TryGetMixCombination(originIndex, partnerIndex, currentRawResult)` plugging the parser-canonical dataset `work/step0_consolidated_v5/mix_combinations.csv` (6,328 rows = 112×113/2, 0 duplicate keys) into the provider. `prepare.bin` is a 112×112 lower-triangular matrix (origin `O` carries non-zero results only in partner slots `0..O`), so each unordered pair `{a,b}` lives at exactly one canonical cell origin=max, partner=min; the key `mix:0x{0x2000+max}+0x{0x2000+min}` is reconstructible from the editor's `(origin, partner)` indices with no guessing. `result_hex` is the SAME little-endian word the editor reads as `MixResultRow.RawResult` (editor reader byte-identical per `--mixtable-rt0`; parser same endianness) → value-guard = same-space integer compare: editing the outcome breaks the match and hides the badge (no stale); an empty cell (raw 0, including every upper-triangle mirror) short-circuits. SINGLE SOURCE: value-dict + detail come from the same CSV. Gate `--spiraatlas-rt0` `14891 → 21219` details (+6,328 Mix; all unique) + 8 new asserts (count 6328; lookup 0+0→Ultra Potion `0x30AC`; canonical order `(3,1)==(1,3)`; value-guard `0x9999` hides; empty raw-0 miss; out-of-range index miss; domain search; BIBLE domain mix). Read-only: no writer/UI/runtime/SIN; does not touch the Mix editor (writer), Treasure/Shop (RIKKU), ANIMA's `Common` badge engine (consumed via search only), or Aurora/Bahamut/native-menu. Unblocks YUNA backlog Q2 (was `blocked`). UI badge wiring = next handoff (`docs/ai/HANDOFF_JECHT_MIX_ATLAS_PROVIDER_NEXT_2026-06-10.md`). Build 0 errors / 361 warnings; `--spiraatlas-rt0` + `--aicmdmeta-rt0` PASS. Doc: `docs/ai/ATLAS_JECHT_MIX_DETAIL_KIND_SCOUT_RESULT_2026-06-10.md`.

Read notes

SeymourBETA

Update 2.62

6/9/2026

updateruntime-hook

Blitzball Prize Explorer: dedicated read-only Atlas UI. New `Modules/BlitzballPrizeExplorer` module (Blitzball Prizes 🏐 tab in the Reference/RE group, no project gate) that consumes the already-closed catalog `SpiraDataAtlasCatalog.BlitzballPrizeDetails` (domain `blitzball-prize`): a searchable DataGrid with prize id · takara index · resolved reward · kind · evidence columns, status/evidence and kind filters, a banner with the RULE `prize 0..100 -> takara 220..320 -> reward` (proved-candidate offline), and a detail panel with origin/rule/"where it appears"/limitations + `<common:AtlasEvidenceBadgeStrip>` (Atlas/BIBLE badges). Honesty preserved: treasure = `proved-candidate` (never RT2); the 64 league/tournament/event script-sites show explicitly as `blocked` (the per-event prize is runtime/save); tech = `partial`; overdrive = `metadata-only` — nothing goes green beyond the current label. New tiny read-only accessor `SpiraDataAtlasCatalog.BlitzballPrizeDetails` (lazy, dev `work/` only) + 2 `--spiraatlas-rt0` asserts (229 rows = 164 catalog + 64 sites + 1 guardrail; domain check). No writer, no runtime; does not touch RIKKU/Shop/Treasure/Mix, ANIMA's `Common` engine (consumed only), or Aurora/Bahamut/SIN. Build 0 errors / 361 warnings; `--spiraatlas-rt0` + `--aicmdmeta-rt0` PASS. Doc: `docs/ai/ATLAS_WAKKA_BLITZBALL_UI_RESULT_2026-06-09.md`.

Read notes