更新 2.126

2026/6/16

Arena+ Multi Dark Aeon 目錄驗證器 CLI (`--validate`). 工作線 Jarvis-ARENA. MINOR (`RuntimeTools/ArenaMultiBossLab` 中的新功能：首個離線目錄 v2 驗證器)。新的 `RuntimeTools/ArenaMultiBossLab/CatalogValidator.cs` + `--validate [--catalog <path>] [--vanilla-root <btlRoot>]` 位於 `Program.cs`。5 項檢查：(1) `format/format_version`；(2) 必要的 per-row 欄位 (`token_mode`, `battle_token`, `base_template`, `battle_id`, `raw_monster_ids`, `gil_cost`, `progress_flag`, `rt2_status`, `risk`, `evidence`)；(3) `unlock_requires` 一致性 (每個旗標必須作為某個其他行上的 `progress_flag` 出現，包括 tier-level `unlock.requires`)；(4) 正規表達式 `0xXXXXXXXX` 用於 `battle_token`、每個插槽中的 `0xXXXX` 在 `raw_monster_ids` + anti-gap (佔用插槽之前的空插槽 = ERROR)；(5) `recipe` 指標參考一個現有檔案。可選的配方掃描，透過此相同 CLI 的子程序，搭配 `--dry-run`，當提供了 `--vanilla-root` 時（自動 re-runs `./recipes` 中的每個配方）。結束代碼：0 OK，4 目錄不一致，5 某個配方 dry-run 失敗。當前對 `spira-arena-catalog.json` 的執行：PASS 0 錯誤 / 0 警告，在 13 行 / 13 個不同旗標上。[先前：`v2.125.1.1`]

閱讀說明

YunaBETAREVISION

更新 2.125

2026/6/16

updateauroraJARVIS-AURORA

極光最終化彈道階段1：`aurora-calib-v2`探測器（CSV/JSON帶殘留身份/flipZ/yaw180 + height_0x534）。工作線 Jarvis-AURORA。MINOR（新功能：新的`ffxprobectl`模式，發射一個CSV+JSON產物，帶有新的residual-calibration模式；首次在結構化探測中配對`chunk3.monLive` × `actor+0x3B0` × `actor+0x534`）。實現極光計劃的階段1（`.cursor/plans/aurora_balistica.plan.md`）。遵循的規範： `docs/reverse/FFX_AURORA_CALIBRATION_PROBE_SPEC_2026-06-15.md`（XZ身份已於2026-06-05由IDA證明；Y殘留仍為RT2-pending）。模式： `ffxprobectl aurora-calib-v2 [--route <field> <group> <formation>] [--battle <id>] [--out <json>] [--csv <csv>] [--max-slots <N>]`（read-only，除了現有的MMF讀取窗口外，沒有`Arm(1, ...)`儀器化）。對於每個`monLive`插槽，最多到`min(monCount, max-slots=16)`：從`chunk3.monLive[s]`（`g_FFX_Battle_AreaChunk + ptr@+0x20 + 16s`）讀取XYZW，解析`actor[s] = 0x11334CC + 0xF90s`，讀取`actor+0x3B0`（世界XYZW）、`actor+0x3C0`（緩存XYZW可選）、`actor+0x534`（高度浮點數）。計算3個殘差：`identity = actor - chunk`、`flipz = actor - (cx,cy,-cz)`、`yaw180 = actor - (-cx,cy,-cz)`，包含分量`dx/dy/dz` + RMS（完整 + XZ-only）。接受（匹配A01）： `identity_rms_xz < 0.5` AND `identity_rms 5 < flipz_rms` AND `identity_rms 5 < yaw180_rms` -> `winner=identity`；替代方案僅在它們的rms<1.0時獲勝（不太可能的post-IDA — 發出「UNEXPECTED — 調查」警報）；如果actor_array無效/世界non-finite（消失/動畫中），則插槽被阻塞 — 情況`blocked-runtime-state`、NOT `fail`。輸出： JSON（預設`work/actor_overlay/aurora_calib_<battle_id>_<utcstamp>.json`）帶有合併的`verdict`（`identity-confirmed-live` / `ALERT-non-identity-winner` / `blocked-runtime-state` / `partial`）+ 一個`rows`陣列；並行的CSV，包含36列（qpc, battle_id, 路線字段/組/編隊, area_chunk_va, actor_array_va, slot, dict_id, chunk_xyzw, actor_xyzw, actor_cache_xyz, height_0x534, identity/flipz/yaw180_dx/dy/dz/rms, identity_rms_xz, 獲勝者, 原因）。構建： `dotnet build RuntimeTools/FfxDinput8Probe/ctl/Ctl.csproj -c Release` PASS (0 errors, only preexisting warnings CS8632/CS0219). Does not touch: probe DLL (`ffx-probe.dll`), offline gates, FfxHooksDll. Next phase: RT2 calib-v2 with Halyson on 4 golden battles (`azit03_00`, `bsil05`, `klyt00_00` + a control like `425/0/0`) — recipe in `docs/reverse/FFX_AURORA_FORCE_BATTLE_CALIBRATION_PROTOCOL_2026-06-15.md`. Phase 1 RT2 = N/A (probe build only); Phase 2 RT2 = blocked on human (Halyson).

