# LuckTAB ### *Your tab. Your rules.* > Lightweight yet powerful tab list, chat format & scoreboard plugin — all configurable in a single `config.yml`. ---

[![bStats](https://bstats.org/signatures/bukkit/LuckTAB%20by%20LucasTHCR.svg)](https://bstats.org/plugin/bukkit/LuckTAB%20by%20LucasTHCR/32022) --- ## ✨ 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 `text` — 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](https://bstats.org/plugin/bukkit/LuckTAB%20by%20LucasTHCR/32022). | | **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](https://papermc.io/downloads) --- ## 📦 Dependencies - **LuckPerms** — `required` — [luckperms.net](https://luckperms.net/) - **PlaceholderAPI** — `optional` — [Modrinth](https://modrinth.com/plugin/placeholderapi) --- ## 🎨 Color Support | Format | Example | Works in | |---|---|---| | Legacy `&` codes | `&6[VIP]` | Everywhere | | Hex `&#RRGGBB` | `&#FF5733[Admin]` | Everywhere | | Animated gradient | `text` | Everywhere | | Bold gradient | `&l[Owner]&r ` | 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`: ```yaml # ── 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;[Owner] ;;&#FF7700" - "admin;&#FF5555[Admin] &7;;&#FF5555" - "mod;ᖳFF[Mod] &7;;ᖳFF" - "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: - "" - " MyServer " - "" 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: "MyServer" 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](https://dc.gg/paperstream)

LuckTAB

2.1-RELEASE

2.0-RELEASE

1.9-RELEASE

1.8-RELEASE

1.7-RELEASE

1.6-RELEASE

1.5-RELEASE