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

LuckPerms placeholders

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

/kkannounce

Want to donate?

https://ko-fi.com/javividev