Document stage collision, launcher, and replay paths

Author: FottenSC

docs/cookbook/custom-stage.md

@@ -41,9 +41,10 @@ Stub `ALuxBattleStage`, `ALuxBattleStageActorManager`, `ALuxStageMeshActor`,
 - `ALuxBattleStageActorManager` (it manages the 9 actor lists at
   `+0x388..+0x408` — see [Stage System](../sc6/stage-system.md))
 - 1+ `ALuxStageMeshActor` (visuals + collision)
-- 4–8 `ALuxStageBreakableBarrierActor` (invisible boxes — the ring-out
-  boundary; their box transforms become the gameplay-engine
-  `g_scbattle_StageInfo_BarrierArray` at match start)
+- `ALuxStageBreakableBarrierActor` placements covering the ring boundary.
+  The deterministic scbattle storage is a fixed 12-entry
+  `g_aScbattleStageInfoBarrierEntries` buffer at `0x144844070`; verify the
+  runtime entries after load rather than assuming every actor becomes one entry.
 - (Optional) `ALuxStageBreakableWallActor` (breakable walls)
 
 For collision on the visual meshes use Blender naming:
@@ -142,14 +143,19 @@ stage-code argument.
 - **No `LuxBattleStageInfoTableRow` data** — the global stage info table is
   similarly forgiving. Add a row only if you need custom Center/RingEdge/Wall
   configuration.
+- **Custom terrain/wall tags** — UE4 `BodySetup` and barrier actors are not the
+  serialized `J_StgHitChkData` terrain/wall grid. If your stage needs different
+  terrain heights, wall tags, or ring-edge tags, plan for a native hook that
+  substitutes the A/B `J_StgHitChkData` blobs before
+  `LuxBattle_AttachStgHitChkData @ 0x140392080`.
 - **Online play** — both peers need the mod installed and built identically.
   The host broadcasts the resolved stage code; the client's AssetManager
   must succeed at loading the same code or the match desyncs at stage load.
 
 ## Related
 
 - [Stage System](../sc6/stage-system.md) — full reference for the stage
-  pipeline, the two-tier collision system, master enum bias, and the
+  pipeline, collision storage, master enum bias, and the
   `LuxBattleStageInfoTableRow` schema.
 - [Replace a Stage](replace-stage.md) — even simpler if you don't need a new
   code, just custom geometry on a stock slot.

docs/cookbook/replace-stage.md

@@ -27,12 +27,14 @@ project — just inherit from `AActor` and give them the right names:
 - `ALuxBattleStage` (root)
   - `ALuxBattleStageActorManager` (manages the 9 actor lists at `+0x388..+0x408`)
   - 1+ `ALuxStageMeshActor` — visual + collision
-  - 4–8 `ALuxStageBreakableBarrierActor` — invisible boxes forming the ring boundary
+  - `ALuxStageBreakableBarrierActor` placements covering the ring boundary
   - 0+ `ALuxStageBreakableWallActor` — visible breakable walls (optional)
 
-The barrier boxes are the gameplay ring-out trigger — at match start their
-box-component extents are pushed into
-`g_scbattle_StageInfo_BarrierArray @ 0x144844070`.
+The deterministic ring-out boundary is stored separately in the fixed
+`g_aScbattleStageInfoBarrierEntries @ 0x144844070` buffer:
+12 `scbattle_BarrierEntry` records, `0xC0` bytes total. Barrier actors are still
+part of the stage setup path, but verify the runtime scbattle entries after load
+instead of assuming actor count maps one-to-one to barrier entries.
 
 For visual collision (camera, particles, character proximity), give each
 `ALuxStageMeshActor.StaticMesh` a custom `BodySetup`. Name the collision
@@ -52,7 +54,9 @@ UE4's FBX importer auto-routes these into `StaticMesh.BodySetup.AggGeom`.
 1. Save the level as `STG004.umap` at content path
    `/Game/Stage/STG004/Maps/STG004`.
 2. (Optional) Open the `StageInfoTable` .uasset in UAssetGUI and edit the
-   row for `STG004` if your ring shape differs from stock.
+   row for `STG004` if your spawn/camera/RingEdge metadata differs from stock.
+   This row does not replace the deterministic scbattle barrier buffer or the
+   `J_StgHitChkData` terrain/wall blob.
 3. Cook the project for Windows.
 
 ## Pack into a `_P.pak`
