ModsJava
⭐ClientDetectorExtra⭐- Configurable - Folia friendly ⚡
Java mod listed for Minecraft 1.17–26.x. Downloads from the MC Java Mods app on Android.
⬇ Download on Spigot
️ ClientDetectorExtra
ClientDetectorExtra is a high-performance client (brand) detection plugin designed for modern Minecraft servers. It allows you to precisely identify which client (Lunar, Forge, Fabric, etc.) your players are using, with full support for Bedrock players via Geyser.
---
ClientDetectorExtra is a high-performance client (brand) detection plugin designed for modern Minecraft servers. It allows you to precisely identify which client (Lunar, Forge, Fabric, etc.) your players are using, with full support for Bedrock players via Geyser.
---
Features
- ⚡ Extreme Performance: Built-in caching system (msgCache) to prevent repetitive file reading and ensure zero lag.
- Folia Compatibility: Uses foliascheduler for thread-safe execution on multi-threaded servers.
- Full HEX & MiniMessage: Complete support for Hexadecimal colors, gradients, and modern styling.
- Geyser/Bedrock Support: Automatically detects if a player is joining from Bedrock Edition.
- Flexible Notifications & Webhooks: In-game alerts, console messages, and customizable Discord Webhooks.
- ⛔ Blacklist & Automated Actions: Restrict forbidden clients/mods with custom actions (KICK, BAN, COMMAND, NOTIFY).
- Online Stats Dump: Export server statistics and player connection data directly to pastes.dev.
- ⚡ Admin Actions: Interactive GUI menu to inspect or teleport to suspicious players directly.
---
️ Technical Specifications
Java Version: Java 21
Minecraft API: Paper / Folia 1.17+
Supported Forks: Paper, Folia, Canvas, Purpur, Pufferfish
Shaded Dependencies: foliascheduler, fastboard, adventure-minimessage
---
Configuration (config.yml)
The plugin uses the MiniMessage format. You can use tags like <gradient:#55ffff:#5555ff> or HEX codes <#FFFFFF>.
Code (YAML):
check-for-update
: true
notify-console : true
notify-admin : true
permission : "clientdetector.admin"
messages :
#GUI
gui-main-title : "<#888888>▶ Clients (Page %page%)"
gui-sub-title : "<#888888>▶ %brand% (Page %page%)"
gui-next-page : "<#ffa500>« Previous Page"
gui-previous-page : "<#ffa500>Next Page »"
gui-back-button : "<#ff5555>Back to Main Menu"
gui-action-title : "<#888888>Actions: <#55ffff>%player%"
gui-action-teleport : "<#55ff55>➤ Teleport"
gui-client-lore :
- "<#aaaaaa>Click to view players."
- ""
- "<#ffffff>Players : <#55ffff>%count%"
gui-player-lore :
- "<#aaaaaa>UUID: <#ffffff>%uuid%"
- "<#aaaaaa>Bedrock: <#55ffff>%is_bedrock%"
prefix : "<#888888>[<gradient:#55ffff:#5555ff>ClientDetector</gradient><#888888>] <#ffffff>"
reload : "<#55ff55>Configuration has been reloaded!"
no-permission : "<#ff5555>You do not have permission to do this."
player-info : "<#aaaaaa>Player: <#55ffff>%player% <#888888>| <#aaaaaa>Client: <#55ffff>%brand% <#888888>| <#aaaaaa>Bedrock: <#55ffff>%is_bedrock%"
player-check : "<#aaaaaa>Info for <#55ffff>%target% <#888888>: <#aaaaaa>Client: <#55ffff>%brand% <#888888>| <#aaaaaa>Bedrock: <#55ffff>%is_bedrock%"
player-not-found : "<#ff5555>That player is not online."
webhooks:
enabled : true
url : "https://discord.com/api/webhooks/..."
all-clients : false # If true, alerts for all connected clients
alert-bedrock : true
alert-brands :
- "forge"
- "fabric"
message : " **%player%** joined using **%brand%** (Bedrock: %is_bedrock%)"
blacklist:
enabled : true
restricted-brands :
- "meteor"
- "wurst"
- "cheat"
actions :
- "NOTIFY"
- "KICK:<red>Modified clients are not allowed on this server!"
notify-console : true
notify-admin : true
permission : "clientdetector.admin"
messages :
#GUI
gui-main-title : "<#888888>▶ Clients (Page %page%)"
gui-sub-title : "<#888888>▶ %brand% (Page %page%)"
gui-next-page : "<#ffa500>« Previous Page"
gui-previous-page : "<#ffa500>Next Page »"
gui-back-button : "<#ff5555>Back to Main Menu"
gui-action-title : "<#888888>Actions: <#55ffff>%player%"
gui-action-teleport : "<#55ff55>➤ Teleport"
gui-client-lore :
- "<#aaaaaa>Click to view players."
- ""
- "<#ffffff>Players : <#55ffff>%count%"
gui-player-lore :
- "<#aaaaaa>UUID: <#ffffff>%uuid%"
- "<#aaaaaa>Bedrock: <#55ffff>%is_bedrock%"
prefix : "<#888888>[<gradient:#55ffff:#5555ff>ClientDetector</gradient><#888888>] <#ffffff>"
reload : "<#55ff55>Configuration has been reloaded!"
no-permission : "<#ff5555>You do not have permission to do this."
player-info : "<#aaaaaa>Player: <#55ffff>%player% <#888888>| <#aaaaaa>Client: <#55ffff>%brand% <#888888>| <#aaaaaa>Bedrock: <#55ffff>%is_bedrock%"
player-check : "<#aaaaaa>Info for <#55ffff>%target% <#888888>: <#aaaaaa>Client: <#55ffff>%brand% <#888888>| <#aaaaaa>Bedrock: <#55ffff>%is_bedrock%"
player-not-found : "<#ff5555>That player is not online."
webhooks:
enabled : true
url : "https://discord.com/api/webhooks/..."
all-clients : false # If true, alerts for all connected clients
alert-bedrock : true
alert-brands :
- "forge"
- "fabric"
message : " **%player%** joined using **%brand%** (Bedrock: %is_bedrock%)"
blacklist:
enabled : true
restricted-brands :
- "meteor"
- "wurst"
- "cheat"
actions :
- "NOTIFY"
- "KICK:<red>Modified clients are not allowed on this server!"
API & Developer Events
1. Custom Event (PlayerClientDetectEvent)
Triggered as soon as a player's client brand is resolved by the server:
Code (Java):
import
org.bukkit.event.EventHandler
;
import org.bukkit.event.Listener ;
import santexfr.events.PlayerClientDetectEvent ;
public class MyListener implements Listener {
@EventHandler
public void onClientDetect (PlayerClientDetectEvent event ) {
String player = event. getPlayer ( ). getName ( ) ;
String brand = event. getClientBrand ( ) ;
boolean bedrock = event. isBedrock ( ) ;
System. out. println (player + " connected with " + brand + " (Bedrock: " + bedrock + ")" ) ;
}
}
import org.bukkit.event.Listener ;
import santexfr.events.PlayerClientDetectEvent ;
public class MyListener implements Listener {
@EventHandler
public void onClientDetect (PlayerClientDetectEvent event ) {
String player = event. getPlayer ( ). getName ( ) ;
String brand = event. getClientBrand ( ) ;
boolean bedrock = event. isBedrock ( ) ;
System. out. println (player + " connected with " + brand + " (Bedrock: " + bedrock + ")" ) ;
}
}
Code (Java):
import
santexfr.api.ClientDetectorAPI
;
import santexfr.ClientDetectorExtra ;
import org.bukkit.entity.Player ;
import java.util.List ;
import java.util.Map ;
// Get the API instance
ClientDetectorAPI api = ClientDetectorExtra. getApi ( ) ;
// Check if a player is on Bedrock
boolean isBedrock = api. isBedrock (player ) ;
// Get the client brand name
String brand = api. getClientBrand (player ) ;
// Retrieve the list of players using a specific client
List <Player > lunarPlayers = api. getPlayersByClientBrand ( "lunarclient:v1_20" ) ;
// Get global connection statistics
Map < String, Integer > stats = api. getGlobalStats ( ) ;
stats. forEach ( (brandName, count ) -> { System. out. println ( "Client: " + brandName + " | Online: " + count ) ; } ) ;
// Clean a complex brand name
String cleanName = api. getBaseBrand ( "lunarclient:v1_20_4" ) ; // Returns "LunarClient"
import santexfr.ClientDetectorExtra ;
import org.bukkit.entity.Player ;
import java.util.List ;
import java.util.Map ;
// Get the API instance
ClientDetectorAPI api = ClientDetectorExtra. getApi ( ) ;
// Check if a player is on Bedrock
boolean isBedrock = api. isBedrock (player ) ;
// Get the client brand name
String brand = api. getClientBrand (player ) ;
// Retrieve the list of players using a specific client
List <Player > lunarPlayers = api. getPlayersByClientBrand ( "lunarclient:v1_20" ) ;
// Get global connection statistics
Map < String, Integer > stats = api. getGlobalStats ( ) ;
stats. forEach ( (brandName, count ) -> { System. out. println ( "Client: " + brandName + " | Online: " + count ) ; } ) ;
// Clean a complex brand name
String cleanName = api. getBaseBrand ( "lunarclient:v1_20_4" ) ; // Returns "LunarClient"
Commands & Permissions
- /clientdetector reload : Reloads the configuration. (clientdetector.admin)
- /clientdetector info <player> : Displays details for a specific player. (clientdetector.admin)
- /clientdetector gui : Opens an interactive menu listing active clients and users. (clientdetector.admin)
- /clientdetector stats : Shows global client distribution percentages. (clientdetector.admin)
- /clientdetector dump : Generates an online pastes.dev report of server stats. (clientdetector.admin)
- Alias: /cdetect
Special Permissions:
- clientdetector.admin : Default admin permission for all commands.
- clientdetector.bypass.blacklist : Allows staff/devs to bypass blacklist actions.
---
️ Compilation
Code (Bash):
mvn clean package
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.17, 1.18, 1.19
- 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 Spigot — 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.
⭐ClientDetectorExtra⭐- Configurable - Folia friendly ⚡ is a free Minecraft Java mod. Compatible with Minecraft 1.17, 1.18, 1.19, 1.20 and newer. Downloaded 75 times (via Spigot). Download it and open it directly in the game.