Описание
# 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.
Гайд на русском: [тут](https://superhub.host/guides/scan-client-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
```bash
./gradlew build
```
Resulting fat-jar:
```
build/libs/modschecker-1.0.0.jar
```
## Run
```bash
java -jar modschecker-1.0.0.jar
```
## Example output
## Configuration file
On first run, a `modschecker.properties` file is created next to the jar (or in the working directory).
Example:
```properties
modsDir=./mods
curseforgeApiKey=
gameId=432
verbose=false
jsonOutput=
language=ru
pauseOnExit=true
```
## CLI options
- `--modsDir `: Mods folder (default `./mods` next to the jar or cwd).
- `--curseforgeApiKey `: API key (or env `CURSEFORGE_API_KEY`).
- `--gameId `: Default `432` (Minecraft).
- `--jsonOutput `: Save JSON report.
- `--verbose`: Print extra diagnostics.
- `--language `: `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.