Community listing page, reviews may not be monitored by the author.
GradleMC
No reviews yet
๐ In-game diagnostics, stability checks, and exportable troubleshooting reports for modded Minecraft like never before.
Community voices
Reviews
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
Description

Minecraft Java Edition โข Diagnostics and troubleshooting
GRADLEMC
Stop guessing.
Start diagnosing.
Know your environment. Understand performance issues. Collect real evidence.
GradleMC brings local diagnostics, intelligent rule-based checks, and exportable troubleshooting reports to modded Minecraft.
ย ย DOWNLOAD GRADLEMC ย ย ย ย ย VIEW SOURCE ย ย
Local-first โข No telemetry โข No cloud AI โข Client and server tools
01 / INSPECT
Environment and memory
02 / ANALYSE
Performance and stability
03 / EXPORT
Actionable local reports

An in-game overview of diagnostic signals. Screenshots may show an earlier release; the exact interface varies by build.
Built for evidence, not guesswork
When Minecraft feels wrong, find out why.
Stuttering, low FPS, memory pressure, overloaded servers, mod conflicts and bad configurations can look remarkably similar. GradleMC helps players, modpack creators, testers and server administrators understand what is running and gather useful data before changing things at random.
Environment / 01
Know your setup
Inspect supported Minecraft, loader, GradleMC, JVM, operating-system, mod and memory information. Verify the environment you are actually troubleshooting.
Performance / 02
Measure, don't assume
Capture bounded FPS or performance samples where supported. Review available memory, TPS/MSPT, entity, block-entity and world-generation signals.
Smart Diagnostics / 03
Understand the signals
Use local rules, scoring and prioritised advice to highlight suspicious conditions and explain where more evidence is needed. No cloud inference.
Reports / 04
Keep usable evidence
Export local troubleshooting reports for comparisons, support requests and bug reports. TXT and JSON outputs are available in supported releases.
The workflow
From โit lagsโ to a useful diagnosis.
01
INSPECT
Check versions, mods and system context.
02
MEASURE
Collect bounded, relevant runtime data.
03
DIAGNOSE
Review rule-based findings and context.
04
EXPORT
Keep reports for controlled comparisons.
Inside the toolkit
Useful tools, one diagnostic home.
Use the in-game diagnostics screen, client keybind and supported /gradlemc commands to inspect the environment, run checks, review reports and access available performance tools. Client FPS and overlay features require a supported graphical client; dedicated servers expose applicable server-side capabilities.

Bounded profiling and runtime sampling controls, where available.

Local reports make investigations easier to review and share deliberately.
Smart Diagnostics โข Local by design
Guidance based on evidence, not a chatbot.
GradleMC's Smart Diagnostics applies local rules and scoring to available diagnostic information. It can flag possible issues, prioritise advice and identify gaps in the evidence. It does not send data to an AI service, perform LLM inference or guarantee a definitive root cause.
Compatibility and download
One project. Different builds.
Match the Minecraft version and loader exactly. Forge, Fabric, NeoForge and Quilt releases are not interchangeable, and features may differ between the releases listed below. Always choose an actually published file on CurseForge Files.
Current 1.20.1 line
Minecraft 1.20.1
GradleMC v1.1.0
Forge โข Fabric
Java 17 โข Kotlin implementation
Published
Minecraft 1.21.11
GradleMC v1.0.0
Forge โข Fabric โข NeoForge
Java 21
Published
Minecraft 26.1.2
GradleMC v1.0.0
Forge โข Fabric โข NeoForge
Java 25
Legacy โข Discontinued
Quilt 1.20.1
GradleMC v1.0.0
Java 17
No further Quilt releases planned.
Quick start โข v1.1.0 for Minecraft 1.20.1
Install the right dependencies.
Forge โข Java 17
Forge installation
- Set up Minecraft 1.20.1 with compatible Forge and Java 17.
- Install Kotlin for Forge.
- Add the GradleMC Forge jar to your
modsfolder. - Start Minecraft and run
/gradlemc.
Jar: gradlemc-1.1.0-forge-1.20.1.jar
Fabric โข Java 17
Fabric installation
- Set up Minecraft 1.20.1 with compatible Fabric Loader and Java 17.
- Install Fabric API and Fabric Language Kotlin.
- Add the GradleMC Fabric jar to your
modsfolder. - Start Minecraft and run
/gradlemc.
Jar: gradlemc-1.1.0-fabric-1.20.1.jar
Important: Kotlin does not replace Minecraft's Java runtime. The two 1.20.1 v1.1.0 builds require Java 17 and their listed loader-specific dependencies. For 1.21.11 and 26.1.2, follow the dependencies of the exact selected file.
Control and commands
Diagnostics at your fingertips.
Use the diagnostics GUI where supported, or run lowercase /gradlemc commands. The installed build's command tree is authoritative: commands and permissions vary by Minecraft version, loader and client/server side.
/gradlemc gui
Open the diagnostic interface where supported.
/gradlemc status
Get a compact current status summary.
/gradlemc version
Inspect version and environment context.
/gradlemc memory
Review JVM memory information.
/gradlemc check
Run available diagnostics.
/gradlemc export
Export local evidence.
/gradlemc reports latest
Find the newest report.
/gradlemc smart advice
Review rule-based suggestions.
Additional supported commands include timed FPS tests, performance sampling, and Smart Diagnostics scoring. Client-only tools do not run on headless dedicated servers.
Privacy first
Your diagnostics stay yours.
No behavioural telemetry. No analytics tracking. No cloud AI or LLM service. No automatic report uploads.
GradleMC generates diagnostic information locally and does not automatically transmit your exported troubleshooting evidence. Generated output is stored beneath <gameDir>/gradlemc/ where supported.
Before you share: review reports for local paths, mod names, JVM details and other instance or system information.
What GradleMC is โ and isn't
A diagnostics utility, not an FPS booster. It gathers clues and measurements; it does not automatically optimise your GPU or repair every broken modpack.
A practical first stop, not a replacement for deep profilers. Investigations may still require tools such as Spark, Java Flight Recorder or async-profiler.
For Minecraft Java Edition, not Bedrock. Only listed, published loader/version combinations are supported.

An optional client-side runtime overlay in a supported build; available fields vary by release.
Support and development
Found a bug? Bring the evidence.
For reproducible GradleMC issues, include your Minecraft version, loader and loader version, GradleMC jar, Java version, dependency versions, reproduction steps, expected versus actual behaviour, and relevant reviewed logs or reports. Screenshots are helpful for interface bugs.
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Get it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources