Diagnostics • Stability • Reports • Smart Local Checks
In-game diagnostics and exportable troubleshooting evidence for modded Minecraft.
GradleMC helps players, pack makers, server owners, and testers understand what is happening inside a modded instance before support turns into random guesses and useless reports.
Minecraft 1.20.1 + 26.1.2 | Forge | Fabric | Quilt | Java 17 / 25 | Client & Server
GradleMC is a practical diagnostics control center for modded Minecraft. It gives you readable in-game commands, a diagnostics GUI, memory checks, loader and mod inspection, performance samples, Smart Diagnostics, issue bundles, and local reports you can actually use.
It does not pretend to magically fix your pack. It gives you evidence so you can debug with facts instead of vibes.
| Forge 26.1.2 | gradlemc-forge-26.1.2-1.0.0.jar |
Forge 26.1.2 public release; Java 25 |
| Forge 1.20.1 | gradlemc-1.0.2-forge-1.20.1.jar |
Quick Actions overlay hotfix; Java 17 |
| Fabric 26.1.2 | gradlemc-fabric-26.1.2-1.0.0.jar |
Fabric 26.1.2 public release; Java 25 |
| Fabric 1.20.1 | gradlemc-fabric-1.20.1-1.0.0.jar |
Fabric 1.20.1 public release; Java 17 |
| Quilt 1.20.1 | gradlemc-quilt-1.20.1-1.0.0.jar |
Quilt public release; Java 17 |
See the instanceInspect Minecraft, loader, Java, GradleMC, loaded mods, paths, configs, and runtime context. |
Catch pressure earlyCheck memory pressure, TPS/MSPT samples, FPS samples, entity density, block entities, and worldgen pressure. |
Export evidenceGenerate readable reports and issue bundles so bug reports are useful instead of vague. |
Use the GUIOpen the diagnostics control center with |
Run Smart DiagnosticsGet local rule-based scoring, advice, evidence, confidence notes, trends, and missing-data warnings. |
Stay localNo telemetry, no analytics, no cloud AI, no hidden online inference, and no LLM pretending to be a mechanic. |
mods folder./gradlemc gui or /gradlemc status.Install GradleMC on the client for the GUI, keybind, overlay, and FPS sampling. Install it on the server for commands, reports, TPS/MSPT sampling, passive worldgen observation, scans, issue bundles, Smart Diagnostics, and adaptive diagnostics state.
/gradlemc gui |
Open the diagnostics GUI. |
/gradlemc status |
Show current GradleMC status and paths. |
/gradlemc version |
Show Minecraft, loader, Java, GradleMC, and mod context. |
/gradlemc memory |
Inspect JVM heap usage and memory pressure. |
/gradlemc check |
Run local stability checks. |
/gradlemc export |
Write a local troubleshooting report. |
/gradlemc reports latest |
Find the newest generated report. |
/gradlemc smart score |
Calculate a local Smart Diagnostics score. |
/gradlemc smart advice |
Show prioritized local recommendations. |
Command rule: Minecraft commands are lowercase. Use /gradlemc, not /GradleMC.
Generated output is written under <gameDir>/gradlemc/, including reports, exports, issue bundles, profiles, and rules.
| No telemetry | No analytics | No cloud AI |
| No LLM integration | No hidden inference | No broad private-file scans |
Smart Diagnostics and adaptive diagnostics are local rule-based systems. They are not cloud AI, LLMs, generative AI, telemetry, analytics, or online inference.
Reports can still include local paths, mod names, Java details, loader details, and runtime context. Review exports before posting them publicly.
Supported public targets: Minecraft Java Edition 1.20.1 on Forge, Fabric, and Quilt, plus Minecraft Java Edition 26.1.2 on Forge and Fabric.
Not currently claimed here: NeoForge, Bedrock, or any loader/version pair that does not have a separate matching GradleMC file and release page.
Use GradleMC when a pack is crashing, lagging, acting unstable, or producing support threads where everyone is guessing and nobody has evidence. It gives you cleaner local information for crash, lag, support, and modpack stability debugging.
Less guessing. More evidence. Better troubleshooting.
