ClientBrand

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

1. Download the plugin JAR file
2. Place it in your server's plugins folder
3. Install PlaceholderAPI if you want placeholder support
4. Restart your server
5. 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 Client
• forge - Forge Mod Loader
• fabric - Fabric Mod Loader
• Geyser - Bedrock players joining through GeyserMC
• lunarclient** - Lunar Client (** is used as LC adds the build number into their client brand. Eg: lunarclient:8cccced/version/1.21.6)
• badlion - Badlion Client
• Feather Fabric - Feather Client