pixi-vn-storage

Use the storage singleton: call storage.set(key, value) to write and storage.get(key) to read. Values can be strings, numbers, booleans, null, plain objects, or arrays, and everything set through storage is automatically included in save/load and history snapshots.

Extend StoredClassModel with a categoryId and instance id, then expose properties through getStorageProperty and setStorageProperty. Constructor arguments become in-memory defaults, while setStorageProperty writes overrides into storage that survive save/load.

Use storage.flags.set/get for booleans. Flags are stored internally as a single array of active names, which serializes much smaller than one storage entry per boolean, and unset flags default to false.

storage.temp variables are readable through storage.get but are deleted when the label that set them closes, including on jump. Use storage.set for any state that must outlive the current label.

Keys listed in the SYSTEM_RESERVED_STORAGE_KEYS constant are off-limits, including dialogue, choice:options, input:value, character, and label:opened. Avoid the ___-fenced prefix style in your own keys to prevent collisions with engine bookkeeping.