ModGuard-logo

Is a security and anti-cheat mod for Minecraft servers, featuring a strict mod whitelist system and real-time X-Ray detection to ensure fair gameplay. Guard your server from unauthorized client modifications and track suspicious mining activity effortlessly.

Features

Mod Whitelist System

Client Validation - Actively validates client mods against a secure whitelist.
Strict Enforcement - Automatically kicks players with unauthorized or missing mods and actively blocks mod-bypass attempts.

X-Ray Detection System

Real-Time Tracking - Tracks ore-mining patterns in real-time across 9 supported ore types.
Admin Alerts & Tools - Features persistent violation tracking and immediate admin alerts, complete with quick teleport and spectate options.

Configuration & Installation

Easy Setup - Place modguard-1.0.0.jar in your mods/ folder. Config files auto-generate in config/ (modguard_config.json and modguard_violations.json).
Custom Whitelist - Add your server's allowed mod names directly to "allowedMods" in the config file.
Ore Detection Limits - Configure each ore with specific threshold, timeWindowSeconds, and enabled toggles. (Default examples: Diamond triggers at 10 in 300s; Ancient Debris triggers at 5 in 300s. Others are disabled by default).

Commands (OP Level 2)

General Administration - Use /modguard listmods to list loaded mods or /modguard spectate <player> to stealthily observe suspects.
X-Ray Management - Control detection via /modguard xraylist (show all settings), /modguard xrayvalues <ore> <threshold> <seconds> (adjust limits), and /modguard xray <ore> enable|disable (toggle tracking).
Violation Logs - View records with /modguard xraylog or wipe the slate clean using /modguard xraylog clear all.

Dependencies:

Fabric API

Server-Side & Client-Side - Required on both the server and the client. All players must install the same mod in their mods/ folder to connect; missing the mod results in an automatic kick from the server.