Redstone Debugger Docs

~1 min read v1.0.0 Fabric

Overview #

Redstone Debugger is a professional suite for recording, visualizing, simulating, and analyzing redstone circuits. It captures circuit activity into a replayable timeline, runs diagnostics that surface wiring problems, and can call on an AI provider to explain what a circuit is doing.

Redstone is the most complex thing you can build in Minecraft, yet debugging it means staring at torches. Redstone Debugger records circuit activity, replays it, and analyzes it — turning redstone engineering into something you can inspect, not guess.

Quick start #

  1. Install Fabric and drop the Redstone Debugger JAR into your mods folder.
  2. Launch the game and open a single-player world.
  3. Run /rd help to explore the command suite.
  4. Record a circuit, then open the timeline to inspect events.
  5. Run diagnostics to surface problems in the recorded activity.

Frequently asked questions #

Does it slow the game down?
The recorder is lightweight and auto-stops at extreme event counts, backed by a performance manager with profiler, metrics, caching and a memory monitor.
Do I need an AI provider?
No — all core diagnostics work fully offline. AI insights are an optional add-on.
Is it server-side or client-side?
It operates client-side; recording is single-player oriented.
What can it record?
25 event types via mixins — wire, lever, repeater, comparator, observer, torch, button, piston, pressure plate and more.
Is there a command interface?
Yes — /rdebug covers recorder, timeline, clear, export and perf, plus world and HUD overlays.
Can it explain my circuit?
Yes — the AnalysisEngine runs 12 algorithms (signal tracing, dependency chains, root cause, SCC cycles, critical path, clock detection) and can call an optional AI provider (including local Ollama).

Compatibility #

PropertyValue
Loader / platformFabric
Minecraft versions1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.2, 26.2
Latest version1.0.0

Best-tested on 1.21.11; some advertised versions lack version-specific compat code — verify before relying on them.

Learn more. Step-by-step walkthroughs live in the tutorials, with install guides for every platform and a general guide to configuration. Still stuck? Open the support portal and we'll reply from support@herostudios.dev.