---

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, or freecam.
• 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:

1. Join Handshake: 2 seconds after joining, the server requests data.
2. Periodic Pings: Every 30 seconds, a new random challenge is generated.
3. Verification: If a client fails to reply or sends an invalid response, they are immediately kicked.
4. Resilience: Optimized networking handles connection spikes and cross-platform communication seamlessly.

---

Media

---

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

1. Download the latest client JAR.
2. Drop it into your .minecraft/mods folder.
3. Requires Fabric API & Minecraft 1.21.1.

For Server Admins

1. Download the latest plugin JAR.
2. Drop it into your server's plugins folder.
3. Configure your blacklist in plugins/ModWatch/config.yml.

---