KindlyTAB

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