@@ -84,6 +88,8 @@ asset.
 3. Confirm the in-game ring-out boundary matches your `ALuxStageBreakableBarrierActor`
    placements. If characters fall through the floor, your `BodySetup` collision
    isn't cooking — verify the `UCX_`/`UBX_` prefix names on import.
+4. If wall/ring-edge behavior still matches the stock stage, inspect or hook the
+   `J_StgHitChkData` path documented in [Stage System](../sc6/stage-system.md#j_stghitchkdata-terrainwall-grid).
 
 ## Related
 

docs/reference/glossary.md

@@ -28,7 +28,7 @@
 | **ProcessEvent spy** | Diagnostic pattern: install a global `Hook::RegisterProcessEventPreCallback` and log each unique `(UClass, UFunction)` pair exactly once. Answers "which UFunctions fire during this one action?" without speculation. See [Global Hooks](../ue4ss/global-hooks.md). |
 | **GMalloc** | UE4's global `FMalloc*` pointer (shipping SC6: `DAT_1441971C8`). The thread-safe heap allocator shared by `FMemory::Malloc/Realloc/Free` and UE4SS's `RC::Unreal::GMalloc`. A mod that grows a game-owned `TArray` must use this same allocator; otherwise the component's later `Flush` frees a CRT-allocated buffer and corrupts the heap. |
 | **Stage code** | The string identifier for a stage (e.g. `STG001`, `STG011_R`, `STG006_V`). Routed to an asset path by `ResolveStageCodeToAssetPath @ 0x140641840` via substring matching on DLC keys (`014`, `_V`, `016`, `006_R`, `011_R`, `015`, `017`, `018`). Custom mod codes that avoid these substrings auto-route to `/Game/Stage/<code>/Maps/<code>`. Packed into an int by `ParseStageCodeStrToId`: bit 8 = `_R`, bit 9 = `_V`. See [Stage System](../sc6/stage-system.md). |
-| **StageInfoHandler** | `scbattle::StageInfoHandler` — the gameplay-side stage geometry interface, allocated by `LuxBattle_CreateStageInfoHandler @ 0x1403c3010`. Backed by globals at `0x144844010..0x144844158` (RngSeed, StageBoundaryParams, BarrierArray). Runs on the deterministic battle clock, separate from UE4 collision; this is what ring-out / wall-break tests actually consult. See [Stage System](../sc6/stage-system.md#two-tier-collision-gameplay-vs-visuals). |
+| **StageInfoHandler** | `scbattle::StageInfoHandler` — the gameplay-side stage geometry interface, allocated by `LuxBattle_CreateStageInfoHandler @ 0x1403c3010`. Backed by globals at `0x144844010..0x144844130` (RngSeed, StageBoundaryParams, 12-entry BarrierArray). Runs on the deterministic battle clock, separate from UE4 collision; ring-out also depends on the `J_StgHitChkData` terrain/wall grid. See [Stage System](../sc6/stage-system.md#stage-collision-storage). |
 | **Master stage enum** | `g_LuxStage_MasterEnumStringTable @ 0x144149c50` — the `TArray<FBattleStageEnumEntry>` (31 stock rows) that defines the entire stage roster. Statically built by `InitGlobalLuxStageMasterEnumStringTable @ 0x140149720`. Adding a new stage to the random-pool / picker UI requires hooking this initializer to append entries. See [Stage System](../sc6/stage-system.md#master-enum-table). |
 | **`_T` / `_R` / `_V` stage suffixes** | Variant codes on stock stages. `_T` = Anomaly (Story-mode tutorial-style alt arena, filtered out of the random pool). `_R` = Remix (DLC variant of a base stage). `_V` = DLC13 alt-VS variant. The random-map filter only strips `_T`; `_R` and `_V` survive, which is why STG006 / STG011 etc. roll 3× as often as singleton stages. See [Random-pool bias](../sc6/stage-system.md#random-pool-bias). |
 | **Steam Leaderboards (SC6)** | The actual storage backend for character usage stats and ranked-match scores. App ID `544750`. Six known leaderboards: `Characterboard` (per-character usage), `RankmatchWorld/Asia/America/Europe/Other` (regional ranked match). Publicly readable via Steam Web API — no game modification needed. See [Leaderboards](../sc6/leaderboards.md). |

docs/reference/symbol-index.md

@@ -74,6 +74,14 @@ the page link for full context.
 | `UDemoNetDriver_GotoTimeInSeconds` | `0x141E0ECA0` | [Replay System: scrubbing](../sc6/replay-system.md#scrubbing-a-match-replay-udemonetdrivergototimeinseconds) — UE4 native scrub for match replays |
 | `RegisterCVar_DemoGotoTimeInSeconds` | `0x140255B00` | [Replay System: scrubbing](../sc6/replay-system.md#scrubbing-a-match-replay-udemonetdrivergototimeinseconds) — CVar `demo.GotoTimeInSeconds` registrar |
 
+### Replay input serialization
+
+| Symbol | Address | Page |
+|---|---|---|
+| `LuxReplay_DecodeInputPackets_FromFile` | `0x1403ED310` | [Replay System: custom Lux input replay opcodes](../sc6/replay-system.md#custom-lux-input-replay-opcodes) — expands 3-byte packed records into decoded input records |
+| `LuxReplay_EncodeInputEvents_ToBuffer` | `0x1403ED980` | [Replay System: custom Lux input replay opcodes](../sc6/replay-system.md#custom-lux-input-replay-opcodes) — inverse encoder for Lux replay input streams |
+| `LuxReplay_WriteThreeByteInputRecord_ToBuffer` | `0x1403F62E0` | [Replay System: custom Lux input replay opcodes](../sc6/replay-system.md#custom-lux-input-replay-opcodes) — appends one packed opcode record |
+
 ### Move VM (outer command-script VM)
 
 | Symbol | Address | Page |
@@ -181,6 +189,19 @@ the page link for full context.
 | `LuxBattleManager_RegisterOnTickWhenPaused_Delegates` | `0x1403F8E70` | [Battle Manager: OnBattleTickWhenPaused](../sc6/battle-manager.md#onbattletickwhenpaused-what-still-ticks-during-setbattlepausetrue) |
 | `LuxBattleManager_BuildActorDependencyGraph_At28` | `0x1403F8A20` | [Battle Manager: subsystem dependency graph](../sc6/battle-manager.md#subsystem-dependency-graph) |
 
+### Battle launcher / match setup
+
+| Symbol | Address | Page |
+|---|---|---|
+| `ULuxUIBattleLauncher::Start` | `0x1405EEB50` | [Battle Manager: launcher startup](../sc6/battle-manager.md#battle-launcher-startup-path) — copies launch sub-tables into the BattleManager |
+| `ULuxUIBattleLauncher::GetBattleStageCode` | `0x1405B0C60` | [Battle Manager](../sc6/battle-manager.md#battle-launcher-startup-path) / [Stage System](../sc6/stage-system.md) — reads `StageSetting.StageCode`, defaults to `STG001` |
+| `ULuxUIBattleLauncher::SetSlipOutMode` | `0x1405ED550` | [Battle Manager: known leaf paths](../sc6/battle-manager.md#known-leaf-paths) — writes `BattleRule.SlipOut` |
+| `ULuxUIBattleLauncher::SetNoRingOutMode` | `0x1405ECC70` | [Battle Manager: known leaf paths](../sc6/battle-manager.md#known-leaf-paths) — writes `BattleRule.NoRingOut` |
+| `ULuxUIBattleLauncher::SetEndlessMode` | `0x1405EC390` | [Battle Manager: known leaf paths](../sc6/battle-manager.md#known-leaf-paths) — writes `BattleRule.Endless` |
+| `ULuxUIBattleLauncher::SetDamageUpMode` | `0x1405EC190` | [Battle Manager: known leaf paths](../sc6/battle-manager.md#known-leaf-paths) — writes `BattleRule.DamageUp` |
+| `ULuxUIBattleLauncher::SetBlowUpMode` | `0x1405EB7F0` | [Battle Manager: known leaf paths](../sc6/battle-manager.md#known-leaf-paths) — writes `BattleRule.BlowUp` |
+| `ULuxUIBattleLauncher::SetRecordMode` | `0x1405ED170` | [Battle Manager: known leaf paths](../sc6/battle-manager.md#known-leaf-paths) — writes top-level `BattleRecord` |
+
 ### Trace (visual weapon-trail)
 
 | Symbol | Address | Page |
@@ -222,7 +243,17 @@ the page link for full context.
 | `GetStageLocIdByStageCode` | `0x1406415B0` | [Stage System: key entry points](../sc6/stage-system.md#key-entry-points) |
 | `ApplyBattleSettingDataTableToBattleManager` | `0x140594EB0` | [Stage System: key entry points](../sc6/stage-system.md#key-entry-points) |
 | `LuxBattle_CreateStageInfoHandler` | `0x1403C3010` | [Stage System: key entry points](../sc6/stage-system.md#key-entry-points) |
-| `LuxActor_CollectActors_By8Classes_IntoTArrays` | `0x140417A70` | [Stage System: two-tier collision](../sc6/stage-system.md#two-tier-collision-gameplay-vs-visuals) |
+| `LuxActor_CollectActors_By8Classes_IntoTArrays` | `0x140417A70` | [Stage System: collision storage](../sc6/stage-system.md#stage-collision-storage) |
+| `GetScbattleStageInfoBarrierGeometry` | `0x1402D7730` | [Stage System: scbattle ring-boundary block](../sc6/stage-system.md#scbattle-ring-boundary-block) |
+| `SetScbattleStageInfoBarrierGeometry` | `0x1402D77C0` | [Stage System: scbattle ring-boundary block](../sc6/stage-system.md#scbattle-ring-boundary-block) |
+| `LuxStage_RegisterBarrierActor_BattleEvent0x19` | `0x140427490` | [Stage System: scbattle ring-boundary block](../sc6/stage-system.md#scbattle-ring-boundary-block) |
+| `LuxStage_RegisterWallActor_BattleEvent0x19` | `0x140428EE0` | [Stage System: scbattle ring-boundary block](../sc6/stage-system.md#scbattle-ring-boundary-block) |
+| `LuxBattle_SetFrameCacheHitChkDataPtrs` | `0x1402DAE70` | [Stage System: J_StgHitChkData terrain/wall grid](../sc6/stage-system.md#j_stghitchkdata-terrainwall-grid) |
+| `LuxBattle_ApplyFrameCacheHitChkDataSetup` | `0x1403CFC20` | [Stage System: J_StgHitChkData terrain/wall grid](../sc6/stage-system.md#j_stghitchkdata-terrainwall-grid) |
+| `LuxBattle_RefreshFrameTerrainCache` | `0x140314480` | [Stage System: J_StgHitChkData terrain/wall grid](../sc6/stage-system.md#j_stghitchkdata-terrainwall-grid) |
+| `LuxBattle_AttachStgHitChkData` | `0x140392080` | [Stage System: J_StgHitChkData terrain/wall grid](../sc6/stage-system.md#j_stghitchkdata-terrainwall-grid) |
+| `LuxBattle_SampleTerrainAtXZ_Impl` | `0x140391350` | [Stage System: J_StgHitChkData terrain/wall grid](../sc6/stage-system.md#j_stghitchkdata-terrainwall-grid) |
+| `LuxBattle_TestAndResolveWallCollision` | `0x140316600` | [Stage System: J_StgHitChkData terrain/wall grid](../sc6/stage-system.md#j_stghitchkdata-terrainwall-grid) |
 
 ### Audio / Voice
 
@@ -331,6 +362,14 @@ note on lazy extensions.
 | `FBatchedLine` | `0x34` | [structures](../sc6/structures.md#fbatchedline-0x34-bytes) |
 | `LuxBattleStageInfoTableRow` | `0x108` | [stage-system](../sc6/stage-system.md#luxbattlestageinfotablerow) |
 | `LuxBattleStageBasePositionParam` | `0x28` | [stage-system](../sc6/stage-system.md#luxbattlestagebasepositionparam) |
+| `scbattle_BarrierEntry` | `0x10` | [structures](../sc6/structures.md#scbattle-stage-info-globals) |
+| `scbattle_StageBoundaryParams` | `0x40` | [structures](../sc6/structures.md#scbattle-stage-info-globals) |
+| `scbattle_StageInfoParam` | `0x120` | [structures](../sc6/structures.md#scbattle-stage-info-globals) |
+| `FLuxBattleEventRecord` | `0x18` | [structures](../sc6/structures.md#stage-actor-registration-event-record) |
+| `LuxBattle_FrameCacheHitChkDataSetup` | `0x22` | [structures](../sc6/structures.md#j_stghitchkdata-frame-cache-setup) |
+| `J_StgHitChkData_Header` | `0x30` | [structures](../sc6/structures.md#j_stghitchkdata-serialized-terrainwall-blob) |
+| `J_StgHitChkData_CellHeader` | `0x10` | [structures](../sc6/structures.md#j_stghitchkdata-serialized-terrainwall-blob) |
+| `J_StgHitChkData_PoolChunk` | variable | [structures](../sc6/structures.md#j_stghitchkdata-serialized-terrainwall-blob) |
 
 ---
 
@@ -449,6 +488,15 @@ Layout source: [structures.md / ALuxBattleFrameInputLog](../sc6/structures.md#al
 | `0x1447123BC` | `g_LuxCharaAttrTable_Int_0x3038Stride` | Per-chara int table. | [Move System](../sc6/move-system.md#key-vm-globals) |
 | `0x1440F4750` | `g_LuxMoveStateTable` | Move-state ids, stride `0x14`, `0x29` rows. | [Move System](../sc6/move-system.md#key-vm-globals) |
 | `0x144149C50` | `g_LuxStage_MasterEnumStringTable` | `TArray<FBattleStageEnumEntry>` — 31 stock entries. | [Stage System: master enum table](../sc6/stage-system.md#master-enum-table) |
+| `0x144844010` | `g_scbattle_StageInfo_RngSeed` | Host-broadcast stage-info seed at the head of `scbattle_StageInfoParam`. | [Stage System: scbattle ring-boundary block](../sc6/stage-system.md#scbattle-ring-boundary-block) |
+| `0x144844020` | `g_sScbattleStageBoundaryParams` | 64-byte origin/spawn/facing parameter block. | [structures](../sc6/structures.md#scbattle-stage-info-globals) |
+| `0x14484406C` | `g_dwScbattleStageInfoBarrierValid` | Ring-boundary valid flag, not an entry count. | [Stage System: scbattle ring-boundary block](../sc6/stage-system.md#scbattle-ring-boundary-block) |
+| `0x144844070` | `g_aScbattleStageInfoBarrierEntries` | Fixed `scbattle_BarrierEntry[12]` deterministic ring-boundary buffer. | [Stage System: scbattle ring-boundary block](../sc6/stage-system.md#scbattle-ring-boundary-block) |
+| `0x14470D0D0` | `g_pLuxBattle_StgHitChkDataA` | Serialized `J_StgHitChkData*` attached into frame-bounds grid A. | [Stage System: J_StgHitChkData terrain/wall grid](../sc6/stage-system.md#j_stghitchkdata-terrainwall-grid) |
+| `0x14470D0F8` | `g_pLuxBattle_StgHitChkDataB` | Serialized `J_StgHitChkData*` attached into frame-bounds grid B. | [Stage System: J_StgHitChkData terrain/wall grid](../sc6/stage-system.md#j_stghitchkdata-terrainwall-grid) |
+| `0x14470DEDC` | `g_LuxBattle_FrameContextUseB` | Selects frame-transform/grid A vs B. | [structures](../sc6/structures.md#frame-bounds-grid) |
+| `0x144844DD0` | `g_LuxBattle_FrameBoundsGridA` | Live terrain/wall frame-bounds grid A. | [structures](../sc6/structures.md#frame-bounds-grid) |
+| `0x144845E80` | `g_LuxBattle_FrameBoundsGridB` | Live terrain/wall frame-bounds grid B, embedded in FrameTransformB at `+0xC60`. | [structures](../sc6/structures.md#frame-bounds-grid) |
 | `0x143E87838` | `KHitBase_vftable` | Vtable for the `KHitBase` family. | [structures](../sc6/structures.md#hit-detection-node-structs-khit) |
 | `0x1448554E8` | `g_LuxBattle_HitReactionSlideTable` | Per-hit-type slide-decay curves. | [Movement: code references](../sc6/movement.md#code-references) |
 | `0x14470E018` | `g_LuxBattle_YarareReactionParamBlock` (lazy-malloc'd) | The 1100-byte `FLuxBattleYarareReactionParamBlock` (per-intensity reach/knockback/weight tables). | [Reaction System](../sc6/reaction-system.md#fluxbattleyararereactionparamblock-1100-byte-global-param-table) |