Home›Java›Mods›⭐ClientDetectorExtra⭐- Configurable - Folia friendly ⚡
⭐ClientDetectorExtra⭐- Configurable - Folia friendly ⚡
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.

---​

Features

---

️ 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!"
---

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 + ")" ) ;
    }
}
2. API Usage
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"
---

Commands & Permissions

Special Permissions:

---

️ Compilation
Code (Bash):
mvn clean package
Statistics [​IMG] ​

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

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.

Explore more