admin/UE5-Modular-Game-Framework
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Update C++ integration guide and blueprint specifications for various systems, adding detailed setup instructions and clarifying implementation statuses

Browse Source
This commit is contained in:
Lefteris Notas
2026-05-21 21:29:03 +03:00
parent 0852386168
commit bcbfcdf167
21 changed files with 133 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/blueprints/16-state/130_BPC_StateManager.md
View File

@@ -1,5 +1,9 @@
# 130 — Central State Authority (`BPC_StateManager`)
> **⚡ C++ Status: Full Implementation** — `Source/PG_Framework/Public/Player/BPC_StateManager.h` provides the complete state authority: `IsActionPermitted()` hot-path query, `RequestStateChange()`, `ForceStateChange()`/`RestorePreviousState()` force stack, heart rate BPM smoothing with tier detection, gating rule evaluation. **Attach directly to player pawn** (component slot 0). Set `GatingTable` → `DA_StateGatingTable` in Details panel. Do NOT create a BP child. See `docs/developer/cpp-integration-guide.md` for usage patterns.
>
> ---
## Purpose
Single source of truth for "what can the player do right now?" Every system queries `IsActionPermitted(Tag)` instead of checking other systems' states directly. Manages exclusive action states, upper-body overlay states, action action gating, vital signs (heart rate), and the force-stack pattern for nested overrides (death, cutscenes, void space). Communicates with GASP exclusively through overlay state variables — never touches motion matching internals.

4
docs/blueprints/16-state/131_DA_StateGatingTable.md
View File

@@ -1,5 +1,9 @@
# 131 — State Gating Table (`DA_StateGatingTable`)
> **⚡ C++ Status: Stub** — `Source/PG_Framework/Public/State/DA_StateGatingTable.h` provides the `FStateGatingRule` struct (ActionTag, BlockedByState, bIsBlocked) and `IsActionGated()` query. **Create a Data Asset instance** (Right-click → Miscellaneous → Data Asset → `DA_StateGatingTable`). Populate `GatingRules` with 37 rules. The C++ `BPC_StateManager` reads this asset — no BP logic to build. Designers modify gating rules in this Data Asset without touching code. See `docs/developer/cpp-integration-guide.md`.
>
> ---
## Purpose
Data Asset that holds all state gating rules for the framework. Loaded by `BPC_StateManager` on BeginPlay to populate its `GatingRules` array. Designers modify gating rules entirely through this Data Asset — no blueprint changes required to add, remove, or tweak which states block which actions.