KindlyKlanTAB

Lightweight server-side Fabric mod to fully customize the player TAB list — header, footer, rank prefixes/suffixes — with automatic announcements. Integrates with LuckPerms for rank-based display.

Features

• Fully customizable TAB header & footer with placeholder support
• Player name formatting with per-rank prefixes & suffixes
• LuckPerms integration — auto-detect groups, prefixes, suffixes, and weights
• Auto-updating — no manual refresh needed
• Memory-efficient — single scheduled thread, cached reflection
• Automatic announcements — title, actionbar, or chat mode
• Rich placeholders — server stats, player info, LuckPerms metadata

Placeholders

Placeholder	Description
{PLAYER_COUNT}	Online players
{MAX_PLAYERS}	Server max players
{TPS}	Server TPS
{MSPT}	Milliseconds per tick
{TIME}	Current time (HH:mm:ss)
{DATE}	Current date (dd/MM/yyyy)
{UPTIME}	Server uptime
{SERVER_NAME}	Server MOTD
{RAM_USED}	Used memory (e.g. 512.0 MB)
{RAM_TOTAL}	Total allocated memory
{RAM_FREE}	Free memory
{RAM_MAX}	Maximum memory
{RAM_PERCENT}	Used RAM percentage
{PLAYER_NAME}	Player name
{PLAYER_UUID}	Player UUID
{PLAYER_PING}	Player latency (ms)
{PLAYER_WORLD}	Current world
{PLAYER_X}, {Y}, {Z}	Player coordinates

LuckPerms placeholders

Placeholder	Description
{LUCKPERMS_PREFIX}	Group prefix
{LUCKPERMS_SUFFIX}	Group suffix
{LUCKPERMS_GROUP}	Primary group name
{LUCKPERMS_WEIGHT}	Group weight
{LUCKPERMS_META_<key>}	Custom meta value

Installation

1. Place the .jar in your server's mods/ folder (Fabric 1.21.1)
2. Restart or reload the server
3. Config files generate automatically at config/kindlyklantab/

LuckPerms is optional — the mod works perfectly without it.

Configuration

config/kindlyklantab/tab.json

{
  "enabled": true,
  "updateInterval": 20,
  "header": "<gold><bold>WELCOME</bold></gold>\\n<gray>Players: {PLAYER_COUNT}/{MAX_PLAYERS}</gray>",
  "footer": "<gray>TPS: {TPS} | RAM: {RAM_PERCENT}%</gray>",
  "enableCustomNames": true,
  "nameFormat": "{PREFIX}{PLAYER_NAME}{SUFFIX}",
  "groups": [
    { "permission": "owner",   "prefix": "<dark_red>[Owner] ", "suffix": "", "priority": 1 },
    { "permission": "admin",   "prefix": "<red>[Admin] ",      "suffix": "", "priority": 2 },
    { "permission": "mod",     "prefix": "<yellow>[Mod] ",     "suffix": "", "priority": 3 },
    { "permission": "vip",     "prefix": "<gold>[VIP] ",       "suffix": "", "priority": 4 },
    { "permission": "default", "prefix": "<gray>",             "suffix": "", "priority": 5 }
  ]
}

• updateInterval – ticks between TAB refreshes
• nameFormat – template for player names in the list
• groups – ordered by priority (lower = higher). On LuckPerms servers, permissions auto-match group names.

config/kindlyklantab/announcements.json

{
  "enabled": true,
  "interval": 6000,
  "randomOrder": false,
  "prefix": "<gray>[<gold>Announcement<gray>] ",
  "displayMode": "auto",
  "useTitleForFormatted": true,
  "announcements": [
    { "message": "<gold>Welcome to the server!", "enabled": true, "permission": "" }
  ]
}

• interval – ticks between announcements (6000 = 5 min)
• displayMode – "chat", "title", "actionbar", or "auto"
• permission – leave empty for all players, or set a LuckPerms permission node

Commands

/kktab

Subcommand	Description
reload	Reload TAB config
update	Force TAB refresh
header <text>	Change header
footer <text>	Change footer
toggle	Enable/disable TAB
info	Show TAB status
debug <player>	Show player group, prefix, ping

/kkannounce

Subcommand	Description
send <message>	Send one announcement
add <message>	Add to auto-rotation
remove <index>	Remove announcement
list	List all announcements
reload	Reload config
toggle	Enable/disable
interval <ticks>	Set interval
info	Show status

Want to donate?

https://ko-fi.com/javividev