Local diagnostics, performance evidence, Smart Diagnostics, and exportable troubleshooting reports for modded Minecraft.
GradleMC v1.1.0 is available for both Forge and Fabric on Minecraft 1.20.1. Both current 1.20.1 implementations are Kotlin-based and still run on Java 17.
| Loader | Required dependencies | Artifact |
|---|---|---|
| Forge | Kotlin for Forge | gradlemc-1.1.0-forge-1.20.1.jar |
| Fabric | Fabric API + Fabric Language Kotlin | gradlemc-1.1.0-fabric-1.20.1.jar |
The previous Java GradleMC implementation has been replaced in the current 1.20.1 v1.1.0 line. Kotlin does not replace Minecraft's Java runtime; Minecraft 1.20.1 still requires Java 17.
The checked-in Forge and Fabric 1.20.1 source trees are synchronized to v1.1.0.
GradleMC is a local, privacy-first diagnostics and troubleshooting mod for modded Minecraft. It helps players, modpack creators, server owners, testers, and developers inspect a modded instance before troubleshooting turns into blind guessing.
It provides an in-game diagnostics interface, lowercase /gradlemc commands, memory and environment inspection, bounded performance sampling, local Smart Diagnostics, and exportable reports.
GradleMC is not an FPS booster, crash-fixing bot, cloud AI service, or replacement for specialist profilers.
| Status | Loader | GradleMC | Minecraft | Java | Dependency / notes | Artifact |
|---|---|---|---|---|---|---|
| Latest | Forge | 1.1.0 |
1.20.1 |
17 |
Kotlin; Kotlin for Forge required | gradlemc-1.1.0-forge-1.20.1.jar |
| Latest | Fabric | 1.1.0 |
1.20.1 |
17 |
Kotlin; Fabric API + Fabric Language Kotlin required | gradlemc-1.1.0-fabric-1.20.1.jar |
| Published | Forge | 1.0.0 |
1.21.11 |
21 |
Forge 61.1.8 |
gradlemc-forge-1.21.11-1.0.0.jar |
| Published | Fabric | 1.0.0 |
1.21.11 |
21 |
Fabric Loader 0.19.3; Fabric API 0.141.4+1.21.11 |
gradlemc-fabric-1.21.11-1.0.0.jar |
| Published | NeoForge | 1.0.0 |
1.21.11 |
21 |
NeoForge 21.11.42 |
gradlemc-neoforge-1.21.11-1.0.0.jar |
| Published | Forge | 1.0.0 |
26.1.2 |
25 |
Forge 26.1.2-64.0.11 |
gradlemc-forge-26.1.2-1.0.0.jar |
| Published | Fabric | 1.0.0 |
26.1.2 |
25 |
Fabric release | gradlemc-fabric-26.1.2-1.0.0.jar |
| Published | NeoForge | 1.0.0 |
26.1.2 |
25 |
NeoForge 26.1.2.78 |
gradlemc-neoforge-26.1.2-1.0.0.jar |
| Discontinued | Quilt | 1.0.0 |
1.20.1 |
17 |
Legacy only; no new GradleMC Quilt updates | gradlemc-quilt-1.20.1-1.0.0.jar |
Use the exact jar matching your Minecraft version and loader. Renaming a jar changes its filename, not its loader compatibility.
No new GradleMC versions will be released for Quilt. Existing Quilt files may remain available as legacy downloads, but the line is discontinued and will not receive new GradleMC releases.
- Install Minecraft Java Edition
1.20.1with Forge. - Use Java
17. - Install Kotlin for Forge.
- Install
gradlemc-1.1.0-forge-1.20.1.jar. - Launch Minecraft and run
/gradlemc.
- Install Minecraft Java Edition
1.20.1with Fabric Loader. - Use Java
17. - Install Fabric API.
- Install Fabric Language Kotlin.
- Install
gradlemc-1.1.0-fabric-1.20.1.jar. - Launch Minecraft and run
/gradlemc.
Open the GUI where supported with:
/gradlemc gui
Useful commands include:
/gradlemc status
/gradlemc version
/gradlemc memory
/gradlemc check
/gradlemc export
/gradlemc reports latest
/gradlemc smart score
/gradlemc smart advice
Minecraft commands are lowercase. Use /gradlemc, not /GradleMC.
| Feature | What it does |
|---|---|
| Diagnostics GUI | In-game control center for checks, status, reports, settings, and supported actions. |
| Command tree | Lowercase /gradlemc commands for diagnostics, status, memory, reports, and Smart Diagnostics. |
| Environment inspection | Minecraft, loader, JVM, GradleMC, loaded-mod, config, OS, and path context where supported. |
| Memory diagnostics | JVM heap and memory-pressure information. |
| Performance evidence | Bounded FPS, TPS/MSPT, entity, block-entity, worldgen, and other runtime signals where supported. |
| Smart Diagnostics | Local rule-based scoring and prioritised advice; no cloud inference. |
| Exportable reports | Local troubleshooting evidence for bug reports and controlled comparisons. |
Generated output is stored beneath <gameDir>/gradlemc/ where supported. Review reports before sharing because diagnostic files can contain local paths, mod names, loader/JVM details, and system context.
GradleMC is local by design:
- no behavioural telemetry;
- no analytics tracking;
- no cloud AI or LLM integration;
- no hidden remote diagnostic inference;
- no automatic report upload;
- no broad scanning of unrelated private files.
Smart Diagnostics is local and rule-based. Generated evidence remains local until you choose to share it.
| Screenshot 1 | Screenshot 2 | Screenshot 3 |
|---|---|---|
 |
 |
 |
More screenshots live in docs/SCREENSHOTS.md.
Use the source project matching the loader and Minecraft version.
Current 1.20.1 Kotlin projects:
GradleMC/Forge/Minecraft 1.20.1/
GradleMC/Fabric/Minecraft 1.20.1/
Other checked-in source projects include Forge, Fabric, and NeoForge targets for newer published Minecraft versions. Quilt 1.20.1 remains legacy/discontinued.
Use docs/RELEASE_CHECKLIST.md before release/export work.
| Path | Purpose |
|---|---|
GradleMC/ |
Loader/version source projects. |
Releases/ |
Committed release artifacts where present. |
Screenshots/ |
README and documentation screenshots. |
CHANGELOG.md |
Release history. |
ROADMAP.md |
Public planning and loader support policy. |
SUPPORT.md |
Support guide. |
SECURITY.md |
Security policy. |
CONTRIBUTING.md |
Contribution rules. |
AGENTS.md |
Maintainer and coding-agent operating rules. |
- CurseForge Project ID:
1585182 - License: Apache-2.0
- Telemetry: none
- Cloud AI / LLM usage: none
GradleMC is an independent Minecraft project. It is not affiliated with, endorsed by, or part of Gradle, Inc. or the Gradle Build Tool, and it does not replace Gradle.