🌐 Module Core Globals

Short Description

The Globals library provides a centralized set of static functions for accessing QoL references, managing player IDs, and configuring AutoReplication settings.

Long Description

The UGorgeousCoreRuntimeGlobals class acts as the primary "Glue" between different Gorgeous systems in Blueprints. It provides shorthand nodes for resolving singleton QoL instances (like GameMode or GameState), managing stable player identifiers for networking, and fine-tuning the AutoReplication backend (Iris, Replication Graph) at runtime. Use these globals when you need to access Gorgeous systems from within generic Blueprints that don't inherit from QoL base classes.

🚀 Features

  • QoL Resolution: Type-safe retrieval of singleton Gorgeous objects using DeterminesOutputType.
  • Stable Player IDs: Map local player controllers to persistent string identifiers for stable networking.
  • AutoReplication Config: Toggle Iris and Replication Graph support or override stream settings per-entry.
  • Game Feature Helpers: Enable or disable Game Feature Plugins dynamically at runtime.
  • Variable Shortcuts: Quickly get or set variables by their display name without manually traversing the registry.

📚 Usage Examples

AGorgeousWorldSettings* Settings = UGorgeousCoreRuntimeGlobals::GetGorgeousWorldSettings(this);

Use Get QoL Reference and select GorgeousGameState as the class. The node's output will automatically cast to the correct type.

GetQualityOfLifeReference

Retrieves a registered Gorgeous singleton instance.

Parameter Name Type Description
QualityOfLifeClass TSubclassOf<UObject> The QoL class to retrieve (must implement the QoL interface).
Parameter Name Type Description
ReturnValue UObject* The resolved instance, cast to the input class.

RegisterLocalPlayerStableId

Assigns a stable string ID to a player controller. This ID persists across reconnections and is used for stable networking in the Signal Bridge.

Parameter Name Type Description
PlayerController APlayerController* The controller to register.
StableId FString The identifier to assign.

SetAutoReplicationBackendsEnabled

Enables or disables modern networking backends at runtime.

Parameter Name Type Description
bEnableIris bool Whether to enable Unreal Iris support.
bEnableReplicationGraph bool Whether to enable the AutoReplication graph.

SetGameFeaturePluginActive

Dynamically loads or unloads a Game Feature Plugin.

Parameter Name Type Description
PluginName FName The internal name of the plugin.
bNewActive bool Target state.

Best Practices

  • Avoid Hardcoding IDs: When using GetNamedObjectVariable, ensure the name is defined in a centralized data asset or constant to avoid typo-related bugs.
  • Transition Check: When enabling Game Feature Plugins at runtime, be aware that not all features (like UI layers) may initialize immediately.
  • Stable IDs for UI: Use GetLocalPlayerStableId to identify which player's inventory or stats to show in split-screen UI.

Troubleshooting

  • QoL Reference Null: Ensure the target class correctly implements IGorgeousQualityOfLifeNodeTarget_I and has called its registration logic in BeginPlay.
  • Iris Not Working: Iris support requires specific engine-level configuration. If SetAutoReplicationBackendsEnabled has no effect, verify your DefaultEngine.ini settings.
  • Plugin Not Found: SetGameFeaturePluginActive will fail silently if the plugin name does not match the descriptor file exactly.