PSZ Spec
OverviewArchitectureAssetsJourneyAutopilotMechanicsStatesHierarchiesEngineering

Download Content

Autopilot · Step 2 new user ✓ covered Asserts the asset pack mounts before continuing (cache-hit or local copy; the harness uses the local dist pack so it stays offline).

Purpose

Downloads the asset pack (~264 MB) on first launch or when the pack version changes. Shows a progress bar while fetching from Arweave gateways.

Verification

The in-app assets_manifest.json (bundled at build time) is the source of truth. It carries the pack's sha256, size, and urls.

The cache path encodes the hash: user://packs/assets-<sha12>.pck. If a file at that path exists, bootstrap streams a full sha256 verification against the manifest hash. No separate metadata download is needed — the manifest is baked into the binary.

Cache cleanup

On launch, any *.pck under user://packs/ that doesn't match the current sha is deleted. Only one pack version lives on disk at a time.

Error handling

The manifest lists multiple gateway URLs. Bootstrap tries each in order — if one fails, it falls through to the next. Total failure shows a fatal message. Hash mismatch after download is also fatal (no silent fallback).

Previous

← Splash Screen

Next

Controls Setup → (first run only)

Title Screen → (subsequent launches)