How sizzlins/redstone-mini works
redstone-mini parses Boolean recipes, turns them into placed and routed Minecraft redstone circuits, verifies their behavior, and exports a preview or commands for Minecraft. The CLI is the documented entry point; a local editor offers a separate compile-and-preview route. The source index identifies the principal modules and their references, but several implementation excerpts are partial, so uncertain internal call relationships are omitted or marked unverified.
Main entry points: redstone_mini.py CLI entry · serve.py Editor server · sim.py Build and verify · layout.py Circuit layout
Components 14
Recipe input
- Live editor
editor.html - Editor server
serve.py - CLI entry
redstone_mini.py
Circuit compiler
- Recipe parser
recipe.py - Circuit layout
layout.py - Compositional backend
compose.py - Gate tiles
tiles.py - Shared primitives
core.py
Verification and diagnostics
- Build and verify
sim.py - Build snapshots
snapshot.py - Layout diagnostics
debug.py
Preview and export
- Build exporters
export.py
Other components
- User
- Minecraft world
Connections 16
- User → CLI entry: runs
README.md - User → Live editor: edits recipe
README.md - Live editor → Editor server: submits recipe
serve.py - CLI entry → Recipe parser: parses recipe
redstone_mini.py - CLI entry → Build and verify: builds and verifies
redstone_mini.py - CLI entry → Build exporters: exports build
redstone_mini.py - CLI entry → Editor server: starts editor
redstone_mini.py - Editor server → Recipe parser: parses recipe
serve.py - Editor server → Build and verify: builds and verifies
serve.py - Editor server → Build exporters: renders preview
serve.py - Build and verify → Circuit layout: uses layout
sim.py - Build and verify → Compositional backend: uses backend
sim.py - Circuit layout → Gate tiles: uses tile builders
layout.py - Circuit layout → Layout diagnostics: dumps layout state
debug.py - Build and verify → Build snapshots: uses snapshots
sim.py - Build exporters → Minecraft world: exports build commands
README.md