Struct GameSave 

pub struct GameSave {
    pub version: u32,
    pub map: Option<String>,
    pub player: PlayerSave,
    pub flags: HashMap<String, bool>,
    pub lang: Option<String>,
    pub party: Option<Vec<PartyMemberSave>>,
    pub inventory: Option<HashMap<String, u32>>,
    pub money: Option<u32>,
}

A dotzuki run save file.

Fields

version: u32

Format version; must be <= SAVE_VERSION to load (v1/v2 files parse fine — the newer fields simply default to absent).

map: Option<String>

Current map id; None for a dialogue-only (map-less) project.

player: PlayerSave

Player tile + facing.

flags: HashMap<String, bool>

Persistent story flags (cross-scene truth), restored verbatim.

lang: Option<String>

UI/script language at save time (informational; --lang wins).

party: Option<Vec<PartyMemberSave>>

Persistent party state (v2); absent ⇒ fresh party at the first battle.

inventory: Option<HashMap<String, u32>>

Persistent battle inventory (v2); absent ⇒ the manifest’s battle.items.starting counts at the first battle.

money: Option<u32>

The player’s money (v3); absent ⇒ the manifest’s shop.startMoney (or its default) applies.

Implementations

impl GameSave

pub fn to_json(&self) -> String

Serialize as pretty JSON — the platform-neutral form a WASM shell persists to localStorage (see RunnerGame::export_save).

pub fn from_json(text: &str) -> Result<Self>

Parse a save from JSON (no version check — callers compare version against SAVE_VERSION).

Errors

Fails when the text is not a valid GameSave JSON document.

pub fn load(path: &Path) -> Option<Self>

Read and validate a save file.

Returns None — with a warning for anything but a simply-absent file — when the file is missing, unreadable, unparseable, or from a NEWER version: a bad save never crashes the boot. Older versions load with per-field defaults (a v1 save has no party/inventory, so both start fresh).

pub fn write(&self, path: &Path) -> Result<()>

Write the save as pretty JSON, via a temp file + rename so a crash mid-write can’t leave a truncated save behind.

Errors

Fails when the temp file can’t be written or renamed into place.

Trait Implementations

impl Clone for GameSave

fn clone(&self) -> GameSave

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GameSave

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GameSave

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GameSave

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.