兼容性监视

兼容性监视

一个轻量级Minecraft Forge诊断模组,监控警告和错误日志,记录潜在的模组兼容性问题,并帮助服务器管理员排查问题。

CompatWatch

一款轻量级的 Minecraft Forge 诊断模组,可监控警告与错误日志、记录潜在的模组兼容性问题,并帮助服务器管理员排查问题。

概述

CompatWatch 是一款面向 Minecraft Java 版 1.20.1(运行于 Minecraft Forge)的诊断工具。

它会监控选定的警告与错误日志消息,分析可识别的错误模式,并将潜在的兼容性问题记录到可搜索的诊断历史中。

CompatWatch 不会自动更改你的模组或游戏文件,而是帮助你了解发生了什么,并提供诊断信息,供你在调查崩溃、Mixin 失败、缺失类、依赖问题及其他模组相关问题使用。

功能

  • 自动日志监控
    通过 Log4j 监控选定的 WARN 与 ERROR 日志事件。

  • 诊断分类
    可识别多种诊断模式,包括 Mixin 应用失败、缺失类或方法、依赖问题、重复注册以及模组初始化失败。

  • 诊断历史
    保留检测到的问题记录,包括其类别、摘要、时间戳和出现次数。

  • 重复检测
    将匹配的诊断事件进行分组,而不是为每次重复出现创建单独的历史记录条目。

  • 按世界持久化
    为每个世界分别保存诊断历史,包括专用服务器世界。

  • 诊断命令
    提供用于查看诊断摘要与历史记录,以及运行受控诊断测试的命令。

命令

所有命令均需要权限等级 2。

  • /compatwatch summary —— 显示已记录诊断问题的摘要。

  • /compatwatch history —— 显示诊断历史。

  • /compatwatch history <page> —— 显示指定的历史记录页面。

  • /compatwatch test —— 创建一个受控的手动测试事件。

  • /compatwatch logtest —— 生成一个受控的合成 Mixin 日志事件,用于测试日志监控流程。

重要提示: 测试命令会生成人工诊断事件,并不代表存在真实的模组冲突。

兼容性

  • Minecraft:Java 版 1.20.1

  • 模组加载器:Minecraft Forge

  • Java:17

  • 已测试的 Forge 环境:47.4.10

  • 已在单人游戏和专用服务器环境中测试。

重要说明

CompatWatch 是一款诊断工具,而非自动修复工具。

  • 它不会自动修复模组冲突。

  • 它不会修改或移除其他模组。

  • 它不保证能够检测到所有兼容性问题。

  • 检测到的日志模式并不一定代表真正的根本原因。

  • 诊断信息应被视为调查线索,而非确定性结论。

安装

  1. 安装 Minecraft Java 版 1.20.1。

  2. 安装 Minecraft Forge。

  3. 确保 Java 17 可用。

  4. 将 CompatWatch 的 JAR 文件放入 Minecraft 的 mods 文件夹。

  5. 启动游戏或专用服务器。

繁体中文(繁體中文)

模组介绍

CompatWatch 是一款 Minecraft Forge 诊断工具,专门协助玩家与服务器管理员观察日志、记录可能的模组兼容性问题,并提供后续调查所需的信息。

它会监控指定的 WARN 与 ERROR 日志,分析可识别的错误特征,并将诊断结果保存至历史记录。

主要功能

  • 自动监控部分警告与错误日志。

  • 识别 Mixin 应用失败、缺失类别或方法、依赖问题、重复注册及模组初始化失败等特征。

  • 保存诊断历史、发生时间与出现次数。

  • 合并重复诊断事件,避免历史记录过度膨胀。

  • 每个世界分别保存诊断历史。

  • 支持单人世界及专用服务器。

  • 提供诊断摘要、历史查询及受控测试命令。

注意事项

CompatWatch 不会自动修复模组冲突,也不会修改或删除其他模组。

日志中的诊断线索不一定代表真正的问题根源,请将结果视为调查参考,而非绝对结论。

支持环境

  • Minecraft Java 版 1.20.1

  • Minecraft Forge

  • Java 17