CraftHub
Mods Type Checker

Mods Type Checker

Checks if mods are client-side, server-side, or required on both.

3 337 downloads 10 followers

ModsChecker

CLI tool to audit Minecraft mods and flag client-only mods. It scans a mods folder, calculates hashes, and queries Modrinth and CurseForge to classify mods.

Гайд на русском: тут

Features

  • Modrinth lookup by SHA1.
  • CurseForge lookup by fingerprint (batch request).
  • Metadata detection from fabric.mod.json, META-INF/mods.toml, mcmod.info.
  • Client-only classification + heuristics.
  • Console summary and optional JSON report.
  • English/Russian output.

Requirements

  • Runtime: Java 8 to 25.
  • Build: JDK 17+ (Gradle 8.x requirement).

Build

./gradlew build

Resulting fat-jar:

build/libs/modschecker-1.0.0.jar

Run

java -jar modschecker-1.0.0.jar

Example output

Example output

Configuration file

On first run, a modschecker.properties file is created next to the jar (or in the working directory).

Example:

modsDir=./mods
curseforgeApiKey=
gameId=432
verbose=false
jsonOutput=
language=ru
pauseOnExit=true

CLI options

  • --modsDir <path>: Mods folder (default ./mods next to the jar or cwd).
  • --curseforgeApiKey <key>: API key (or env CURSEFORGE_API_KEY).
  • --gameId <int>: Default 432 (Minecraft).
  • --jsonOutput <path>: Save JSON report.
  • --verbose: Print extra diagnostics.
  • --language <lang>: ru or en.
  • --pause: Wait for Enter before exit (default on Windows).
  • --noPause: Do not wait for Enter.

Classification rules

A mod is considered client-only if:

  • Modrinth client_side=required and server_side=unsupported (client required), or
  • Modrinth client_side=required and server_side=optional (client preferred).

If Modrinth data is not available, a heuristic is used based on keywords in mod names.

Notes

  • CurseForge is used for identification only (no explicit client/server flags).
  • No infinite retries or loops; HTTP timeouts are used.
Version Minecraft Loader Download

Mods Type Checker 1.0.0

1.0.0

1.0, 1.1, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.2.1, 1.2.2, 1.2.3, 1.2.4, 1.2.5, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.3.1, 1.3.2, 1.4.2, 1.4.4, 1.4.5, 1.4.6, 1.4.7, 1.5.1, 1.5.2, 1.6.1, 1.6.2, 1.6.4, 1.7.10, 1.7.2, 1.7.3, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9, 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4
fabric, forge, java-agent, liteloader, neoforge, quilt
Download