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
@@ -5,11 +5,11 @@
- **Scope:** Project modules, targets, Build.cs dependencies, plugins (engine + project-local), gameplay-relevant configuration (maps, tags, input, networking, GAS-related settings), engine vs project boundaries.
- **Inspection method:** Read-only inspection of `.uproject`, Target.cs, Build.cs, module startup, plugin descriptors, `Config/*.ini`, and PluginToolset (`ListEnabledPlugins`, `GetPluginInfo`, `IsEnabled`).
- **Evidence classifications used:** Observed Implementation, Documented Intent, Inferred, Unknown.
- **Tool or visibility limitations:** No Git repository at project root (filesystem integrity used). PluginToolset `ListEnabledPlugins` returns the full editor-enabled set (engine + project). No `OnlineSubsystem` / Steam settings found under `Config/`. SemanticSearch not used.
- **Tool or visibility limitations:** PluginToolset `ListEnabledPlugins` returns the full editor-enabled set (engine + project). No `OnlineSubsystem` / Steam settings found under `Config/` (Pass 4 reconfirmed). Map World Settings GameMode not in asset-registry tags — inferred from package dependencies. SemanticSearch not used.
- **Last updated:** 2026-07-16
- **Current phase:** Phase 1 — Static Architecture
- **Last completed pass:** Pass 1 (Batch 1)
- **Next pass expected to contribute:** Batch 4 Pass 10 (map/GameMode relationships); Batch 4 Pass 4 (session usage confirmation)
- **Last completed pass:** Pass 4 + Pass 10 (Batch 4D)
- **Next pass expected to contribute:** Pass 11 when authorized
## Draft tracking
@@ -20,27 +20,44 @@
- Advanced Sessions / Advanced Steam Sessions descriptors
- DefaultEngine / DefaultGame / DefaultGameplayTags / DefaultInput highlights
- CoreRedirects (GAS* → RIR* rename evidence)
- **Pass 4:** Per-map GameMode via deps; GameDefaultMap/EditorStartupMap; GI unwired; OnlineSubsystem INI negative inventory; production AdvancedSessions node consumers
### Pending sections
- Per-map GameMode assignment (requires map World Settings / asset inspection without loading levels)
- Confirmation of which enabled engine plugins are referenced by live gameplay content
- OnlineSubsystem / Steam runtime configuration location
- Confirmation of which other enabled engine plugins are referenced by live gameplay content
- Runtime OnlineSubsystem default platform when INI keys absent
### Evidence still required
- Map asset tags / World Settings for `MainMenu`, `Test01`, `Dev_Island`, character-select maps
- Whether `NetworkPrediction` / `OnlineFramework` / `AbilitySystemGameFeatureActions` are used by project Blueprints or only enabled
- Whether JoinSession travels without explicit ClientTravel pin
- Steam runtime defaults
### Tool or visibility limitations
- Cannot load levels; map GameMode must come from asset metadata / config
- Full enabled-plugin list is large; usage confirmation deferred to later batches
- Map World Settings GameMode tags unavailable; dependency inference used
- Full enabled-plugin list is large
### Unknowns requiring later verification
- Where GameInstance class is configured (`GI_Dungeoneer` discovered via subclass search; not set in inspected DefaultEngine.ini)
- GlobalDefaultGameMode absent from DefaultEngine.ini — GameMode likely per-map
- `GI_Dungeoneer` not assigned via `GameInstanceClass` and has 0 referencers — Present but Unconnected
- GlobalDefaultGameMode absent — per-map overrides only
- No project OnlineSubsystem INI under `Config/`
---
## Pass 4 — Maps, GameModes, sessions, config (Batch 4D)
**Observed Implementation**
| Topic | Finding |
|-------|---------|
| Startup maps | `GameDefaultMap=/Game/_Main/Levels/Maps/MainMenu.MainMenu`; `EditorStartupMap=/Game/_Main/Levels/Testing/Test01.Test01` |
| Map → GameMode (deps) | MainMenu→`GM_MainMenu`; Test01 / Dev_Island / LEVEL_01→`GM_Dungeoneer` |
| GameInstance | `GI_Dungeoneer` empty; **not** in `GameInstanceClass`; 0 asset referencers |
| Sessions | Production create/find/join in `PC_MainMenu` / `WBP_MainMenu` / `WBP_GameSlot`; example BP 0 refs |
| OnlineSubsystem INI | **Absent** from project `Config/*.ini` and plugin Config greps |
| DefaultPawn | `GM_Dungeoneer` DefaultPawn=None; pawn from character-select SpawnActor+Possess |
Full matrices: `11-UI-HUD-And-Sessions.md`.
---
## 1. Project descriptor
**Observed Implementation** — [`REALMSINRUIN_DEV.uproject`](REALMSINRUIN_DEV.uproject)