数据挖掘工

数据挖掘工

MC 26.1.2 的诊断模组。将注册表导出为 JSON，监控 FPS/MSPT，追踪实时事件，测量延迟（进食/破坏），通过逐个模组分析剖析模组影响。所有 I/O 异步，始终开启追踪，零游戏线程阻塞。

🔍 Data Miner

Minecraft 的综合诊断与分析模组 — 不阻塞游戏线程。

✨ 概览

Data Miner 可以将所有游戏注册表导出为增强型 JSON，监控 FPS 和 MSPT，追踪实时游戏事件，测量操作延迟（进食、破坏方块、慢速 tick），通过逐模组分析评估模组影响，重定向嘈杂的第三方日志，并检测已知的模组问题 — 所有这些都不会阻塞游戏线程。

🎯 功能

📋 日志重定向

其他模组发出的 WARN/ERROR 消息会被自动捕获，从 latest.log 重定向到 Data Miner 自己的 logs/captured.log，保持主日志整洁。

🧠 智能问题检测

自动检测已知模式 — 缺失的 refmap、访问转换器、缺失的纹理、pack.meta 错误 — 并将结构化数据以 JSON Lines 格式保存到 startup/logs/issues.jsonl。

🗂️ 注册表导出

所有 BuiltInRegistries 导出为 JSON，包含详细属性：硬度、食物值、音效、维度等。

📊 性能监控

通过 /dataminer perf start/stop 追踪 FPS（最低/最高/平均）和 MSPT。每个慢速 tick 都会附带按模组分组的实体分析，以确定导致卡顿的模组。

⏱️ 延迟分析器

自动追踪进食时间、破坏方块时间和慢速 tick（MSPT > 50ms）。默认运行，无需命令。使用 /dataminer latency stats 查看实时统计。

📦 完整模组分析

startup/mod_analysis.json 包含每个模组的 ID、版本、注册表计数、依赖项和潜在问题（缺少依赖、实体数量过高）。

🔴 事件追踪

实时游戏事件：玩家移动、方块放置、伤害、实体生成/死亡、区块加载。

⚠️ 错误收集

所有未捕获的异常及其完整堆栈跟踪都会被记录到 startup/errors/ 和 events/errors/。

⚡ 异步 I/O

所有文件操作均在后台线程运行 — 零游戏卡顿。

📋 需求

项目 版本
Minecraft 26.1.2
NeoForge 26.1.2.76+
Java 25

🎮 命令

  • /dataminer dump — 将所有注册表导出为 JSON（异步）
  • /dataminer mods analyze — 重新生成完整的模组分析
  • /dataminer perf start/stop — 开始/停止 FPS + MSPT 监控
  • /dataminer events start/stop — 开始/停止实时事件追踪
  • /dataminer latency start/stop — 开始/停止延迟测量
  • /dataminer latency stats — 显示实时延迟统计

🙏 鸣谢

由 Stalking Dragons 开发。

Codex Stalking Dragons

https://codex.skdragons.com/

Codex Stalking Dragons — Minecraft 模组开发