HOW IT WORKS
When a player joins a server, his client sends a packet (PlayInCustomPayload) to the server, also known as PluginMessaging. This plugin is "catching" this information (using the PacketEvents API, https://github.com/retrooper/packetevents) when it's sent to the server, and checks its content for client-specific "messages".
Most clients are detectable with this method, but some clients act like they are "vanilla" (standard Minecraft) clients. Some other (hack-)clients spoof this method by sending "false" packet(s) to the server, this cannot be stopped and will always be possible.
MAIN FEATURES
- Client Detection - Detect the client of players and automatically kick unwanted clients.
- Mod Detection - Detect the mods players use and automatically kick unwanted mods.Client Control - Manage the client/mods of players (only compatible clients/mods).
- Forge Mod Detection - Detect Forge mods (for now only 1.8 - 1.12.2 Forge).
- Cross Server Notifications - Your staff will be informed if a player joins another server with a detected client/mod.
- Advanced Alert System - You can configure the way ClientDetector notifies your staff.
- BungeeCord Compatible - You can use ClientDetector on BungeeCord server(s).
- ViaVersion Compatible - You can use ClientDetector together with ViaVersion.
COMMANDS
- /clientdetector - Main command, sends a message containing name, version and author.
- /clientdetector help - Sends information about the command system.
- /clientdetector player client <player> - Returns a message containing the client which the player is using.
- /clientdetector player mods <player> - Returns a message/list containing the mods which the player is using.
- /clientdetector player version <player> - Returns a message containing the Minecraft version (1.8, ..., 1.17.1).
- /clientdetector player labyaddons <player> - Returns a message/list containing the LabyMod Addons the player is using.
- /clientdetector forge <player> - Returns a message/list containing the Forge mods the player is using.
PERMISSIONS
- 'clientdetector.notify' - Permission to get informed when a player's client/mod is detected (can be changed trough config.yml).
- 'clientdetector.command' - Permission to use the commands.
HOW TO INSTALL
1) Single Spigot/Bukkit Server
2. Restart the server
3. Configure the plugin
2) BungeeCord Network
2. Copy the plugin into the plugin folder of all sub servers
3. Be sure that "crossServerNotifications" is set to 'true' in config.yml
4. Restart BungeeCord and all servers ClientDetector was installed on
5. Configure the plugin
COMPATIBILITY
ClientDetector works on all versions, starting from 1.8. It also works with most forks, such as Spigot, PaperSpigot, and Tuinity.
It also works with proxies like BungeeCord. When using ClientDetector on a proxy network, you have to install it on Spigot/Bukkit and BungeeCord side.
PLACEHOLDERS
- „%clientdetector_client_name%“ - Returns the name of the client that the player is using.
- „%clientdetector_client_version%“ - Returns the version of the client that the player is using.
- „%clientdetector_forge_user%“ - Returns ‘true’ or ‘false’ depending on if the player is using Forge.
- „%clientdetector_bedrock_player%“ - Returns ’true’ or ‘false’ depending on if the player joined through GeyserMC, Floodgate.
CLIENT/MOD DETECTION
A list of detected clients / mods, most of them are tested. In total 22 clients / mods are detected by the plugin.
Clients:
- Forge
- 5Zig Mod
- LabyMod
- Lunar Client
- Polar Client
- MysteryMod
- Pixel Client
- LiteLoader
- PvPLounge Client
- Fabric
- Rift
- Cracked Vape
- Vivecraft
- Hyperium
- PXMod
- Winterware
- Minecraft-Console-Client
- Aristois (Experimental - only older versions 1.8, 1.12.2, not 1.16.5 or newer)
Mods:
- Better Sprinting Mod
- World Downloader
- JourneyMap
- WorldEditCUI
CLIENTCONTROL
More information will be added soon.
FORGE
More information will be added soon.