Build the raw-crystal belt into the refinery, connect both machines to a mana source, bind each machine's bridge arm to explicit pickup and drop belt cells, then carry refined crystals into the charger. The demo completes when the vault sustains charged-crystal intake.

Full-game direction

The demo is the physical substrate for a magical-law factory game, not the final progression model. The planned campaign crosses contiguous but law-separated fantasy biomes, automates growth, decay, elemental state, and spatial folding, then culminates in building and activating a dimensional gate. After the first warp, the gate becomes a bounded-random matter exchange whose mixed outputs and entropy form the postgame economy.

Current design: docs/tech-tree-v0.2.md
Experience requirements: docs/requirements-magic-factorio.md
Implementation sequence: tasks/tech-tree-plan-v0.2.md

Controls

1: conveyor
2: crystal source
3: refinery
7: charger
4: collection vault
5: mana pipe
6: mana source
B: configure a machine bridge arm (machine, pickup belt, drop belt)
R: rotate the selected building
Left mouse: place or inspect a building
Right mouse: remove
WASD: move camera
Mouse wheel: zoom
N: restart the demo site
Esc: pause, autosave, and open the snapshot menu
F1: toggle developer statistics

One-slot snapshots live in the Godot user data folder as mana_foundry_slot1.json. The title screen 继续构筑 button restores construction, belts, machines, mana, items, and objective progress.

Running

Open project.godot with Godot 4.7.1 stable, or run the workspace-local engine after Task 1 has completed.

Planner recipe workbench

Double-click tools/recipe-tree-editor/start-editor.cmd to open the local planner tool. It provides searchable recipe, item, and machine catalogs; focused and full dependency graphs; live validation; undo/redo; JSON import/export; and recoverable direct saves to data/recipe-book.json.

Usage and field semantics are documented in tools/recipe-tree-editor/README.md.

Playable buildings, belt items, and inspect icons now come from the original art set in assets/generated/, catalogued by data/art-catalog.json against every recipe-book item and machine. The Kenney archive remains in third_party/ for provenance only.

Third-party asset details are recorded in THIRD_PARTY.md.