Factory Core – Godot 4 factory / automation starter kit / template

Deterministic, headless-tested belts, machines and power for your Godot 4 automation game.

Factory Core: a Godot 4 factory / automation starter kit and project template in typed GDScript. Free MIT Lite on GitHub (65 headless tests), Pro €16.00 on itch.io (249 headless tests).

Get it

Lite (free, MIT): https://github.com/openclawaimac/godot-factory-core-lite – Deterministic, headless belt + machine simulation: two-lane belts with side-loading and backpressure, Mk1 recipe machines, round-robin splitter, fair merger, JSON/.tres content, stats and save/load. 65 tests.
Pro (€16.00 EUR, commercial EULA): https://huginhelm.itch.io/factory-core – 249 passing headless tests, playable demo

Engine: Godot 4.7 (tested on 4.7.2) · Language: typed GDScript · Version 0.5.0 · Run tests: bash tools/run_tests.sh

Lite vs Pro

Feature	Lite (free, MIT)	Pro (€16.00, EULA)
Data-driven items/recipes/buildables (Resources or JSON)	✅	✅
Deterministic headless sim, throughput stats	✅	✅
Two-lane belts with side-loading, backpressure	✅	✅
Source, sink, machines (recipes, buffers)	✅ Mk1	✅ Mk1–Mk3 tiers, recipe switching
Splitter and fair merger	✅	✅ + filter splitter
Underground tunnels	–	✅
Power grid, generators, brownout	–	✅
Bottleneck finder + colour overlay	–	✅
JSON save/load	✅ basic	✅ + versioned migrations
Grid build mode: ghost, drag belts, auto-connect, refund, hotbar	–	✅
Undo/redo, blueprints	–	✅
Playable demo game, camera, ore map, inspector	Minimal debug scene	✅
Pixel art, sfx, music (CC0)	–	✅
Headless tests	Lite subset	✅ 249 checks
Web export preset, build scripts, reskin	–	✅
Licence	MIT	Commercial EULA (per seat)

Features (Pro)

Flow-graph belt simulation with gap-based belt lines (no per-item physics); two-lane belts with side-loading and underground tunnels
Machines with input/output buffers and recipes, Mk1–Mk3 tiers (speed/power per mille), recipe switching
Splitters with filter and fair mergers
Power grid with generators and brownout
Throughput stats and a heuristic bottleneck finder with colour overlay (idle/working/starved/blocked/no power)
Deterministic fixed tick – FactorySim.step(n) runs fully headless
Grid build mode: data-driven hotbar, ghost preview (valid/invalid), rotation, drag-placed belt lines with auto-connect, removal with refund and cost hooks
Undo/redo (restores items of removed nodes), blueprints: capture, rotate, paste, serialize
Items, recipes and buildables as Resources or loaded from JSON, with FactoryDB.validate()
JSON save/load with migrations
Camera pan/zoom and a 120x80 demo map with iron/copper ore fields (drills need ore)
JSON build scripts for starter layouts; reskin via skin.json + PNGs
Demo chain: ore → plates → gears, wire → circuits → motors (8 items, 6 recipes, 15 buildables)

Not included

1x1 buildables only; no inserters/arms, fluids, trains, robots or logic network
One power network per sim; no poles, fuel or accumulators
Bottleneck finder is a heuristic, not full flow analysis
Tested headless on Godot 4.7.2 (plus scripted headless-Chrome run of the web build); real browsers/devices not tested

Preview

Screenshots

Assets & licence

Original 16x16 pixel art (generated by included script), Kenney CC0 sfx, two CC0 music tracks from OpenGameArt.

Lite is free under the MIT License. Pro is sold under a commercial per-seat EULA: you can ship unlimited commercial and non-commercial games; you may not resell or redistribute the kit's source or assets as a template. Bundled art/audio is CC0.

Code and docs written with AI coding agents. Machine-readable summary: llms.txt.