LuckTAB

Your tab. Your rules.

Lightweight yet powerful tab list, chat format & scoreboard plugin — all configurable in a single config.yml.

---

---

✨ Features

Feature	Description
Tab-List Prefix & Sorting	Rank-based prefixes and sort order via LuckPerms. Anti-flicker updates.
Header & Footer	Per-world designs with hex, gradient and legacy color support.
Chat Format	Custom format per rank with full hex & gradient color support.
Scoreboard Sidebar	Per-world sidebar with custom title and lines. Full hex & animated gradient support. Anti-flicker via stable score entries and smart change detection.
Animated Gradients	Smooth sine-based animated RGB gradients via <gradient:#RRGGBB:#RRGGBB>text</gradient> — works everywhere.
Hex Color Support	Full &#RRGGBB hex color support in prefixes, suffix, header, footer, scoreboard and chat.
Suffix Support	Add a suffix per rank — shown in tab list, nametag and chat.
Vanish Support	Vanished players are completely hidden from the tab list. Compatible with Essentials, CMI, SuperVanish and PremiumVanish.
Per-World Config	Different header/footer and scoreboard designs per world — fallback to default.
Ping Colors	%lucktab_ping_colored% — ping automatically colored green/yellow/red with configurable thresholds.
LuckPerms Migration	/lucktab migrate to-luckperms and from-luckperms — sync prefixes between config and LuckPerms.
Prefix Source	Choose between lucktab (config) or luckperms (live meta) as prefix source.
PlaceholderAPI Support	Works in header, footer, sidebar and chat.
Nametag above head	Rank prefix and suffix shown above player heads via scoreboard teams.
bStats Metrics	Anonymous usage statistics — view stats.
Update Checker	Notifies console and OPs on join when a new version is available.
/lucktab reload	Reload config without restarting the server.
/lucktab migrate	Migrate prefixes to/from LuckPerms with auto weight calculation.

---

🖥️ Server Software

	Paper	Spigot	Purpur
Tab list, chat, nametag	✅	✅	✅
Hex & gradient colors	✅	✅	✅
Scoreboard anti-flicker	✅	✅	✅
Hex/gradient in scoreboard lines	✅	⚠️ Legacy only	✅

Recommended: Paper or Purpur for full feature support. → papermc.io/downloads

---

📦 Dependencies

• LuckPerms — required — luckperms.net
• PlaceholderAPI — optional — Modrinth

---

🎨 Color Support

Format	Example	Works in
Legacy & codes	&6[VIP]	Everywhere
Hex &#RRGGBB	&#FF5733[Admin]	Everywhere
Animated gradient	<gradient:#FF0000:#FF7700>text</gradient>	Everywhere
Bold gradient	<gradient:#FF0000:#FF7700>&l[Owner]&r </gradient>	Everywhere

---

📋 Built-in Placeholders

These work everywhere without PlaceholderAPI:

Placeholder	Description
%player%	Player name
%world%	Current world name
%server_online%	Online player count
%server_max_players%	Max player count
%player_ping%	Player ping in ms (plain number)
%lucktab_ping_colored%	Ping colored green/yellow/red automatically
%lucktab_rank%	Colored rank prefix
%lucktab_prefix%	Same as %lucktab_rank%
%lucktab_suffix%	Rank suffix
%lucktab_color%	Rank name color
%lucktab_rank_display%	Prefix + color + group name + suffix
%chatPrefix%	Rank prefix in chat format
%chatSuffix%	Rank suffix in chat format

With PlaceholderAPI any third-party placeholder like %vault_eco_balance% works too.

---

⚙️ Configuration

Everything is controlled from config.yml:

# ── Prefix Source ─────────────────────────────
# lucktab   → use prefixes from this config (default)
# luckperms → use prefixes directly from LuckPerms meta
prefix-source: lucktab

# ── Ping Colors ───────────────────────────────
ping-colors:
  good: 50    # ≤ 50ms  → green
  medium: 100 # ≤ 100ms → yellow
              # > 100ms → red

# ── Tab-List ──────────────────────────────────
tab-list:
  show-only-same-world: false

# ── Chat Format ───────────────────────────────
useChatFormat: true
chatFormat: "%chatPrefix%%playerName% &8» &7%message%"

# ── Rank Prefixes ─────────────────────────────
# Format: "group;prefix;suffix;namecolor"
# Top = highest priority | suffix can be empty: "group;prefix;;color"
prefixes:
  - "owner;<gradient:#FF0000:#FF7700>[Owner] </gradient>;;&#FF7700"
  - "admin;&#FF5555[Admin] &7;;&#FF5555"
  - "mod;&#5555FF[Mod] &7;;&#5555FF"
  - "vip;&6[VIP] &7;;&6"
  - "default;&7[Player] &7;;&7"

# ── Header & Footer ───────────────────────────
# Per-world: add a section with the exact world name as key
# Falls back to "default" if no world-specific design is found
header-footer:
  enabled: true
  designs:
    default:
      header:
        - ""
        - "<gradient:#FF5733:#FFC300>   MyServer   </gradient>"
        - ""
      footer:
        - ""
        - "&fOnline: &b%server_online%&7/&b%server_max_players%  &7| &fPing: %lucktab_ping_colored%"
        - ""

# ── Scoreboard Sidebar ────────────────────────
# Per-world: add a design with the exact world name under "designs"
scoreboard:
  enabled: true
  designs:
    default:
      title: "<gradient:#FF0000:#FF7700>MyServer</gradient>"
      lines:
        - ""
        - "&7Rank: %lucktab_rank%"
        - "&7Ping: %lucktab_ping_colored%"
        - ""
        - "&7World: &f%world%"
        - ""
        - "&7Online: &f%server_online%&8/&f%server_max_players%"
        - ""

---

🔑 Commands & Permissions

Command	Permission	Default
/lucktab reload	lucktab.reload	OP
/lucktab migrate to-luckperms	lucktab.migrate	OP
/lucktab migrate from-luckperms	lucktab.migrate	OP

---

👥 Credits

PattyXDHD	Original author — created the plugin foundation
LucasTHCR	Maintainer — scoreboard, hex & gradient colors, suffix, vanish support, per-world config, ping colors, LuckPerms migration, anti-flicker, PlaceholderAPI, reload command, bug fixes & full config control

Discord: dc.gg/paperstream