Migration Guide — v0.8 to Current

Overview

Upgrading from Gorgeous Core v0.8 to the current version involves several key changes to the API and module structure.

Breaking Changes

Object Variable System

The Object Variable System was significantly expanded in v1.0:

• Maps and Sets: UGorgeousMap and UGorgeousSet are now available alongside UGorgeousArray.
• Container API: The container interface was unified — replace GetArrayValue() with GetValue() on the new generic container interface.
• Registration: Variables now self-register through the new IGorgeousObjectVariableRegistrar interface.

// v0.8 (old)
UGorgeousObjectVariable* Var = NewObject<UGorgeousObjectVariable>();
Var->SetValue(MyValue);

// Current (new) — same basic usage, but with expanded container support
UGorgeousObjectVariable* Var = NewObject<UGorgeousObjectVariable>();
Var->SetValue(MyValue);
// New: Maps, Sets, and advanced containers available
UGorgeousMap* Map = NewObject<UGorgeousMap>();

Module Renaming

v0.8 Module	Current Module
GorgeousCore	GorgeousCoreRuntime
GorgeousCoreEd	GorgeousCoreEditor
(N/A)	GorgeousCoreRuntimeUtilities
(N/A)	GorgeousCoreEditorUtilities

Update your .Build.cs files to reference the new module names.

Logging

The logging API remains compatible, but new log categories have been added. No changes needed for existing logging code.

Step-by-Step Migration

1. Update module references in all .Build.cs files
2. Recompile — fix any compilation errors from renamed types
3. Test Object Variables — verify existing variable instances load correctly
4. Explore new features — AutoReplication, Insight Matrix, COCs are now available

Need Help?

Join the Discord community for migration assistance.