Client Detector Module

The Client Detector Module detects what client type players are using when they join the server (Vanilla, Fabric, Forge, etc.).

🚀 Features

Core Functionality

Client Detection - Detects client type on join
Brand Identification - Identifies client brands (Vanilla, Fabric, Forge, etc.)
Version Detection - Shows Minecraft version
Staff Notifications - Alerts staff to client information

Advanced Features

Hover Information - Detailed player info on hover
IP Tracking - Tracks IP addresses
Ping Display - Shows player ping
Location Tracking - Shows player coordinates
Health Display - Shows player health and food

📋 Commands

No commands - automatic detection on join.

Notifications are automatic when players join the server.

⚙️ Configuration

Module Settings

enabled: true

notifications:
  enabled: true
  message_format: "{prefix}&#FFFFFF{player} &#7F7F7Fjoined using &#FFFF00{client}"

  hover:
    enabled: true
    text:
      - "&#FFAA00Player Information"
      - "&#FFFFFFName: &#FFFF00{player} &#FFFFFF| &#FFFF00{uuid}"
      - "&#FFFFFFIP: &#FFFF00{ip} &#FFFFFF| Ping: &#FFFF00{ping}ms"
      - "&#FFFFFFClient: &#FFFF00{client} &#FFFFFF| Version: &#FFFF00{version}"
      - "&#FFFFFFWorld: &#FFFF00{world} &#FFFFFF| Mode: &#FFFF00{gamemode}"
      - "&#FFFFFFHealth: &#FFFF00{health}/20 &#FFFFFF| Food: &#FFFF00{food}/20"
      - "&#FFFFFFLocation: &#FFFF00{x}, {y}, {z}"

notifications:
  enabled: true
  message_format: "{prefix}&#FFFFFF{player} &#7F7F7Fjoined using &#FFFF00{client}"

  hover:
    enabled: false

Result:

Simple one-line notification
Client type visible
No hover information

notifications:
  enabled: true
  message_format: "{prefix}&#FFFFFF{player} &#7F7F7Fjoined using &#FFFF00{client}"

  hover:
    enabled: true
    text:
      - "&#FFFFFFClient: &#FFFF00{client}"
      - "&#FFFFFFVersion: &#FFFF00{version}"
      - "&#FFFFFFIP: &#FFFF00{ip}"
      - "&#FFFFFFPing: &#FFFF00{ping}ms"

Result:

Notification with client type
Hover shows detailed info
Staff can inspect players

🔐 Permissions

Required Permissions

Permission	Description
`zenith.join.client.notify`	Receive client detection notifications
`zenith.join.client.bypass`	Bypass client detection (won’t trigger notification)

Permission Examples

Staff Access
Player Access

permissions:
  - zenith.join.client.notify: true

What they receive:

✅ Client detection notifications
✅ Hover information (if enabled)
✅ Player join alerts

permissions:
  - zenith.join.client.bypass: true

What happens:

✅ No detection notification
✅ Privacy protection
✅ Silent join

📊 Available Variables

Notification Variables

Variable	Description	Example
`{player}`	Player name	`Player123`
`{client}`	Client brand	`Vanilla`, `Fabric`, `Forge`
`{version}`	Minecraft version	`1.21.4`
`{uuid}`	Player UUID	`12345...`
`{ip}`	Player IP address	`192.168.1.1`
`{ping}`	Player ping in ms	`50`
`{world}`	Current world name	`world`
`{gamemode}`	Player gamemode	`SURVIVAL`
`{health}`	Player health (0-20)	`20`
`{food}`	Player food level (0-20)	`20`
`{x}`	Player X coordinate	`100`
`{y}`	Player Y coordinate	`64`
`{z}`	Player Z coordinate	`200`

Hover Information

Hover text can include all available variables:

hover:
  enabled: true
  text:
    - "&#FFAA00Player Information"
    - "&#FFFFFFName: &#FFFF00{player}"
    - "&#FFFFFFUUID: &#FFFF00{uuid}"
    - "&#FFFFFFIP: &#FFFF00{ip} &#FFFFFF| Ping: &#FFFF00{ping}ms"
    - "&#FFFFFFClient: &#FFFF00{client} &#FFFFFF| Version: &#FFFF00{version}"
    - "&#FFFFFFWorld: &#FFFF00{world} &#FFFFFF| Mode: &#FFFF00{gamemode}"
    - "&#FFFFFFHealth: &#FFFF00{health}/20 &#FFFFFF| Food: &#FFFF00{food}/20"
    - "&#FFFFFFLocation: &#FFFF00{x}, {y}, {z}"

🎯 Detected Client Types

The module can detect various client brands:

Common Clients

Client	Display Name	Notes
Vanilla	`Vanilla`	Standard Minecraft client
Fabric	`Fabric`	Fabric modded client
Forge	`Forge`	Forge modded client
Quilt	`Quilt`	Quilt modded client
Bukkit API	`Bukkit API`	Spigot/Bukkit server detection
Custom	`Custom`	Custom branded clients

Accuracy Notes

The client detection works best with:

Vanilla clients (always accurate)
Most modded clients (if they send brand info)
Standard Minecraft protocol clients

🔔 Staff Notifications

Join Notifications

When a player joins, staff receive a notification with client information.

Example:

[Zenith] Player123 joined using Fabric

Hover Information:

Player name and UUID
IP address and ping
Client type and version
Location and health

Disable Notifications

To disable client detection notifications:

notifications:
  enabled: false

Or disable hover only:

notifications:
  hover:
    enabled: false

🛠️ Troubleshooting

Common Issues

Issue: No detection notifications

Check if module is enabled
Verify zenith.join.client.notify permission
Check notification configuration

Issue: Wrong client detected

Client may be spoofing brand
Check for custom client modifications
Verify client is sending brand information

Issue: No hover information

Check if hover is enabled
Verify hover text configuration
Check for syntax errors in text array

Issue: “Unknown” client shown

Client not sending brand information
Custom or modified client
Protocol version mismatch

Debug Mode

Enable debug mode for detailed logging:

debug:
  enabled: true
  console: true
  file: true

📈 Performance

Optimization Tips

Lightweight Detection - Minimal overhead
No Database - No queries required
Event-Based - Only triggers on join
Efficient Parsing - Quick brand extraction

Monitoring

Track client distribution
Monitor detection accuracy
Review unknown clients
Analyze client patterns

Need help with the Client Detector Module? Join our Discord: https://discord.gg/2qCMn6KHj4