Fragments Anticheat

A server-side anti-cheat system for Fabric that ensures all players are using only allowed mods with correct versions.

✨ Features

• 🔒 Mod verification: Automatically checks all client mods against a server whitelist
• ⚡ Hash-based validation: Uses SHA-256 hashes to guarantee mod integrity
• 📦 Resource Pack Support: Also checks active resource packs
• 👮 OP Bypass: Server operators can use all mods
• 🚀 Performance-optimized: Hashes are cached at startup - no delays when connecting
• 🛡️ Robust: Automatic timeouts and comprehensive error handling

🎮 For players

When you join the server, your installed mods are automatically checked. If you are using unauthorized or modified mods, you will be kicked with a list of problematic mods.

⚙️ For server admins

Installation

1. Download the mod and place it in the mods/ folder
2. Start the server - an allowed-mods/ folder will be created
3. Place allowed .jar files in the allowed-mods/ folder
4. Restart the server - done!

Configuration

• allowed-mods/: Place all allowed mod JARs here
• resource-pack-whitelist.txt: Optional - list allowed resource pack names
• OP players: Are automatically excluded from the check

📋 Technical details

• Platform: Fabric 1.21.4
• Side: Server & client (required on both sides)
• Hash algorithm: SHA-256
• Timeout: 11 seconds for mod list

⚠️ Important

• Both sides (server & client) require this mod
• Players without the mod will be kicked after 11 seconds
• OP players are excluded from the check