GradleMC

GradleMC

🐘 前所未有地，为模组化《我的世界》提供游戏内诊断、稳定性检查以及可导出的故障排除报告。

GradleMC预览查看大图

停止猜测。查看游戏实际在做什么。

GradleMC 是一个面向本地、隐私优先的模组化 Minecraft 诊断与故障排除模组。检查环境、衡量限界运行时行为、解读现有证据，并导出比“它卡了”更有用的报告。

诊断工具 • 非 FPS 增强器 • 无云端 AI • 包含客户端和服务端构建

浏览 GradleMC 文件 源代码与文档 报告问题

GradleMC 诊断概览，显示稳定性、内存、FPS 和最近的报告信息

游戏内概览将当前证据和最近的输出集中在一处。

GradleMC 的功能

GradleMC 帮助玩家、整合包创作者、服务器管理员、测试人员和开发者了解模组化游戏实例，避免在故障排除退化为随机删除模组时毫无头绪。

它通过游戏内界面、小写 /gradlemc 命令和本地文件暴露有用的环境和运行时信息。它可以突出可疑的压力点并生成可审查的证据。它不会自动修复整合包、绕过硬件限制或凭空制造帧数。

一个实用的工作流程

01 — 检查

检查当前激活的 Minecraft 版本、加载器、Java 运行时、GradleMC 构建、已加载模组、重要路径、配置状态及周围运行时上下文。

02 — 衡量

运行限界观察，包括 FPS、服务器性能、TPS/MSPT、内存压力、实体、方块实体、世界生成以及已安装构建支持的轻量级分析。

03 — 解读

使用本地基于规则的智能诊断连接可用信号、显示缺失证据、计算分数，并呈现带有上下文优先级的建议。

04 — 导出

为支持请求、bug 报告、测试比较和整合包维护生成报告、分析器摘要和问题包。

核心能力

检查游戏实例

  • Minecraft、加载器、Java 和 GradleMC 构建信息。
  • 已加载模组的摘要、计数、搜索和检查工具。
  • 配置、报告和其他相关本地路径。
  • 内存状态和运行时上下文。

衡量运行时压力

  • 客户端 FPS 和定时 FPS 测试（需安装客户端支持）。
  • 服务器性能观察，包括 TPS/MSPT 相关证据。
  • 内存、实体、方块实体和世界生成压力信号。
  • 限界刻分析、轻量级 CPU 分析、轻量级内存分析和组合分析模式，支持 TXT 和 JSON 输出。

解读可用证据

  • 本地基于规则的智能诊断分数和建议。
  • 支持性证据、置信度上下文、趋势和缺失数据警告。
  • 无需云端推理的自适应本地阈值和观察。

导出对支持有用的内容

  • 可读的诊断报告和最近报告发现。
  • 分析器摘要和本地分析文件。
  • 用于针对性故障排除的可审查问题包。

GradleMC 分析器界面，显示限界组合分析选项及其限制

分析器刻意限界，并诚实地说明其范围；它并非异步分析器或分配分析器。

客户端与服务端角色

安装在客户端以获取

诊断 GUI、可配置的按键绑定、可选的覆盖层、当前和平均 FPS 信息、定时 FPS 测试以及客户端环境上下文。

安装在服务端以获取

服务端命令执行、权限控制的测试、TPS/MSPT 观察、内存和环境报告、已加载模组检查、世界生成观察、分析、问题包和智能诊断摘要。

当调查需要客户端和服务端证据时，请在两侧都安装 GradleMC。仅客户端的功能无法从专用服务器控制台运行，因为控制台本质上不是一个 Minecraft 窗口。

支持的版本线

公开文件目前涵盖以下确切的加载器系列。CurseForge 文件页面 是 GradleMC 最新补丁版本的权威信息来源。

Minecraft 1.20.1 — Java 17

Forge • Fabric • Quilt

Minecraft 1.21.11 — Java 21

Forge • Fabric • NeoForge

Minecraft 26.1.2 — Java 25

Forge • Fabric • NeoForge

