51 lines
3.5 KiB
Markdown
51 lines
3.5 KiB
Markdown
|
# Кампания, сохранения и восстановление сессии
|
|||
|
|
|
|||
|
|
## Известная файловая поверхность
|
|||
|
|
|
|||
|
|
Demo содержит `MISSIONS/dispatcher.ini` и `SAVE/saveslots.cfg`.
|
|||
|
|
`dispatcher.ini` хранит campaign progression (в demo — `[COMPLETE]`), а
|
|||
|
|
`saveslots.cfg` — ordered UI-метаданные slots, не полный snapshot мира.
|
|||
|
|
В Части 2 slots 1 и 7 помечены занятыми без соответствующего payload; поэтому
|
|||
|
|
проверяются независимо: наличие metadata record, физического файла и
|
|||
|
|
format/version/integrity payload.
|
|||
|
|
|
|||
|
|
Campaign различает существование миссии, её доступность, старт, успешное или
|
|||
|
|
неуспешное завершение и уже применённый результат. Обработка одного
|
|||
|
|
mission-complete event идемпотентна. Пустой slot и повреждённый существующий
|
|||
|
|
payload — разные состояния.
|
|||
|
|
|
|||
|
|
## Контракт standalone save
|
|||
|
|
|
|||
|
|
Полный snapshot сохраняет campaign/mission context, time/pause/step phase,
|
|||
|
|
stable object IDs, ownership, transforms, lifecycle/properties/cross-links,
|
|||
|
|
world changes, Behavior/Control/AI/research/economy state, script variables/IP/
|
|||
|
|
timers, authoritative RNG, gameplay-relevant FX и queued messages. Camera/UI
|
|||
|
|
можно сохранить как presentation context; GPU/audio handles и draw buffers
|
|||
|
|
восстанавливаются, а не сериализуются.
|
|||
|
|
|
|||
|
|
Снимок разрешён только после calculation и deferred operations, вне queue
|
|||
|
|
traversal, после применённых network messages и до чтения mutable state
|
|||
|
|
renderer-ом. Native pointers, vtable/allocator addresses и resource mapping
|
|||
|
|
pointers запрещены: ссылки идут через stable IDs и resource keys.
|
|||
|
|
|
|||
|
|
Новый формат — versioned chunks (`WORLD`, `OBJECTS`, `BEHAVIOR`, `PHYSICS`,
|
|||
|
|
`AI`, `SCRIPT`, `RESEARCH`, `RNG`, `CAMERA_UI`, optional network) с magic,
|
|||
|
|
format/profile/content fingerprint, size и checksum. Неизвестный optional
|
|||
|
|
chunk пропускается; required chunk блокирует load. Это дизайн FParkan, не
|
|||
|
|
утверждение о binary format оригинала.
|
|||
|
|
|
|||
|
|
Запись транзакционна: временный файл → повторное чтение/checksum → fs sync →
|
|||
|
|
атомарная замена payload → обновление slot metadata. Загрузка создаёт mission
|
|||
|
|
и objects без публикации, восстанавливает IDs/cross-links/controllers/RNG,
|
|||
|
|
регистрирует их, валидирует и только затем разрешает следующий tick.
|
|||
|
|
|
|||
|
|
## Проверки и граница
|
|||
|
|
|
|||
|
|
`save -> load` обязан давать тот же canonical state hash, OriginalObjectId,
|
|||
|
|
cross-links и продолжение RNG. Corrupt required chunk не публикует частичный
|
|||
|
|
мир; crash при записи не уничтожает старый slot; completion event идемпотентен.
|
|||
|
|
|
|||
|
|
Для native format нужны controlled original saves, binary diffs и trace
|
|||
|
|
serializer-а. До этого FParkan может иметь совместимую семантику собственных
|
|||
|
|
saves, но не заявляет byte/network interoperability с оригинальными файлами.
|