Save Structures & Messaging

/** Identifies a currency row robustly across reloads. */
struct FCrimsonInventoryCurrencyKey
{
    FSoftObjectPath DataTablePath;
    FName RowName;
};

/** Key-value record written by SaveState / LoadState (state fragments and constraints). */
struct FCrimsonInventoryStateData
{
    FName Key;
    TSubclassOf<UObject> FragmentClass;
    int32   IntValue    = 0;
    float   FloatValue  = 0.f;
    FString StringValue;
    FGameplayTag TagValue;
    TArray<uint8> BinaryValue;
};

/** One saved inventory entry - includes layout payload. */
struct FCrimsonInventorySaveEntry
{
    TSubclassOf<UCrimsonInventoryItemDefinition> ItemDef;
    int32                StackCount    = 0;
    int64                EntryId       = 0;
    int32                SlotIndex     = -1;
    FIntPoint            GridPosition  = FIntPoint(-1, -1);
    ECrimsonItemRotation Rotation      = ECrimsonItemRotation::None;
    int32                LayoutGroupId = 0;
    bool                 bLocked       = false;
    TMap<FGameplayTag, int32> StatTags;
    TMap<FGameplayTag, float> FloatStatTags;
    TArray<FCrimsonInventoryStateData> StateFragmentsData;
};

/** One saved runtime-attached constraint. */
struct FCrimsonInventoryConstraintSaveEntry
{
    TSubclassOf<UCrimsonInventoryConstraint> ConstraintClass;
    TArray<FCrimsonInventoryStateData>       SerializedState;
};

/** Full inventory snapshot. Used by both the manager component and (nested) by the routing save. */
struct FCrimsonInventorySaveData
{
    TObjectPtr<UCrimsonInventoryLayout> LayoutAsset = nullptr;
    int64                               NextEntryId = 1;
    TArray<FCrimsonInventorySaveEntry>  Items;
    TArray<FCrimsonInventoryConstraintSaveEntry> ActiveConstraints;
    TMap<FGameplayTag, int32>           ConstraintTags;
    TMap<FGameplayTag, float>           ConstraintFloatTags;
    TMap<FCrimsonInventoryCurrencyKey, int64> CurrencyAmounts;
};

/** UCrimsonContainerSubsystem snapshot. Key = container tag. */
struct FCrimsonContainerSaveData
{
    TMap<FGameplayTag, FCrimsonContainerSaveEntry> Containers;
};

/** UCrimsonInventoryRoutingComponent snapshot - personal containers held on the PC. */
struct FCrimsonRoutingPersonalContainerSave
{
    FGameplayTag              ContainerTag;
    FCrimsonInventorySaveData Inventory;
};
struct FCrimsonInventoryRoutingSaveData
{
    TArray<FCrimsonRoutingPersonalContainerSave> PersonalContainers;
};