Back to mods
CompatWatch project artwork

CurseForge · Minecraft mod

CompatWatch

A lightweight Minecraft Forge diagnostic mod that monitors warning and error logs, records potential mod compatibility issues, and helps server administrators investigate problems.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which CompatWatch release should I use?

Updated 13 days ago
Latest stable file CompatWatch 0.1.0
Game version 1.20.1
Loader Forge

CompatWatch 0.1.0 targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is CompatWatch required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does CompatWatch 0.1.0 need?

CompatWatch 0.1.0. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add CompatWatch without breaking your instance.

Built for CompatWatch 0.1.0. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use CompatWatch 0.1.0. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside CompatWatch 0.1.0. It opens that exact file at the source.

About this project

What does CompatWatch add?

CompatWatch

A lightweight Minecraft Forge diagnostic mod that monitors warning and error logs, records potential mod compatibility issues, and helps server administrators investigate problems.

Overview

CompatWatch is a diagnostic utility for Minecraft Java Edition 1.20.1 running on Minecraft Forge.

It monitors selected warning and error log messages, analyzes recognizable error patterns, and records potential compatibility issues in a searchable diagnostic history.

Instead of automatically changing your mods or game files, CompatWatch helps you understand what happened and provides diagnostic information that you can use when investigating crashes, Mixin failures, missing classes, dependency issues, and other mod-related problems.

Features

  • Automatic Log Monitoring
    Monitors selected WARN and ERROR log events through Log4j.

  • Diagnostic Classification
    Recognizes several diagnostic patterns, including Mixin application failures, missing classes or methods, dependency issues, duplicate registrations, and mod initialization failures.

  • Diagnostic History
    Keeps a record of detected issues, including their category, summary, timestamps, and occurrence counts.

  • Duplicate Detection
    Groups matching diagnostic events instead of creating a separate history entry for every repeated occurrence.

  • World-Specific Persistence
    Saves diagnostic history separately for each world, including dedicated server worlds.

  • Diagnostic Commands
    Provides commands to inspect diagnostic summaries and history, as well as run controlled diagnostic tests.

Commands

All commands require permission level 2.

  • /compatwatch summary — Displays a summary of recorded diagnostic issues.

  • /compatwatch history — Displays diagnostic history.

  • /compatwatch history <page> — Displays a specific history page.

  • /compatwatch test — Creates a controlled manual test event.

  • /compatwatch logtest — Generates a controlled synthetic Mixin log event to test the log monitoring pipeline.

Important: Test commands generate artificial diagnostic events. They do not indicate a real mod conflict.

Compatibility

  • Minecraft: Java Edition 1.20.1

  • Mod Loader: Minecraft Forge

  • Java: 17

  • Tested Forge environment: 47.4.10

  • Tested in single-player and dedicated server environments.

Important Notes

CompatWatch is a diagnostic tool, not an automatic repair tool.

  • It does not automatically fix mod conflicts.

  • It does not modify or remove other mods.

  • It does not guarantee that every compatibility issue will be detected.

  • A detected log pattern is not necessarily proof of the actual root cause.

  • Diagnostic information should be treated as investigation clues, not definitive conclusions.

Installation

  1. Install Minecraft Java Edition 1.20.1.

  2. Install Minecraft Forge.

  3. Make sure Java 17 is available.

  4. Place the CompatWatch JAR file in your Minecraft mods folder.

  5. Launch the game or dedicated server.

Traditional Chinese (繁體中文)

模組介紹

CompatWatch 是一款 Minecraft Forge 診斷工具,專門協助玩家與伺服器管理員觀察日誌、記錄可能的模組相容性問題,並提供後續調查所需的資訊。

它會監控指定的 WARN 與 ERROR 日誌,分析可辨識的錯誤特徵,並將診斷結果保存至歷史紀錄。

主要功能

  • 自動監控部分警告與錯誤日誌。

  • 辨識 Mixin 套用失敗、缺少類別或方法、依賴問題、重複註冊及模組初始化失敗等特徵。

  • 保存診斷歷史、發生時間與出現次數。

  • 合併重複診斷事件,避免歷史紀錄過度膨脹。

  • 每個世界分別保存診斷歷史。

  • 支援單人世界及專用伺服器。

  • 提供診斷摘要、歷史查詢及受控測試指令。

注意事項

CompatWatch 不會自動修復模組衝突,也不會修改或刪除其他模組。

日誌中的診斷線索不一定代表真正的問題根源,請將結果視為調查參考,而非絕對結論。

支援環境

  • Minecraft Java Edition 1.20.1

  • Minecraft Forge

  • Java 17

Project description from CurseForge.

Pick your setup

CompatWatch by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

CompatWatch versions and loaders

1 of 1 releases match

Looking for an older file? The official CurseForge project page is in Resources.