← ClaudeAtlas

dayz-persistencelisted

Use when designing, implementing, debugging, or auditing DayZ persistence — OnStoreSave/OnStoreLoad entity streams, CF ModStorage and storageVersion, persistent-format migration or rollback, sidecar JSON, recoverable file replacement or atomic-save claims, player-data corruption after save or restart, and placed objects that vanish after a restart (central-economy lifetime, types.xml entries). Invoke for deprecated JSON loading APIs, future or truncated versions, uninstall-safe mod data, CombinationLock stream v143, code lock, ThermalBiasHandler, GAME_STORAGE_VERSION, and BunkerBroadcastPersistenceStorage.bin.
willy92wins/DayZ-Modding-Knowledge-Pack · ★ 25 · Data & Documents · score 78
Install: claude install-skill willy92wins/DayZ-Modding-Knowledge-Pack
# DayZ Persistence ## Router: choose one contract first Answer all four questions before choosing a mechanism. Each matching rule adds a candidate; exactly one candidate is required. Zero or multiple candidates return `needs_clarification`. Never resolve conflicting signals by silently preferring a contract. | Observable input | Candidate | |---|---| | Data is not attached to an entity, or an administrator must inspect or repair it outside the game | Sidecar file | | The mod does not own the entity, or the data must survive uninstall and reinstall | CF ModStorage | | Data is attached to an entity the mod owns, need not survive uninstall, and need not be inspected outside the game | Vanilla entity stream | This is a routing decision, not a ranking. For example, data outside an entity that must also survive uninstall matches two rules and needs clarification about ownership and the required recovery surface. ## Contract 1: vanilla entity stream Use the stream for data owned by the entity's own mod when uninstall survival is not required. `EntityAI.OnStoreSave(ParamsWriteContext)` and `EntityAI.OnStoreLoad(ParamsReadContext, int)` are the hooks (`VANILLA/3_game/entities/entityai.c:2910`; `VANILLA/3_game/entities/entityai.c:2978`). Save and load fields in the same order and type, propagate `super`, stage reads, and return `false` on any failed `ctx.Read`; partial state is never valid (`VANILLA/3_game/entities/entityai.c:2958-2974`). The hook version is the DayZ build from