[![Discord](https://img.shields.io/badge/Discord-dc.gg%2Fpaperstream-5865F2?style=flat-square&logo=discord&logoColor=white)](https://dc.gg/paperstream) [![Release](https://img.shields.io/modrinth/v/lucktab?style=flat-square&label=release&color=00AF5C)](https://modrinth.com/plugin/lucktab/versions) [![Downloads](https://img.shields.io/modrinth/dt/lucktab?style=flat-square&label=downloads&color=00AF5C)](https://modrinth.com/plugin/lucktab) [![Servers](https://img.shields.io/bstats/servers/32022?style=flat-square&label=servers&color=1E90FF)](https://bstats.org/plugin/bukkit/LuckTAB%20by%20LucasTHCR/32022) [![License](https://img.shields.io/badge/license-GPL--3.0-blue?style=flat-square)](https://www.gnu.org/licenses/gpl-3.0.txt) [![Built with Java 21](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/built-with/java21_vector.svg)](https://adoptium.net/) [![Available for Paper](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/supported/paper_vector.svg)](https://papermc.io/) [![Available for Purpur](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/supported/purpur_vector.svg)](https://purpurmc.org/) [![Available for Spigot](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/supported/spigot_vector.svg)](https://www.spigotmc.org/) [![Available for Bukkit](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/supported/bukkit_vector.svg)](https://dev.bukkit.org/) [![Chat with us on Discord](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/social/discord-plural_vector.svg)](https://dc.gg/paperstream) [![Available on Codeberg](https://raw.githubusercontent.com/intergrav/devins-badges/v3/assets/cozy/available/codeberg_vector.svg)](https://codeberg.org/LucasTHCR/LuckTAB)

[![bStats](https://bstats.org/signatures/bukkit/LuckTAB%20by%20LucasTHCR.svg)](https://bstats.org/plugin/bukkit/LuckTAB%20by%20LucasTHCR/32022) # LuckTAB Tab list, chat format and scoreboard in one plugin, set up from a single `config.yml`. Ranks come from LuckPerms. You write your prefixes once and they show up in the tab list, above player heads and in chat, sorted by group weight. --- ## What it does - **Tab list** - rank prefixes and sort order pulled from LuckPerms, with per-world header and footer designs - **Chat format** - your own format per rank - **Scoreboard sidebar** - per-world title and lines, falls back to `default` if a world has no design of its own - **Nametags** - prefix and suffix above player heads, via scoreboard teams - **Colours everywhere** - legacy `&` codes, hex `&#RRGGBB`, and animated gradients with `text` - **Ping colours** - `%lucktab_ping_colored%` goes green, yellow or red at thresholds you set - **Vanish support** - vanished players disappear from the tab list. Works with Essentials, CMI, SuperVanish and PremiumVanish - **LuckPerms migration** - `/lucktab migrate to-luckperms` and `from-luckperms`, so you can move your prefixes either way without retyping them - **PlaceholderAPI** - optional, works in header, footer, sidebar and chat The scoreboard updates without flickering. It keeps score entries stable and only rewrites lines that actually changed, instead of tearing the whole sidebar down and rebuilding it every tick, which is what causes the flicker you see in a lot of sidebar plugins. You can also pick where prefixes come from: `prefix-source: lucktab` uses the ones in the config, `luckperms` reads live meta instead. --- ## Server software | | Paper | Spigot | Purpur | |---|---|---|---| | Tab list, chat, nametag | yes | yes | yes | | Hex & gradient colors | yes | yes | yes | | Scoreboard anti-flicker | yes | yes | yes | | Hex/gradient in scoreboard lines | yes | legacy only | yes | Paper or Purpur if you want all of it. Spigot works, the sidebar just falls back to legacy colours. --- ## Dependencies - **LuckPerms** - required, [luckperms.net](https://luckperms.net/) - **PlaceholderAPI** - optional, [Modrinth](https://modrinth.com/plugin/placeholderapi) --- ## Colours | 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 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 installed, anything else like `%vault_eco_balance%` works too. --- ## Configuration All of it lives in `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 or less -> green medium: 100 # 100ms or less -> yellow # over 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 | Command | Permission | Default | |---|---|---| | `/lucktab reload` | `lucktab.reload` | OP | | `/lucktab migrate to-luckperms` | `lucktab.migrate` | OP | | `/lucktab migrate from-luckperms` | `lucktab.migrate` | OP | Migration calculates group weights for you, so the tab order stays the same after moving prefixes across. --- ## Credits Originally written by **PattyXDHD**, who built the foundation. Maintained by **LucasTHCR** since then: scoreboard, hex and gradient colours, suffixes, vanish support, per-world configs, ping colours, the LuckPerms migration, anti-flicker, PlaceholderAPI, the reload command, and a pile of bug fixes. Bugs and questions: [dc.gg/paperstream](https://dc.gg/paperstream)

LuckTAB

2.3-RELEASE

LuckTAB v2.3-RELEASE

Fixed

Information

Platforms