ModGuard

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.