PackedEntity

public PackedEntity();

Creates an empty serialized-hierarchy container with a PackedEntityState. Before successful Pack/loading CanInstantiate is false. This is a Resource rather than a live Entity; add the Instantiate result to the tree.

public Reckfell.Collections.Dictionary _Bundled { get; set; }

Internal serialization Dictionary schema, not a stable level-editing API or user save-game format. The setter restores state from linked arrays/indices; arbitrary key edits can break structure. Use Pack for ordinary creation and GetState for inspection. Only a valid owned-QA bundle roundtrip was executed; malformed data was not.

public bool CanInstantiate();

Checks only whether state contains Entity records. True proves neither available scripts/dependencies nor every property correctness or a successful future Instantiate. Returns false for a newly empty PackedEntity.

public PackedEntityState GetState();

Returns the current shared serialization state, not a snapshot or live tree. Repeated access can return the same C# wrapper. Pack/ResetState change data visible through a held reference. Do not Dispose the shared wrapper while the PackedEntity or other code uses it; keep the owner alive for ordinary inspection.

public Entity Instantiate(PackedEntity.GenEditState editState = PackedEntity.GenEditState.Disabled);

Creates a new Entity hierarchy with stored properties, groups and connections restored. Does not call AddChild or guarantee _Ready before tree entry. The result owner must attach the root or Free an unused root; its children are freed with it. Local-to-scene resources are separated per instance while ordinary resources may remain shared. Normally use GenEditState.Disabled. Native creation failure can return null and diagnostics.

public T Instantiate<T>(PackedEntity.GenEditState editState = PackedEntity.GenEditState.Disabled) where T : class;

Creates a new Entity hierarchy with stored properties, groups and connections restored. Does not call AddChild or guarantee _Ready before tree entry. The result owner must attach the root or Free an unused root; its children are freed with it. Local-to-scene resources are separated per instance while ordinary resources may remain shared. Normally use GenEditState.Disabled. Native creation failure can return null and diagnostics. The generic wrapper casts the already created root to T and can throw InvalidCastException. It does not Free a rejected root; retain a nongeneric Instantiate result before checking an unknown type.

public T InstantiateOrNull<T>(PackedEntity.GenEditState editState = PackedEntity.GenEditState.Disabled) where T : class;

Creates the native hierarchy first, then applies C# as T. A type mismatch returns null, but the wrapper does not free the root already created. Not a safe pre-instantiation type test. When the type is unknown, retain an ordinary Instantiate result, use is T, and explicitly Free a rejected root. Matching types were executed; mismatch was source-reviewed only.

public Error Pack(Entity path);

Serializes a live hierarchy into this PackedEntity in memory, not a file. Despite its name, path is an Entity root. Parenthood alone is insufficient: set Owner to the appropriate root for ordinary added descendants; unsuitable descendants are omitted. Stores persistent groups/connections and stored properties rather than all runtime state. The source tree stays alive. A new Pack replaces prior state; parsing failure can clear it, with no atomic rollback promised. Call ResourceSaver.Save separately for disk persistence.