From 20f0f3d77578f83c7002d914b1d57cffd661971d Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Mon, 14 Sep 2026 23:32:53 +0200 Subject: [PATCH] Describe preset capture through its own cache in the target The Loadouts section no longer says the editor opens the catalog writable. It describes the read-only process cache, the short-lived capture cache, the refusals for a missing catalog and a same name under another key, the console's character refusal, and the need to reopen CultCache Studio after capturing, since a Studio save overwrites captured presets. Co-Authored-By: Claude Opus 5 --- docs/cultcache-migration-target.md | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/docs/cultcache-migration-target.md b/docs/cultcache-migration-target.md index 3fecf4d0f..dc84f0d93 100644 --- a/docs/cultcache-migration-target.md +++ b/docs/cultcache-migration-target.md @@ -86,10 +86,22 @@ do not see loadouts in the MVP. Spawners use them to build ships. - **Home.** Loadouts live in the catalog. They are authored in CultCache Studio, or captured in play with the editor-only console command `capturepreset "" [replace]`, and they are only read at runtime. -- **Capture.** The editor opens the catalog writable, in the same single cache. - `Loadouts.Commit` keys a preset by its name. It replaces an existing preset - only when `replace` is given. The commit is conditional on that key, so it - writes only this one record onto the file as it is on disk. +- **Capture.** The process cache opens the catalog read-only in every build. + `Loadouts.Commit` opens its own short-lived cache over `Aetheria.cc`, + writable, commits the one preset and disposes it, so no catalog instance play + holds can reach the file. The running game sees the preset after the catalog + reloads. + - A preset is keyed by its name. It replaces an existing preset only when + `replace` is given, and a preset of the same name under another key (one + authored in Studio) refuses the capture. + - A missing `Aetheria.cc` refuses the capture; it never creates the catalog. + - The commit is conditional on that key, so it writes only this one record + onto the file as it is on disk. + - The console refuses a command containing anything but letters, digits, + spaces and hyphens, and quotes a multi-word name. + - A CultCache Studio session opened before the capture overwrites captured + presets when it saves, since a single-file save is last-writer-wins. + Reopen the Studio after capturing. - **Materialize.** `Loadouts.Materialize` is the only way to build a ship from a loadout, and it charges nothing. - Each design is built by the first available product for that design, in