Overview

WCGASWorldContextSubsystem is a World Subsystem that serves as the central runtime authority for the World Context System in the Wonderscape GAS Ally plugin. It automatically initializes when a game world begins, loads context data definitions from Project Settings, builds runtime lookup maps for O(1) context queries, manages three layers of contexts (global, zone-based, per-actor), provides the query API for damage calculations and effect modifications, integrates with the Difficulty Subsystem for modifier scaling, and coordinates with Context Volumes for spatial context zones.

Purpose

The World Context Subsystem orchestrates all environmental context management by providing:

• Automatic Initialization: Loads World Context Data assets from Project Settings at world startup and builds optimized runtime lookup maps
• Context Layer Management: Tracks contexts at three priority layers—Global (world-wide), Zone (volume-based), and Actor (per-actor overrides)
• Modifier Queries: Provides the primary API for ExecCalcs and other systems to query element-based modifiers from active contexts
• Difficulty Integration: Automatically scales all context modifiers based on current difficulty level via cached scale values
• Zone Registration: Coordinates with AWCGASContextVolume actors for priority-based zone context resolution
• Event Broadcasting: Fires delegates when contexts change at any layer for UI updates and reactive gameplay systems
• Automatic Cleanup: Periodically removes stale actor references from internal tracking maps

How It Works

Initialization Flow

1. Subsystem Startup: When a game world initializes, UE automatically creates this subsystem (filtered via ShouldCreateSubsystem to only run in game worlds, not editor preview)
2. Load Context Data: Calls LoadContextData() which retrieves configuration from UWCGASAllySettings via GetDefault<UWCGASAllySettings>()
3. Build Context Registry: Iterates through Settings->WorldContextData array, loading each UWCGASWorldContextData synchronously and validating ContextTag
4. Build Cached Data: For each context asset, creates FWCGASCachedContextData with pre-processed element rules in fast lookup format (ElementTag → ModType → Value)
5. Register Context: Adds cached data to ContextDataRegistry TMap (ContextTag → CachedData) for O(1) lookups