TabPlugin

[⚠️]NOTE! If u have aby issue with the plugin please report to in our discord!

TabPing Plugin Description 🎮
Main Function:
The plugin displays player ping in milliseconds next to their nickname on the tab list (when you press Tab key). Additionally, it monitors player activity and marks inactive players as AFK .

How the ping system works: 📊

Updates every second : The plugin checks each player's ping on the server every 1 second (20 Minecraft ticks)
Color coding by speed 🌈:

• Green < 50ms - excellent ping
• Yellow 50-100ms - good ping
• Orange (GOLD) 100-150ms - medium ping
• Red > 150ms - poor ping

Display format: PlayerName [45ms]

Nickname is white
Ping is colored (depends on value)
Brackets are dark gray

How the AFK system works: 😴

Activity tracking 👀:

Plugin saves timestamp of each player's last movement
Listens to PlayerMoveEvent - reacts when player moves

Movement detection 🎯:

Plugin checks if player actually moved (X, Y, Z coordinate change)
Just rotating camera does NOT reset AFK timer
Every real movement resets the timer

AFK checking ⏲️:

Every second the plugin checks all players
If player hasn't moved for 5 minutes (300 seconds) - gets AFK status
Format: PlayerName [120ms] [AFK]

Returning from AFK ✅:

When AFK player moves - immediately loses AFK marker
Ping is automatically updated

Configuration system (config.yml): ⚙️
You can customize everything:
yamlafk:
time-seconds: 300 # Change to 60 = 1 minute, 600 = 10 minutes etc.
text: "AFK" # Can change to "AWAY" or "INACTIVE"
color: "GRAY" # Color of AFK text

ping:
thresholds:
good: 50 # Good ping threshold
medium: 100 # Medium ping threshold
bad: 150 # Bad ping threshold

colors:
good: "GREEN" # Color for <50ms
medium: "YELLOW" # Color for 50-100ms
bad: "GOLD" # Color for 100-150ms
very-bad: "RED" # Color for >150ms

Commands: 💬:

• /tabping - Forces immediate update + shows player info in chat
• /tabping reload - Reloads config.yml without server restart
• /tabping toggle - Disables/enables plugin temporarily

How the plugin handles AuthSystem: 🔐

When player joins, plugin waits 5 seconds before setting ping
This gives time to log in through AuthSystem
After logging in, ping appears automatically

Technically - what happens behind the scenes:

Memory : Plugin stores in HashMaps:

lastActivity - last activity time of each ****player (UUID → timestamp)
afkPlayers - AFK status of each player (UUID → true/false)

Events 📡:

PlayerJoinEvent - initializes player (resets AFK, sets activity time)
PlayerQuitEvent - removes player from memory
PlayerMoveEvent - updates activity time

Timers ⏲️ (BukkitRunnable):

Timer #1: Every second checks and marks AFK players
Timer #2: Every second updates ping for all players

Adventure API : Uses modern text component system for coloring

Example scenarios: 📝
Scenario 1: Normal player ✅

Player "Invvl" joins, logs in → waits 5s → displays Invvl [35ms] (green )
Player actively plays , ping updates every second

Scenario 2: Player leaves computer 💤

After 5 minutes without movement → Invvl [40ms] [AFK] (AFK gray)
Returns, moves → immediately Invvl [42ms] (AFK disappears )

Scenario 3: Bad internet

Ping jumps: 80ms → Invvl [80ms] (yellow )
Lagspike : 200ms → Invvl [200ms] (red )
Stabilizes : 60ms → Invvl [60ms] (yellow )

The plugin is lightweight (only checks movement and ping), configurable (everything in config.yml) and automatic (requires no player interaction).

Perfect for: 🎯

Survival servers
PvP servers (important ping info!)
Minigame servers
Community servers with AFK management

Enjoy your optimized tab list!