# ModsChecker<\/p>\n
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.<\/p>\n
## Features
\n– Modrinth lookup by SHA1.
\n– CurseForge lookup by fingerprint (batch request).
\n– Metadata detection from `fabric.mod.json`, `META-INF\/mods.toml`, `mcmod.info`.
\n– Client-only classification + heuristics.
\n– Console summary and optional JSON report.
\n– English\/Russian output.<\/p>\n
## Requirements
\n– Runtime: Java 8 to 25.
\n– Build: JDK 17+ (Gradle 8.x requirement).<\/p>\n
## Build
\n“`bash
\n.\/gradlew build
\n“`
\nResulting fat-jar:
\n“`
\nbuild\/libs\/modschecker-1.0.0.jar
\n“`<\/p>\n
## Run
\n“`bash
\njava -jar modschecker-1.0.0.jar
\n“`<\/p>\n
## Example output
\n<\/p>\n
## Configuration file
\nOn first run, a `modschecker.properties` file is created next to the jar (or in the working directory).<\/p>\n
Example:
\n“`properties
\nmodsDir=.\/mods
\ncurseforgeApiKey=
\ngameId=432
\nverbose=false
\njsonOutput=
\nlanguage=ru
\npauseOnExit=true
\n“`<\/p>\n
## CLI options ## Classification rules If Modrinth data is not available, a heuristic is used based on keywords in mod names.<\/p>\n ## Notes Checks if mods are client-side, server-side, or required on both.<\/p>\n","protected":false},"featured_media":104655,"template":"","meta":{"_minecraft_slug":"mods-type-checker","_minecraft_project_id":"MzEzNWOr","_minecraft_author":"PystoyPlayer","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":836,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mods-type-checker.zip","_minecraft_size_bytes":2152625,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:58:47.209613Z","_minecraft_date_created":"2026-01-31T04:49:09.761349Z","_minecraft_date_modified":"2026-01-29T19:46:15.812725Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mods-type-checker","_minecraft_icon_attachment_id":104655,"_minecraft_imported_at":"2026-06-06T00:44:29+00:00","_minecraft_import_hash":"b2ef5d3f03015363b4a0f66c0aff9956","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,1007,1016,126,158,98,123,92],"mod_loader":[99,106,1009,1017,160,100],"minecraft_version":[850,851,339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,845,846,847,848,849,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,852,853,854,855,856,857,858,859,166,10,11,12,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-104654","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-java-agent","mod_category-liteloader","mod_category-management","mod_category-neoforge","mod_category-quilt","mod_category-technology","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-java-agent","mod_loader-liteloader","mod_loader-neoforge","mod_loader-quilt","minecraft_version-1-0","minecraft_version-1-1","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-2-1","minecraft_version-1-2-2","minecraft_version-1-2-3","minecraft_version-1-2-4","minecraft_version-1-2-5","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-3-1","minecraft_version-1-3-2","minecraft_version-1-4-2","minecraft_version-1-4-4","minecraft_version-1-4-5","minecraft_version-1-4-6","minecraft_version-1-4-7","minecraft_version-1-5-1","minecraft_version-1-5-2","minecraft_version-1-6-1","minecraft_version-1-6-2","minecraft_version-1-6-4","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n– `–modsDir
\n– `–curseforgeApiKey
\n– `–gameId
\n– `–jsonOutput
\n– `–verbose`: Print extra diagnostics.
\n– `–language
\n– `–pause`: Wait for Enter before exit (default on Windows).
\n– `–noPause`: Do not wait for Enter.<\/p>\n
\nA mod is considered client-only if:
\n– Modrinth `client_side=required` and `server_side=unsupported` (client required), or
\n– Modrinth `client_side=required` and `server_side=optional` (client preferred).<\/p>\n
\n– CurseForge is used for identification only (no explicit client\/server flags).
\n– No infinite retries or loops; HTTP timeouts are used.<\/p>\n","protected":false},"excerpt":{"rendered":"