58 lines
3 KiB
Markdown
58 lines
3 KiB
Markdown
# Aetheria.State
|
|
|
|
`Aetheria.State` is the replacement owner for durable Aetheria game state.
|
|
|
|
It uses modern `GameCult.Caching`, `GameCult.Caching.MessagePack`, and
|
|
`GameCult.Mesh`. It does not reference the old `Assets/Scripts/ServerShared`
|
|
tree, RethinkDB, JsonKnownTypes, or Newtonsoft.Json.
|
|
|
|
The first live state file is `GameData/aetheria-world.cc`. It is generated by
|
|
`Aetheria.State.Import` from checked-in legacy catalog inputs without embedding
|
|
machine-local absolute paths. Legacy files such as `GameData/AetherDB.msgpack`
|
|
are migration inputs only.
|
|
|
|
The typed runtime state model is split into player settings, run state, zone
|
|
state, entity snapshots, item slots, weapon groups, action-bar bindings, and
|
|
stat grids. Do not preserve `SavedGame` or `EntityPack` as opaque payloads in
|
|
the new store; they are source shapes for migration, not portable state
|
|
authority.
|
|
|
|
The Unity client no longer writes `PlayerSettings.msgpack`, `.loadout`, or
|
|
`.zone` files. Until `Aetheria.State` is available to Unity as a runtime Verse
|
|
package, player settings and loadout edits are session-local and run saving is
|
|
disabled. That is intentional: the missing runtime package is the owner gap, and
|
|
the old bespoke file formats must not keep acting as durable truth while the
|
|
state spine is being rebuilt.
|
|
The old `SavedGame`/`SavedZone` DTOs and `Galaxy` loader constructor have also
|
|
been deleted; the new document family is live Verse run/zone state, not a
|
|
bespoke save-file format.
|
|
|
|
Keyboard layout rendering now reads the checked-in Unity text asset directly.
|
|
The old generated `GameData/KeyboardLayouts/*.msgpack` cache was deleted; layout
|
|
edits are runtime-only until Verse owns a typed layout/settings document.
|
|
|
|
The old IMGUI CultCache database editor has been deleted, and `NameTools` no
|
|
longer exports `NameFile/*.msgpack`. `AetherDB.msgpack` and existing name files
|
|
remain legacy catalog inputs only; typed catalog migration is the next owner
|
|
move.
|
|
|
|
`Aetheria.State.Import` captures the legacy catalog files into typed quarantine
|
|
state: path, size, and SHA-256 fingerprint for `AetherDB.msgpack` plus
|
|
`NameFile/*.msgpack`, and a migration ledger update. It also performs a bounded
|
|
raw MessagePack union pass that maps stable catalog fields into typed
|
|
item/faction/name-file documents without compiling Unity's legacy domain model
|
|
into `Aetheria.State`. The current checked-in catalog maps to 115 item
|
|
definitions, 12 factions, and 12 name files. Runtime object graphs, behaviors,
|
|
Unity shapes, and simulation state remain legacy until dedicated typed
|
|
documents exist.
|
|
|
|
Current rebuild notes:
|
|
|
|
- `MessagePack` 3.1.4 is pulled transitively through CultLib and is currently
|
|
flagged by NuGet advisory `GHSA-hv8m-jj95-wg3x`; update CultLib's
|
|
`GameCult.Caching.MessagePack` package ownership rather than adding a local
|
|
Aetheria override.
|
|
- `CultRecordRef<T>` should become the persisted reference shape once the
|
|
MessagePack source-generator path handles the GameCult formatter cleanly.
|
|
Until then, v1 profile documents store explicit record-key strings at the
|
|
persistence boundary.
|