
CheckYourMods
Security tool for NeoForge 1.21.1. Smart Xray resource pack detection via metadata. Client mod verification against server whitelist.
Screenshots


About this Mod
CheckYourMods 🛡️
CheckYourMods is an advanced security and transparency tool for Minecraft 1.21.1 (NeoForge) designed for server administrators. Specifically designed for friends' servers to ensure that no one is downloading suspicious mods that aren't necessary to play or cheating. It ensures a fair play environment by monitoring client-side modifications and resource packs.
✨ Key Features
- Smart Mod Verification: Automatically compares player mods against the server's mod list and ignores matches.
- Intelligent Resource Pack Scan: Detects suspicious keywords like "xray", "vision", or "transparent" within the pack's internal metadata (
pack.mcmeta). - SHA-256 Fingerprinting: Allows manual tracking of specific resource packs using their unique digital hash.
- Transparency for Players: Includes public commands so players can verify what is being monitored, ensuring the staff is not hiding anything.
- Persistent Logging: All connection data, detected mods, and suspicious packs are recorded in
logs/checkyourmods-log.txt.
🛠️ Configuration
The mod generates a configuration file in serverconfig/checkyourmods-server.toml with intuitive instructions:
allowed_mod_ids: Add IDs for client-side utility mods (e.g.,optifine,sodium,voicechat) so they are not announced as extra mods.manual_xray_hashes: Add specific SHA-256 hashes for malicious packs that might bypass the keyword scanner.
💻 Commands
/modcheck list: Shows the list of allowed mod IDs to all players./modcheck packs: Shows the list of manually watched resource pack hashes.
📄 License
Distributed under the MIT License. This allows for high transparency and community collaboration. See the LICENSE file for more information.
Created for the Minecraft Server Administration community.
Available Versions
How to Install CheckYourMods on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "CheckYourMods". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
CheckYourMods server crashes on startup – what to do?
Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is CheckYourMods compatible with neoforge?
CheckYourMods officially supports neoforge for Minecraft 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with CheckYourMods – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if CheckYourMods consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install CheckYourMods with just one click on your server.