ZionGames Docs

Home / Zion Tools

🧰 Zion Tools

Unity Editor Asset Tools

Schema Validation & Reports 1.1

Schema validation catches missing fields and wrong types in any save with one click - before they crash your loader. Support reports package a save's diagnostics into pasteable Markdown.

Capturing a schema

Open a save you trust - freshly written by the current build of your game - and choose Schema ▾ > Capture Schema From Current Save…. Name it after the slot type (e.g. campaign-v3) and confirm. The schema snapshots every path and its node kind.

Schemas are stored per project (keyed by product name) in EditorPrefs and survive domain reloads and editor restarts. Capturing a schema with an existing name overwrites it, after confirmation.

Validating

With any save open, choose Schema ▾ > Validate Against > <schema>. The results window lists three kinds of finding:

FindingMeaning
MISSINGThe schema expects the path; the save doesn't have it. Usually means the save predates a field your loader now requires - the classic "works for me, crashes on old saves" bug.
TYPEThe path exists but its node kind differs - e.g. a level stored as a string after a hand edit.
EXTRAThe save has a path the schema never captured. Informational - leftovers from removed features or fields added by a newer build. Hide with the toggle when they're noise.

Missing fields and type mismatches are the actionable findings. Copy as Markdown exports the results; delete schemas from Schema ▾ > Delete Schema.

Re-capture the schema whenever your save format intentionally changes - capture is cheap, and stale schemas produce noisy EXTRA/MISSING findings.

Support reports

Export Report produces a Markdown diagnostic for the selected save:

  • Source, identifier, format, size and last-modified date
  • Node counts per kind, maximum depth, top-level field count
  • A summary of every top-level field with its kind and value

Save it to a file or copy it to the clipboard - it's designed to be pasted straight into a bug tracker or a player-support ticket. Pair a validation run with a report and you have a complete diagnostic for any save a player sends you.

Continue to Built-in Providers.