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