Allow anonymous analytics?

Our cookieless analytics show us which features get used and store nothing on your device. We never sell your data or use it for advertising.

Privacy choices

Choose what ModDex may collect. You can change this anytime from Privacy choices in the footer.

Read the full privacy policy

Strictly necessary Required for the site to work: login sessions, security tokens, and abuse prevention. Always on and cannot be disabled. Always on
Analytics Cookieless analytics through PostHog's EU servers, used only to see which features get used. Nothing is stored on your device, and the anonymous visitor ID resets every day. Needs your consent because usage data goes to a third party. Never used for advertising or profiling. Off by default in the EU and UK.

Mods Type Checker

Quick rating

Community listing page, reviews may not be monitored by the author.

Report a bug to the author How listings work Are you the author?

Mods Type Checker

By PystoyPlayerOwner

No reviews yet

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

Mod Loaders
Minecraft
Shockbyte server hosting: 35% off your first server with code MODDEX35 (opens in a new tab)

About

Description

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.