promotional bannermobile promotional banner

CheckYourMods

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

File Details

checkyourmods-1.0.0.jar

  • R
  • Jan 10, 2026
  • 878.81 KB
  • 372
  • 1.21.1
  • NeoForge

File Name

checkyourmods-1.0.0.jar

Supported Versions

  • 1.21.1

Curse Maven Snippet

NeoForge

implementation "curse.maven:checkyourmods-1425510:7442552"
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

🛡️ CheckYourMods - v1.0.0 (Initial Release)

Welcome to the first stable release of CheckYourMods for Minecraft 1.21.1 (NeoForge)! This tool is essential for server administrators looking to maintain game integrity and transparency.


🚀 Key Features

🔍 Smart Anticheat Logic

  • Metadata-Based Xray Detection: The mod automatically inspects player Resource Packs. If the pack.mcmeta file contains suspicious keywords (e.g., xray, transparent, vision), administrators are immediately alerted.
  • Modlist Verification: Compares client-side mods with server-side mods. Any extra mod not found on the server or the whitelist will be reported.
  • SHA-256 Fingerprinting: Generates and tracks unique hashes for every Resource Pack, allowing identification of cheat packs even if the player renames the file.

⚙️ Advanced Configuration

The mod generates a config file at serverconfig/checkyourmods-server.toml with the following options:

  • ALLOWED_MOD_IDS: A whitelist for utility mods (Optifine, Iris, Sodium, etc.) to prevent false positives.
  • MANUAL_XRAY_HASHES: A manual database to flag or block specific pack hashes.

💻 Admin Commands

Command Description Permissions
/modcheck list Displays the current allowed mods on the server. Everyone
/modcheck packs Lists the resource pack hashes currently being watched. Everyone

🛠️ Technical Changes

  • Persistent Logging: Implemented a detailed logging system found in logs/checkyourmods-log.txt.
  • Visual Identity: Added the official logo to the Minecraft/NeoForge mod menu.
  • Network Optimization: Information packets are sent asynchronously to prevent connection lag or TPS drops when players join.

📦 Installation

  1. Download the .jar file from the Releases section.
  2. Place it in the mods folder of both your Client and Server.
  3. Restart your game and enjoy a more secure environment!

Developed by Alber11 for the NeoForge community.