精确匹配规则： 每个 jar 文件绑定到一个 Minecraft 版本和一个加载器。Forge、Fabric、NeoForge 和 Quilt 文件不可互换。重命名 jar 文件只是改变了文件名，而非现实。

安装

  1. 选择您确切的 Minecraft 版本和加载器。
  2. 使用该 Minecraft 版本线对应的 Java 版本。
  3. 从 CurseForge 文件页面下载匹配的 GradleMC jar 文件。
  4. 将其放入游戏实例或服务端的 mods 文件夹。
  5. 启动客户端或服务端。
  6. 运行 /gradlemc 以查看该构建提供的命令树。

基本命令

命令字面量为小写。权限要求和端侧可用性仍然适用。

  • /gradlemc — 显示已安装构建的命令帮助。
  • /gradlemc gui — 为玩家打开游戏内界面。
  • /gradlemc status — 显示简洁的诊断摘要。
  • /gradlemc version — 显示 GradleMC、Minecraft、加载器和 Java 上下文。
  • /gradlemc memory — 检查 JVM 内存信息。
  • /gradlemc check — 运行本地检查。
  • /gradlemc testfps start <seconds> 和 stop — 运行或停止限界客户端 FPS 测试。
  • /gradlemc perf start <seconds> 和 stop — 运行或停止限界服务端性能采样。
  • /gradlemc export — 写入本地故障排除证据。
  • /gradlemc reports latest — 定位最新报告。
  • /gradlemc smart score 和 /gradlemc smart advice — 检查本地基于规则的发现。

其他命令可用于分析、世界生成观察、模组、实体、报告、问题包、规则和其他诊断。请使用 /gradlemc 而非将旧网页视为不可更改的经典。

报告和生成的文件

GradleMC 将其本地数据写入：

<gameDir>/gradlemc/

根据使用的构建和操作，该目录可包含报告、导出文件、问题包、分析器输出、规则和支持性诊断数据。

分享前请审查。 生成的证据可能包含本地路径、Java 信息、模组名称、加载器详细信息、实例信息和系统上下文。GradleMC 不会自动上传这些文件；发布它们是您的决定。

本地优先与隐私优先

  • 无行为遥测或分析。
  • 无云端 AI、LLM 集成或隐藏的远程推理。
  • 无自动报告上传。
  • 不广泛扫描不相关的私人文件。
  • 生成的证据在您选择分享之前保持本地状态。

智能诊断并非生成式 AI。 它是一个本地基于规则的系统，用于评估 GradleMC 收集的证据，识别缺失信息，并生成带分数的、按优先级排序的指导。

诚实的限制

  • 非崩溃修复机器人： 它可以暴露证据，但不能自动修复每个整合包。
  • 非优化模组： 它衡量性能，但不取代 Sodium、Embeddium 或细致的配置。
  • 非深度分析器替代品： 复杂的 CPU、分配或刻调查可能仍需要 Spark、VisualVM、async-profiler 或类似的专用工具。
  • 非通用 jar 文件： 每个加载器和 Minecraft 版本都需要其自己匹配的文件。
  • 非基岩版工具： GradleMC 针对列出的 Minecraft Java 版。

支持与项目信息

使用 GitHub 仓库 获取文档和源代码。通过 问题追踪器 报告可重现的 GradleMC 错误，并提供确切的 Minecraft 版本、加载器、Java 版本、jar 文件名、重现步骤和已审查的报告片段。

GradleMC 是一个独立的 Minecraft 项目。它与 Gradle, Inc. 或 Gradle 构建系统无关，未获其认可，也不是其一部分，并且不能替代 Gradle。

可选服务器托管合作伙伴

需要一个单独的测试服务器？

下面的合作伙伴链接提供首次月费 25% 的折扣。托管是可选的，并非使用 GradleMC 的必要条件。

[可选 BisectHosting 合作伙伴优惠：创建 Minecraft 服务器可享受首月 25% 折扣]

Apache-2.0 • CurseForge 项目 ID 1585182 • Minecraft Java 版 • 客户端和服务端