TabPlugin

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper spigot

标签： game-mechanics management optimization

[⚠️]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! ?✨