Document Batch 4D archaeology and add README title image outside LFS.

Exclude REALMSINRUIN_TITLE_DEV.png from Git LFS so the README hero renders on Gitea.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-07-16 23:17:56 -07:00
co-authored by Cursor
parent e028e16f70
commit ee65271212
11 changed files with 501 additions and 215 deletions
+67 -57
View File
@@ -5,16 +5,16 @@
- **Scope:** Authoritative cross-model continuation document for Phase 1.
- **Last updated:** 2026-07-16
- **Current phase:** Phase 1 — Static Architecture
- **Last completed pass / batch:** Batch 4C (Pass 9)
- **Next authorized work:** Wait for user — recommend **Batch 4D** (Pass 4 sessions and/or Pass 10 pickups) as separately authorized
- **Last completed pass / batch:** Batch 4D (Pass 4 + Pass 10)
- **Next authorized work:** Wait for user — **Pass 11** (synthesis / executive summary / Ability Migration Matrix) only when explicitly authorized
## Phase completed
| Item | Value |
|------|--------|
| Phase | Phase 1 — Static Architecture (in progress) |
| Batch completed | Batch 4CEnemy AI static analysis |
| Passes completed | Pass 9 |
| Phase | Phase 1 — Static Architecture (in progress; static archaeology complete pending Pass 11) |
| Batch completed | Batch 4DFrontend/sessions + UI/HUD/pickups |
| Passes completed | Pass 4, Pass 10 |
| Date completed | 2026-07-16 |
| Model identifier | Cursor Grok 4.5 |
@@ -22,46 +22,54 @@
## Repository integrity
### Starting state (Batch 4C)
### Starting state (Batch 4D)
- **Git:** Clean (`git status --short` empty; diffs empty).
- **Baseline includes:** `e50c8032` Batch 4B Pass 7 GAS archaeology.
- **Git:** Clean (`git status --short` empty; `git diff` / `git diff --cached` empty).
- **Authorization gate:** Batch 4C committed; Migration-Notes resolved; working tree empty before investigation.
- **Editor:** `IsPIERunning=false`; level `/Game/_Main/Levels/Testing/Test01`; selected actor `BP_Enemy_Skeleton_C_1`.
### Ending state (Batch 4C close)
### Ending state (Batch 4D close)
- Modified files: Markdown under `Documentation/Archaeology/` (listed below).
- **Unexpected working-tree changes (not caused by Pass 9; not reverted):**
- Deleted: `Migration-Notes/UE54-Baseline.md`
- Untracked: `Documentation/Migration-Notes/`
- No Unreal assets, source, config, plugins, or maps modified by this batch.
- PIE not started; level and selection unchanged.
- Ending Git: Archaeology Markdown dirty **plus** the unexpected Migration-Notes paths above.
- Modified files: Markdown under `Documentation/Archaeology/` only (listed below).
- Temporary scratch files `_tmp_pass4.txt` / `_tmp_pass10.txt` deleted if present.
- No Unreal assets, source, config, plugins, or maps modified.
- PIE not started; level and selection unchanged at closeout check.
- Ending Git: Archaeology Markdown dirty only (expected before user commit request).
---
## Areas fully inspected (Batch 4C)
## Areas fully inspected (Batch 4D)
- `ARIRBaseEnemyCharacter` / `ARIRBaseCharacter` GetASC / `ITargetInterface`
- `BP_EnemyCharacterBase` + `BP_Enemy_Skeleton` EventGraphs, GetEnemyREF, CDO control
- `BPI_EnemyCharacter` (GetEnemyREF / AddPlayerTarget / EnemyMeleeAttack)
- Placed `BP_Enemy_Skeleton_C_1` controller/possession props
- Project-wide BT/BB/StateTree/EQS/AIPerception/AIController subclass searches
- Test01 NavMeshBoundsVolume / RecastNavMesh absence
- `ABP_Skeleton` EventGraph + deps; `Anim_SkeletonAttackMontage` referencers
### Pass 4
- `GI_Dungeoneer`, `GM_MainMenu`, `GM_Dungeoneer`, `PC_MainMenu`, `PC_Character`
- `WBP_MainMenu`, `WBP_GameSlot`, `WBP_CharacterSelect`, `BP_MainMenuPawn`
- Session create/find/join completion/failure pins
- Maps MainMenu, Test01, Dev_Island, LEVEL_01 (GameMode via deps)
- `Config/*.ini` OnlineSubsystem / Steam / GameInstanceClass grep (negative)
- Example AdvancedSessions BP referencers
### Pass 10
- `WBP_PlayerHUD` CDO Overlay classes; `WBP_Overlay` tree + bar bindings
- `BP_OverlayWidgetController` (empty BP; native parent)
- `BPI_PlayerController` UpdatePlayerHUD / AddGold implementation status
- Four `RIREffectActor` pickups EventGraphs + CDO GE / replicate
- `BP_BasePickUp` / `BP_SmallGoldPickUp` gold + DEPRECATED health/mana paths
- UI inventory (pause missing; W_HUD_OLD unreferenced creator)
- Test01 placed pickup counts
## Areas partially inspected
- `BP_Enemy_Skeleton_C_0` (presence only)
- ABP Death transition pin details (AnimGraph DSL empty)
- CharacterMovement orient flags (partially unreadable)
- JoinSession internal travel (no explicit success pin)
- Remote-client character-select (server-only CreateWidget)
- Sphere collision profile / GenerateOverlapEvents (tool limit)
- LEVEL_01 menu reachability (no OpenLevel referencer found)
- WBP_BannerMessage / GameStats widgets (existence only)
## Areas not yet inspected
- Pass 4 frontend/sessions
- Pass 10 full pickup deep dive
- Pass 11 migration matrix
- PIE / runtime
- **Pass 11** synthesis / `01-ExecutiveSummary` / `07-AbilityMigrationMatrix`
- PIE / standalone / multiplayer runtime
- Full CommonUI content usage
---
@@ -69,43 +77,45 @@
| File | Status |
|------|--------|
| Documentation/Archaeology/09-EnemyAI-StaticAnalysis.md | Draft (Pass 9 rewrite) |
| Documentation/Archaeology/03-ClassHierarchy.md | Draft |
| Documentation/Archaeology/05-LegacyAbilityArchitecture.md | Draft (enemy ApplyDamage note) |
| Documentation/Archaeology/06-PartialGASArchitecture.md | Draft |
| Documentation/Archaeology/10-AnimationDependencies.md | Draft |
| Documentation/Archaeology/02-ProjectArchitecture.md | Draft (Pass 4 maps/config) |
| Documentation/Archaeology/03-ClassHierarchy.md | Draft (PC/GI/BPI holes) |
| Documentation/Archaeology/06-PartialGASArchitecture.md | Draft (Overlay + EffectActor Pass 10) |
| Documentation/Archaeology/08-CharacterSystems.md | Draft (char-select spawn) |
| Documentation/Archaeology/11-UI-HUD-And-Sessions.md | Draft (Pass 4+10 rewrite) |
| Documentation/Archaeology/12-Pickups-And-Effects.md | Draft (Pass 10 rewrite) |
| Documentation/Archaeology/13-Unknowns-And-RuntimeQuestions.md | Draft |
| Documentation/Archaeology/14-EvidenceIndex.md | Draft |
| Documentation/Archaeology/15-HandoffStatus.md | Draft |
**12 not modified** (no new EffectActor evidence beyond Pass 7).
**07 not created.**
**09 not reopened** (pickup enemy ASC note only via 12/06).
**05 / 10 Animation** not modified.
**07 not created.** **01-ExecutiveSummary not created.**
## Key Pass 9 outcomes
## Key Batch 4D outcomes
1. **Chase primary classification: Implementation Missing** (empty Tick/Overlap; no MoveTo; no target acquisition).
2. **Attack primary classification: Implementation Missing** (EnemyMeleeAttack unimplemented; orphan montage).
3. **Stock AIController + PlacedInWorld** — possession may occur; no behavior.
4. **No BT/BB/Perception/navmesh** in project / Test01.
5. **GetASC defect is separate** — does not cause chase/attack failure.
6. **ABP SetIsDead(false)** every Update — death path incomplete.
7. **Player ApplyDamage has no enemy health/death consumer** statically.
1. **Sessions live in menu PC/widgets**, not GameInstance; AdvancedSessions nodes connected; OnlineSubsystem project INI **Missing**.
2. **GI_Dungeoneer Present but Unconnected.**
3. **Pawn spawn:** DefaultPawn=None → character-select → SpawnActor+Possess (Gunslinger not in UI; char-select server-only create).
4. **ASC Overlay** Health/Mana connected statically; **no stamina widget**; Overlay class CDOs assigned.
5. **Legacy UpdatePlayerHUD and AddGold unimplemented** on `PC_Character` (not native either).
6. **Four GE pickups** Active static path with **Authority Risk**; gold Partial (AddGold hole); no other currency.
7. **Do not claim sessions or pickups work** without runtime testing.
## Suggested next bounded task
**Authorize Batch 4D explicitly**, e.g.:
**Authorize Pass 11 explicitly** (Phase 1 synthesis only), e.g.:
1. Pass 4 — Frontend / sessions
2. Pass 10 — Pickup deep dive
1. Create `01-ExecutiveSummary.md` / update synthesis docs
2. Create `07-AbilityMigrationMatrix.md`
3. No PIE unless separately authorized
**Do not begin** Pass 11 or PIE until authorized.
**Do not begin Pass 11 without explicit user authorization.**
**Starting files:** `00`, `09`, `11`, `12`, `13`, `14`, `15`.
---
## Confirmation
## Continuity checklist for next model
- No Unreal assets modified
- No source/config/map/plugin modified
- No editor state intentionally modified
- No work beyond Pass 9 performed
- Waiting for explicit authorization before Batch 4D
1. Read docs 00, 00A, 0206, 0815 (and 1112 as primary Batch 4D deliverables).
2. Confirm git status before any work; only Archaeology Markdown may change unless user expands authorization.
3. Confirm PIE stopped; level Test01 unless user changed it.
4. Pass 11 = synthesis only — no Unreal mutation, no PIE unless authorized.