閱讀說明

LuluBETAREVISION

更新 2.124

2026/6/16

updatemagic-dllJARVIS-MAGIC

Item Stack Cap 99→255: new `ItemStackCapHook` 位於 `FfxHooksDll` (new capability, flag-gated工作線 Jarvis-MAGIC。 MINOR (new capability: a new runtime hook + writer-like patch that lifts the per-slot stack cap above vanilla; first time we touch `FFX_Inventory_AddItem`）。 MCP on `FFX_recon.i64` 2026-06 -16 證明）：per-slot inventory limit is clamped in a single central function in `FFX.exe` 中的一個單一中央函式 — `FFX_Inventory_AddItem`@`0x003905A0` (IDA flat `0x7905A0`）— 透過 TWO `push 63h` 站點餵入通用輔助函式 `FFX_Math_ClampInt(v, 0, 99)`@`0x0039A0D0`。所有 14 個呼叫端（偷竊/丟棄/調合/商店/寶箱/事件/選單）全部匯集到這個函式 — 其他地方 copy-pasted clamp 。 No save-load （在 (proved on `FFX_Btl_PrepareSaveCommandState`@`0x786BC0`上證明：僅初始化空槽位，不重新限制現有數量）。儲存空間（1 位元組於 `QuantityBase+slot` 在存檔中 + `byte[112]` in RAM at `0xD30B5C`）已支援 0.. 255 無需重新分配。選擇的策略： byte-narrow patch CANNOT reach 255 (the `6A FF` push imm8 would be sign-extended 5 位元組跳板繞道 + 堆疊存根（與 `NovaSuperDamageHook`相同模式）。每個存根： `push imm32 <cap>` 取代原始 `push 63h`，重播被位移的 2..3 個位元組，透過 `jmp rel32` 返回至 `0x00390622`/`0x00390652`。上限可透過 `FFXHOOKS_ITEM_STACK_CAP` 環境變數設定（預設 255，限制在 1. .255）。閘控： `item_stack_cap_255.flag` （預設關閉 = 保留原版行為，自然的回歸測試）。 Sentinel bytes verified before patching: `kExpectedNew[5] = {6A 63 6A 00 53}` （站點 1 / 新槽位）和 `kExpectedExist[5] = {6A 63 8D 04 1E}` (site #2 / existing slot). Automatic rollback if the second site write fails (no half-installed states). PolyHook build PASS (11/11 cpp including the new `ItemStackCapHook.cpp`), Release DLL deployed (`932352→935936 bytes`，來自新鉤子的 +3584）。 `.i64` renames+comments applied (IDA GOLDEN RULE): `0x7905A0`→`FFX_Inventory_AddItem`， `0x79A0D0`→`FFX_Math_ClampInt`， `0x790500`→`FFX_Inventory_GetItemCount`， `0x784A90`→`FFX_Inventory_DebugMaxAll`， `g_CmdAggregateAvailArrays`→`g_FFX_InventoryAggregate`，以及對 `0x79061D`/`0x79064D` 的註解（附跳板配方的限制站點）。 UI verdict (from the spike): `safe-above-99-likely` （getter 回傳原始位元組而不重新限制；視覺風險 = 兩位數佈局可能在「100」以上溢出，但 `%d` 格式化器可處理三位數而不崩潰）。 UI patch not applied proactively — RT2 confirms. Phase 4 RT2 recipe with 6 scenarios (save-edit Quantity=200, steal/drop, shop buy, mix, Potion use, UI render) in `docs/reverse/FFX_ITEM_STACK_CAP_99_RESEARCH_2026-06-16.md` §8. In-game RT2 需要測試（H alyso n）。文件： `docs/reverse/FFX_ITEM_STACK_CAP_99_RESEARCH_2026-06-16.md`。新檔案： `RuntimeTools/FfxHooksDll/hooks/ItemStackCapHook.{h,cpp}`。受影響檔案： `shared/ffx_addresses.h` （10 個新的 RVA+常數）， `dllmain.cpp` (include + flag enablers + InstallItemStackCapHook inside `InstallHooks` + RemoveItemStackCapHook), `FfxHooksDll.vcxproj`， `build_hooks.ps1`。先前： `v2.123.5.0`]

閱讀說明

WakkaBETAREVISION

更新 2.123

2026/6/16

updatearenaJARVIS-ARENA

Arena+ Multi Dark Aeon 進度附屬檔案 + 讀寫器於 FfxHooksDll 中。工作線 Jarvis-ARENA。 MINOR：(a) 新增附屬檔案 `mods/Spira Reforge/arena/progress/spira-arena-progress.{json,schema.json}`（機密文件第15節結構 v1），包含 `flags{}` cleared/first_clear_utc/last_clear_utc/clear_count/evidence 以及選用的 `tier_lock_state{}`（LOCKED/READY/CLEARED）；以目錄中的 `progress_flag` 作為鍵值（`arena.dark.<slug>`）；README 文件說明瞭使用規則與目錄<->附屬檔案對應關係。(b) 新增模組 `RuntimeTools/FfxHooksDll/hooks/ArenaProgressSidecar.{h,cpp}` — best-effort JSON 讀寫器（無相依性），`ArenaProgress_Initialize/IsRowCleared/RecordCleared` 由 `arena_plus_progress.flag` 閘門控制（預設關閉），搜尋路徑 `$FFXHOOKS_ARENAPLUS_PROGRESS_PATH` -> `<DllDir>/mods/Spira Reforge/arena/progress/...` -> 備用 `<DllDir>/spira-arena-progress.json`。透過 `.tmp + MoveFileEx` 實現原子性持久化。環境變數 `FFXHOOKS_ARENAPLUS_FAKE_CLEAR=flag1,flag2` 讓開發者可手動為 UI 測試植入旗標。(c) `dllmain.cpp` 在 `ArenaProgress_Initialize` 中於目錄覆蓋後呼叫 `InstallHooks`。(d) 真正的勝利偵測仍為 NOT 接線 — 保留為有文件記載的 TODO；計畫第六階段承認此分裂，且公開的 API `ArenaProgress_RecordCleared(flag, note)` 已準備好供未來的 `battleEnd` 掛鉤消費者使用。PolyHook 建置 PASS 10/10 cpp。In-game RT2 需要 Test（經由 `FFXHOOKS_ARENAPLUS_FAKE_CLEAR`）。[先前：`v2.122.0.1`]

閱讀說明

WakkaBETAREVISION

更新 2.122

2026/6/16

updatearenaJARVIS-ARENA

Arena+ Multi Dark Aeon 目錄 v2 + DLL 讀取器 + 自訂令牌解析器原型。工作線 Jarvis-ARENA。 MINOR: (a) `mods/Spira Reforge/arena/spira-arena-catalog.schema.json` 從 v1 演進到 v2，每列新增了 `token_mode`/`base_template`/`raw_monster_ids`/`unlock_requires`/`rt2_status`/`risk`/`recipe`; (b) `spira-arena-catalog.json` 以 5 個層級填充 (單人9原版 + 雙人 + 三人 + 四人 + 五人擴展); (c) `FfxHooksDll/dllmain.cpp` 取得了 `ArenaPlus_LoadCatalogOverlay()` + `ArenaPlus_GetRoute(int)` 存取器：當 `arena_plus_catalog.flag` 已設定且找到 JSON 時，per-slot `battleToken`/`battleId`/label 會被覆蓋 (失敗時硬編碼的 `kArenaPlusBossRoutes[9]` 永遠優先); (d) 新掛鉤 `RuntimeTools/FfxHooksDll/hooks/ResolverLogHook.{h,cpp}` — 在 read-only 上進行 PolyHook `FFX_Field_ResolveEncounterToken@0x7828B0` 繞道，記錄 (token, result, outField, outGroup, outEntry)，受 `arena_plus_resolver_log.flag` 閘控; (e) RE 文件 `docs/reverse/FFX_ARENA_PLUS_CUSTOM_TOKEN_RESOLVER_HOOK_SPIKE.md`，附帶註解反編譯 (HIWORD = 欄位鍵，LOWORD 的低位元組 = 條目鍵，中間位元組 = 0)，4 個呼叫端，`g_EncounterFieldTable@0x112A9C8` + `g_EncounterGroupBlobBase@0x112A9CC` 的佈局，自訂令牌範圍規格 `0xA001..0xAFFF`，選項 A 的計畫 (pre-resolver 重新導向); (f) 重新命名和註解已套用至實際的 `.i64` (`work/reverse/ida/FFX_recon.i64`) — sub_79D1B0/D1E0/D190/D230 變成了 `FFX_Field_EncounterField/Group` (黃金規則)。 PolyHook 建置 PASS 9/9 cpp。

閱讀說明

WakkaBETAREVISION

更新 2.121

2026/6/16

updatearenaJARVIS-ARENA

競技場+ 多重黑暗 Aeon 製作工作線 (ArenaMultiBossLab + multi-alias 配方). 工作線 Jarvis-ARENA. MINOR: 新的 CLI `RuntimeTools/ArenaMultiBossLab` 確定性地應用配方 JSON — `chunk2` 透過 `FormationSlotWriter` (slot-only RT0) + `chunk3` 透過 `BattleArenaPositionWriter` (position-only RT0) 或 `BattleArenaGrowWriter` (monLive 增長上限為 8 個角色)，搭配 re-read 防護和 loose-file 部署加上 `.spiraforge.bak` 備份。有效配方：`dark_duo_valefor_ifrit`（別名 `kino00_70` / 令牌 `0x00DC0046`）。配方文件 + RT2 檢查清單範本 + multi-alias README 位於 `mods/Spira Reforge/arena/recipes/` 之下。策略：B（multi-alias）+ C（解析器鉤子 RE 作為平行工作線）+ content-first（雙人組 → 三人組 → 四人組，在目錄 v2 / DLL 讀取器之前）。基本檔案：`docs/reverse/FFX_ARENA_PLUS_MULTI_DARK_AEON_AUTHORING_DOSSIER_2026-06-16.md`。計畫：`.cursor/plans/arena_plus_multi_dark_aeon_.plan.md`。雙人組部署離線生成 RT0 PASS（7780 位元組 byte-identical 在 16 個區塊2位元組 + 48 個區塊3 monLive 位元組之外）；in-game RT2 需要測試透過 `_RT2_CHECKLIST.md`。[前一個：`v2.120.7.0`]

閱讀說明

LuluBETAPATCH

更新 2.120

2026/6/16

updatemagic-dllJARVIS-MAGIC

戰鬥 SFX 音頻工具捆綁並版本化。工作線 Jarvis-MAGIC。 MINOR: `vgmstream` + `fsbext` 位於 git under `tools/`; copied next to `.exe` on build; UI Repair audio tools only when missing; `tools/AUDIO_TOOLS_LICENSES.md`.

閱讀說明

LuluBETAMINOR

更新 2.119

2026/6/16

updatemagic-dllJARVIS-MAGIC

自訂戰鬥 SFX 階段 2：新的 seId 不覆蓋。工作線 Jarvis-MAGIC。 MINOR：`FsbDumpDatAppender` + `Fsb9999SampleAppendWriter` (FSB 子歌曲 +1 透過 dump.dat)；`FevLegacySequenceWriter` + `9999_common.txt` 側車行；`CommandSoundPackService.NewSeIdAudio` 三重部署 FEV+FSB+通用+DLL；核心指令新的 seId 插槽 UI；閘門 `--fsb9999-append-lab`、`--fev9999-sequence-clone-wave9`、`--command-sound-new-seid-pack`；I36 RE 文件；`work/.../wav/` 佈局 + 清理腳本。In-game RT2 待定。[先前：`v2.118.0.0`]

閱讀說明