GradleMC

GradleMC

In-game diagnostics, stability checks, and exportable troubleshooting reports for Minecraft Forge modpacks.

GradleMC helps players, modpack makers, and testers understand what is happening inside a modded Minecraft instance before the troubleshooting turns into blind guessing, ritual sacrifice, and deleting random mods until the pack limps awake.

It provides an in-game GUI, readable commands, local stability checks, bounded performance tests, mod inspection tools, memory diagnostics, worldgen observation, and exportable reports designed to make crash, lag, and support conversations clearer.

This page is for GradleMC v1.0.0, built for Minecraft Java Edition 1.20.1 on Forge.

What is GradleMC?

GradleMC is a practical diagnostics companion for modded Minecraft. It does not magically repair broken modpacks. It does something more useful: it gives you organized, local evidence so you can stop guessing and start investigating.

Use it to inspect memory pressure, loaded mods, stability signals, nearby entity load, block entity counts, server performance samples, client FPS snapshots, worldgen pressure, diagnostic reports, and issue bundles from inside the game.

Key features

• In-game GUI: open a compact GradleMC dashboard with /gradlemc gui or the configurable keybind.
• Readable command tools: use lowercase /gradlemc commands for status, memory, reports, mods, performance, entities, worldgen, and diagnostics.
• Smart Diagnostics: review local stability scores, risk signals, explanations, and recommended next steps.
• Adaptive Diagnostics: local rule-based/adaptive checks that explain what they are seeing without pretending to be magic.
• Memory inspection: check runtime memory usage and pressure signals.
• Mod inspection: count loaded mods, preview mod details, and search by mod ID or display name.
• Entity and block entity scans: run bounded nearby scans from the player’s current position.
• Server performance sampling: collect short TPS/MSPT samples for a chosen duration.
• Client FPS testing: run bounded FPS tests and generate local FPS reports.
• Worldgen observation: passively observe loaded chunk and worldgen pressure during a short diagnostic session.
• Reports and exports: generate local text reports, diagnostics exports, and issue bundles for easier troubleshooting.

Adaptive Diagnostics, not cloud AI

GradleMC includes Adaptive Diagnostics, which means local heuristics, thresholds, status fields, and explainable recommendations based on information collected during checks and diagnostic sessions.

It is not ChatGPT, an LLM, generative AI, cloud AI, telemetry, embeddings, external inference, neural networks, hidden analytics, or a background data collector.

• No cloud AI.
• No generative AI.
• No telemetry.
• No hidden analytics.
• No background report uploads.
• No external inference.

How to open GradleMC

• Run /gradlemc gui in-game.
• Use the configurable Open GradleMC GUI keybind in the GradleMC controls category.
• The default keybind is G.

Useful commands

• /gradlemc help - show command help.
• /gradlemc gui - open the GradleMC GUI.
• /gradlemc status - show a compact diagnostics overview.
• /gradlemc memory - inspect memory status.
• /gradlemc smart score - show the current local stability score.
• /gradlemc smart advice - show prioritized recommendations.
• /gradlemc smart explain - explain the current Smart Diagnostics result.
• /gradlemc ai status - show Adaptive Diagnostics status through the compatibility command group.
• /gradlemc mods count - count loaded mods.
• /gradlemc mods search <text> - search loaded mods by ID or name.
• /gradlemc entities 128 - scan nearby entities within a bounded radius.
• /gradlemc blockentities 128 - scan nearby block entities within a bounded radius.
• /gradlemc perf start 30 - collect a 30-second server performance sample.
• /gradlemc testfps start 30 - collect a 30-second client FPS sample.
• /gradlemc worldgen start 10 - observe chunk/worldgen pressure for 10 seconds.
• /gradlemc reports latest - show the latest report summary.
• /gradlemc export - create a local diagnostics export.
• /gradlemc issuebundle - create a troubleshooting bundle.

/gradlemc perf <seconds> is available as a compatibility alias, but /gradlemc perf start <seconds> is the preferred form.

Reports and exports

GradleMC writes local reports that help players, pack makers, and testers share useful context when asking for support.

• Diagnostics reports: summarize selected local checks and runtime context.
• FPS reports: written after bounded client FPS tests.
• Performance reports: record short TPS/MSPT sampling sessions.
• Worldgen reports: summarize passive chunk and worldgen-pressure observations.
• Issue bundles: package troubleshooting evidence into a more shareable format.

Always review reports before sharing them publicly. They may include useful technical context such as mod lists, Java details, local paths, runtime information, and diagnostic output.

Compatibility

• Mod version: GradleMC v1.0.0.
• Minecraft: Java Edition 1.20.1.
• Loader: Forge.
• Tested Forge version: 47.4.20.
• Java: 17.
• Mod ID: gradlemc.
• Release file: gradlemc-1.0.0-forge-1.20.1.jar.

This v1.0.0 release is for Forge 1.20.1. It does not claim Fabric, Quilt, NeoForge, Bedrock Edition, or other Minecraft-version support.

GUI, keybind, and FPS testing are client-side features. GradleMC is designed as a common diagnostics mod with client-only features isolated where needed, but dedicated-server usage should still be tested in your own setup instead of assumed.

Installation

• Install Minecraft Forge for Minecraft Java Edition 1.20.1.
• Use Java 17.
• Place gradlemc-1.0.0-forge-1.20.1.jar in your instance mods folder.
• Launch the game.
• Run /gradlemc gui or press the configured keybind.

Known limitations

• GradleMC does not automatically fix broken modpacks.
• GradleMC does not replace crash-log reading, Spark, VisualVM, or deeper profiling tools.
• Short FPS, TPS, MSPT, and worldgen samples are snapshots, not long-term benchmarks.
• Worldgen observation is passive and does not force-generate chunks.
• Adaptive Diagnostics uses local explainable heuristics, not cloud AI or generative AI.
• Reports organize evidence, but they cannot prove every possible compatibility issue.

Project information

• Project name: GradleMC.
• Project ID: 1585182.
• Author: Soumyajit.
• License: Apache-2.0.
• Version: 1.0.0.
• File: gradlemc-1.0.0-forge-1.20.1.jar.

REQIRES FORGE 47.4.20 OR ABOVE!