Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
ClientWatch
ClientWatch is a modern Paper plugin for reliable Minecraft client inspection.
It helps server administrators collect and review the client information that a Minecraft server can actually observe, while clearly marking information that is not available or cannot be detected reliably.
What ClientWatch Detects
- Player name and UUID
- Join time
- Ping
- Online mode
- Server brand
- Client brand, when provided by the client
- Protocol version, when exposed by the server API
- Loader inference from reliable observable data
- Installed mods only when a trustworthy client-provided mod list is available
Honest Detection
ClientWatch does not fake detections.
Minecraft servers cannot reliably read every client, mod, or modification without client cooperation. If a mod list is not provided through a trustworthy server-visible channel, ClientWatch reports it as unavailable instead of guessing.
Blacklist System
Server owners can configure blacklists for:
- Mods
- Mod IDs
- Client brands
- Client names
- Mod loaders
When a blacklist match is detected, ClientWatch can run multiple actions at the same time.
Actions
Supported actions in the current development release:
- Kick
- Console message
- Staff message
- Ban command
More actions, including Discord webhooks and richer logging outputs, are planned.
Commands
/clientwatch/clientwatch reload/clientwatch version/clientwatch update/clientwatch inspect <player>/clientwatch info <player>/clientwatch mods <player>/clientwatch history <player>/clientwatch alerts/clientwatch blacklist/clientwatch whitelist
API
ClientWatch exposes Bukkit events for other plugins:
PlayerClientDetectEventPlayerModsLoadedEventPlayerBlacklistedModEventPlayerInspectionEvent
Requirements
- Paper 1.21+
- Java 21+
Development Status
ClientWatch is currently in early development. The foundation is implemented, and future releases are planned to add persistent database backends, an inventory GUI, Discord webhook embeds, daily log files, and more advanced detection modules.