/
What is ModWatch?
ModWatch is a synchronization system designed to give server owners full visibility into the client-side environment of their players. By pairing a Bukkit/Spigot/Paper plugin with a lightweight Fabric client mod, you can ensure that your server remains a fair playground for everyone.
[!NOTE]
For Players: You only need to install the Client Mod.
For Server Owners: You need to install the Server Plugin on your server.
Why choose ModWatch?
- Instant Insight: Admins can see a full list of a player's mods and active resource packs with a single command.
- Automated Blacklist: Instantly punish players using forbidden IDs like
xray,wurst, orfreecam. - Periodic Challenges: Our unique security layer sends hidden verification "challenges" every 30 seconds to ensure players can't bypass the check after joining.
- Global Search: Want to know who's using a specific mod? Use
/modwatch find <name>to scan everyone online. - Anti-Outdated: Enforce a minimum version of the mod to keep your security standards high.
Advanced Security
ModWatch doesn't just check once on join. It uses a Challenge-Response protocol:
- Join Handshake: 2 seconds after joining, the server requests data.
- Periodic Pings: Every 30 seconds, a new random challenge is generated.
- Verification: If a client fails to reply or sends an invalid response, they are immediately kicked.
- Resilience: Optimized networking handles connection spikes and cross-platform communication seamlessly.
Media
Kick message if you have a mod that is blacklisted
Commands & Permissions
| Command | Action | Permission |
|---|---|---|
/modwatch <player> | Inspect a player's mods/packs | modwatch.admin |
/modwatch find <key> | Search all players for a mod | modwatch.admin |
/modwatch reload | Reload the config & blacklist | modwatch.admin |
Installation
For Players
- Download the latest client JAR.
- Drop it into your
.minecraft/modsfolder. - Requires Fabric API & Minecraft 1.21.1.
For Server Admins
- Download the latest plugin JAR.
- Drop it into your server's
pluginsfolder. - Configure your blacklist in
plugins/ModWatch/config.yml.
Created with precision for the Minecraft community.
