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
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as ClientBrand-1.1.0.jar — drop this file into the mods folder
- Download size: 13 KB
- Download link checked 20 Sept 2026 — working
These come from our own check of the pack file, not from the source page.