<div align="center"> <h1><img src="https://api.iconify.design/lucide:shield.svg?color=%2300AF5C&width=128&height=128" width="48" height="48" align="middle"> ModWatch</h1> <h3>The ultimate bridge between Server Administration and Player Integrity.</h3> <img src="https://cdn.modrinth.com/data/r0BY5bMH/images/1d844abe7cabd1620768285ca4beccdc0a341b54.png" width="250" alt="ModWatch Logo"> <p> <a href="https://modrinth.com/mod/modwatch"><img src="https://img.shields.io/modrinth/dt/modwatch?style=for-the-badge&color=00AF5C&label=Downloads" alt="Downloads"></a> <img src="https://img.shields.io/badge/Minecraft-1.21.1-blue?style=for-the-badge" alt="Minecraft Version"> <img src="https://img.shields.io/badge/Loader-Fabric-lightgrey?style=for-the-badge" alt="Fabric"> </p> </div> --- ## <img src="https://api.iconify.design/lucide:book-open.svg?color=%233B82F6&width=128&height=128" width="32" height="32" align="middle"> 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. > > **For Players:** You only need to install the **Client Mod**. > **For Server Owners:** You need to install the **Server Plugin** on your server. --- ## <img src="https://api.iconify.design/lucide:rocket.svg?color=%23F59E0B&width=128&height=128" width="32" height="32" align="middle"> Why choose ModWatch? - <img src="https://api.iconify.design/lucide:bar-chart-3.svg?color=%2306B6D4&width=128&height=128" width="24" height="24" align="middle"> **Instant Insight**: Admins can see a full list of a player's mods and active resource packs with a single command. - <img src="https://api.iconify.design/lucide:ban.svg?color=%23EF4444&width=128&height=128" width="24" height="24" align="middle"> **Automated Blacklist**: Instantly punish players using forbidden IDs like `xray`, `wurst`, or `freecam`. - <img src="https://api.iconify.design/lucide:shield-check.svg?color=%238B5CF6&width=128&height=128" width="24" height="24" align="middle"> **Periodic Challenges**: Our unique security layer sends hidden verification "challenges" every 30 seconds to ensure players can't bypass the check after joining. - <img src="https://api.iconify.design/lucide:search.svg?color=%23EAB308&width=128&height=128" width="24" height="24" align="middle"> **Global Search**: Want to know who's using a specific mod? Use `/modwatch find <name>` to scan everyone online. - <img src="https://api.iconify.design/lucide:refresh-cw.svg?color=%2322C55E&width=128&height=128" width="24" height="24" align="middle"> **Anti-Outdated**: Enforce a minimum version of the mod to keep your security standards high. --- ## <img src="https://api.iconify.design/lucide:lock.svg?color=%2364748B&width=128&height=128" width="32" height="32" align="middle"> 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. --- ## <img src="https://api.iconify.design/lucide:camera.svg?color=%23EC4899&width=128&height=128" width="32" height="32" align="middle"> Media <div align="center"> <p><b>Kick message if you have a mod that is blacklisted</b></p> <img src="https://cdn.modrinth.com/data/r0BY5bMH/images/a028860cf6713697b58e0a41c667bddc22febf37.png" alt="Kick message if you have a mod that is blacklisted" width="800"> <p><b></b></p> <img src="" alt="" width="800"> </div> --- ## <img src="https://api.iconify.design/lucide:terminal.svg?color=%23475569&width=128&height=128" width="32" height="32" align="middle"> 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` | --- ## <img src="https://api.iconify.design/lucide:folder-down.svg?color=%236366F1&width=128&height=128" width="32" height="32" align="middle"> Installation ### <img src="https://api.iconify.design/lucide:user.svg?color=%230EA5E9&width=128&height=128" width="24" height="24" align="middle"> For Players 1. Download the **latest client JAR**. 2. Drop it into your `.minecraft/mods` folder. 3. Requires **Fabric API** & **Minecraft 1.21.1**. ### <img src="https://api.iconify.design/lucide:server.svg?color=%2364748B&width=128&height=128" width="24" height="24" align="middle"> For Server Admins 1. Down

ModWatch

The ultimate bridge between Server Administration and Player Integrity.

## 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 ` 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

Kick message if you have a mod that is blacklisted

## Commands & Permissions

| Command | Action | Permission | | :--- | :--- | :--- | | `/modwatch ` | Inspect a player's mods/packs | `modwatch.admin` | | `/modwatch find ` | 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. Down