Redstone Debugger tutorial

Install Redstone Debugger #

Install Fabric Loader for 1.21 (plus Fabric API if the downloads page asks for it), place the JAR in your mods folder, and launch with the Fabric profile.

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

Working with Redstone Debugger #

Product-specific steps, separate from the general install guide above.

Record a circuit

Press **R** near a circuit to start/stop recording, then step back through the event timeline.

Ask for an explanation

It auto-diagnoses in chat and understands plain questions:

/rd explain
/rdebug diagnose <n>

Best version

Best-tested on **1.21.11** — 26.x builds are newer/bundled mappings; keep the build matched to your Minecraft version.

Folder locations by platform #

Platform	mods / resourcepacks folder	config folder
Windows	%appdata%\.minecraft\mods · \resourcepacks	%appdata%\.minecraft\config
macOS	~/Library/Application Support/minecraft/mods	~/Library/Application Support/minecraft/config
Linux	~/.minecraft/mods · ~/.minecraft/resourcepacks	~/.minecraft/config

MultiMC / Prism users: these folders live inside Instances/<instance>/.minecraft/. Match the build to your exact Minecraft version — the compatibility table in the docs lists every supported version.

Configure #

Settings live in the config folder (JSON5 files you can edit by hand) and, where available, in the in-game settings screen the mod adds. The exact keys and keybinds are listed in the documentation and the FAQ below.

Tips for Redstone Debugger #

Keep Redstone Debugger on the version range shown on its product page.
If it doesn't load, confirm the JAR is in the right mods folder for the launcher and version you chose.
Bedrock Edition, mobile, and console can't run Java Edition mods or packs — for a port or custom variant, request a commission.

Redstone Debugger FAQ #

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).

Still stuck? Open a guided request — every message is tagged and answered from support@herostudios.dev. Always include your Minecraft version and product version.

Redstone Debugger