Detect the client every player is using on your server with whitelist, blacklist, and PlaceholderAPI Support
Features
- Client Brand Detection: Automatically detects the client brand of joining players
- PlaceholderAPI Integration: Provides
%clientbrand_brand%placeholder - Commands: Get individual player brands and list all online players with their brands
- Join Alerts: Configurable alerts of a players client brand when they join
- Blacklist/Whitelist System: Kick players using specific clients or only allow certain clients
- Wildcard Support: Use
**to match any characters after a prefix (e.g.,lunarclient**) - Bypass Permissions: Allow specific players to bypass the blacklist
- Fully Configurable: All messages and settings are customizable
Commands & Permissions
| Command | Permission | Description |
|---|---|---|
/clientbrand get <player> |
clientbrand.get |
Get the client brand of a specific player |
/clientbrand list [page] |
clientbrand.list |
List all online players and their client brands (10 per page) |
clientbrand.alert |
Receive join alerts about player client brands | |
clientbrand.bypassblacklist |
Bypass the client blacklist/whitelist | |
clientbrand.* |
Access to all permissions | |
/clientbrand reload |
clientbrand.reload |
Reload the config files |
Placeholders
%clientbrand_brand%- Returns the player's raw client brand%clientbrand_brand_replace%- Returns the player's client brand, but with the raw value replaced with the value specified in the config, if present.
Installation
- Download the plugin JAR file
- Place it in your server's
pluginsfolder - Install PlaceholderAPI if you want placeholder support
- Restart your server
- Configure the plugin in
plugins/ClientBrand/config.yml
Client Brand Disclaimer
This plugin cannot tell you which client the player is using, it can only say which client the client says it's using. Hacked client developers are aware of this, and usually, they leave the client brand as Vanilla or Forge or something 'legitimate'. Therefore, a client brand of Vanilla or Fabric does not mean the player is 100% using a Vanilla or Fabric client, and a client brand along the lines of Lunar Client may not always be an actual Lunar Client.
Common client brands:
Use this list to configure your config.yml if you wish. This exact text is also what will be returned in the placeholder.
vanilla- Standard Minecraft Clientforge- Forge Mod Loaderfabric- Fabric Mod LoaderGeyser- Bedrock players joining through GeyserMClunarclient**- Lunar Client (** is used as LC adds the build number into their client brand. Eg: lunarclient:8cccced/version/1.21.6)badlion- Badlion ClientFeather Fabric- Feather Client
