LuckTAB

Added

- Geyser and Floodgate support. Bedrock players are detected through the Floodgate API, or the Geyser API when only Geyser is installed, and get their own treatment, set in the new bedrock section of the config: - update-interval (default 20 ticks): how often their sidebar and name tags are refreshed. - animations (default off): gradients and %anim_...% stay on their first frame for them. Every frame change made Geyser redraw the whole Bedrock sidebar. - fake-entries (default off): fake tab rows, which Geyser shows as extra players with a skin. - Header and footer are no longer sent to Bedrock players at all, Bedrock cannot show them. - platform: bedrock or platform: java in a sidebar or header/footer design, so Bedrock players can get a layout of their own. - %lucktab_platform% (Bedrock or Java), also as %lucktab_bedrock% (true/false) through PlaceholderAPI. - config.yml is now upgraded on start and on /lucktab reload: blocks and options a newer version added are written into the existing file with their comments, and the old file is kept as config.yml.bak. Nothing that is already there is changed. Your own ping steps and animations get no examples mixed in, and the ping behind the tab name and the /sidebar alias are not added to a file that never had them, because without them the plugin runs without either. The file carries a config-version marker for this.

Fixed

- LuckTAB sent far more packets than it needed to, which made Geyser lag. The sidebar title, the hidden numbers and the per-line number format went out on every update, ten times a second per player and line, even when nothing had changed; so did the header and footer, and the rank team prefixes on every board every two seconds. With the default config that was well over a hundred scoreboard packets per second per player. Geyser throttles at 20 and then rebuilds the Bedrock sidebar four times a second. Now each of them is only sent when it actually changed. - The update check took the first entry of the Modrinth list and only checked whether it was the same text as the running version. A server on a newer build was told to update to an older one, and every server on a release was offered the latest beta. It now picks the highest version number, and a release build only looks at releases. - Tab list names were compared against getPlayerListName(), which does not always return the same string that was set. When it differed, every player's name went out to everybody on every update. - An animated rank prefix went out ten times a second to all four of its teams on every board, even when nobody had that rank. Teams without members are skipped now and catch up as soon as someone joins them. - Fake tab rows were added again for every viewer every two seconds. They are added once now and only a changed text is sent afterwards. - Bedrock players saw raw line keys such as lt_00000000_0 in the sidebar. Floodgate UUIDs all start with 00000000-0000-0000, and the sidebar only used the first eight characters, so every Bedrock player shared the same line keys and line cache. The id now comes from the whole UUID.

Added

- %lucktab_tps%, %lucktab_tps_colored% and %lucktab_mspt%, for a staff board or a footer without PlaceholderAPI. TPS is green from 19, yellow from 15 and red below. Both come from Paper; on Spigot they show - instead of breaking the line. Also available through the PlaceholderAPI expansion.

Changed

- The Folia support from 2.6-BETA is now part of a stable release, so servers on the default release update channel get it as well.

Added

- Folia support, with a reduced feature set. Folia does not allow a scoreboard per player, and the sidebar, name tags, tab sorting and below-name are all built on one. On Folia LuckTAB therefore runs tab list names, header and footer, ping icons and the chat format, and switches the rest off. The console says so at startup, and /lucktab toggle tells the player instead of failing. Paper, Purpur and Spigot keep the full feature set, nothing changes there.

Changed

- All scheduling goes through one adapter that uses the global, entity and async schedulers on Folia and the Bukkit scheduler everywhere else. On Folia every player is updated on the thread that owns them. - bStats is not started on Folia, because it schedules through the Bukkit scheduler.

Added

- A scoreboard players can switch off. /lucktab toggle and a configurable alias - /sidebar and /sb by default - hide and show the sidebar, and the choice is written to toggles.yml so it survives a rejoin. Turn the whole thing off with scoreboard.toggle-enabled: false. - Conditional scoreboard lines. A line whose placeholders all come back empty, 0 or null disappears instead of leaving a gap, so &7Clan: &f%clan_name% is simply not there for a player without a clan. Spacer lines without a placeholder always stay. Switch it off with scoreboard.hide-empty-lines: false. - Designs by permission, not only by world. Every design under scoreboard.designs and header-footer.designs takes permission, worlds and priority, which is what a staff board with TPS and RAM next to a normal player board needs. Designs named after a world keep working as before. - Hiding the red numbers on the right of the sidebar, and replacing them with text of your own through the numbers list. Needs Paper 1.20.4 or newer. - Animations. animations holds named frame lists with their own interval, and %anim_<name>% puts the current frame anywhere a placeholder is allowed: the sidebar title, a line, the header, the chat format. - Rotating header and footer. A design can carry frames instead of one fixed block, and the blocks change every frame-interval ticks, header and footer in step. - AFK support for EssentialsX, CMI and Purpur. An away player gets the [AFK] tag in the tab list and above their head, and their name is grayed out. All of it is configurable under afk, and none of the three plugins is required. - Ping icons. ping-icons maps a ping to a symbol, and %lucktab_ping_icon% prints it. tab-list.name-suffix puts free text behind the player name in the tab list. - Static info rows in the tab list, for a Discord or store line. They are not real players, so they need ProtocolLib; without it tab-list.fake-entries is ignored. - Name tag visibility rules. Name tags can be hidden in named worlds, while sneaking, and for everyone holding a permission. nametags.visibility and nametags.collision expose the two team options directly. - A second line under the player name, either the health bar or a numeric placeholder. Minecraft renders that slot as a number plus a title, which is what below-name reflects. - Hover cards and click actions on the player name in chat, and @Name mentions that highlight the name and play a sound for the player who was named. Hover and click are Paper only, mentions work everywhere. - Badges for the groups that did not win the prefix. badges.groups maps a group to a symbol, and %lucktab_badges% or %chatBadges% prints all of them. - /lucktab setprefix <group> <prefix> and /lucktab setsuffix <group> <suffix> change a rank in game and reload right away. Note that this rewrites config.yml through Bukkit, which drops the comments in it. - /lucktab benchmark reports what the updates cost, in microseconds, per section. - A PlaceholderAPI expansion. Other plugins can read %lucktab_prefix%, %lucktab_rank_display%, %lucktab_badges% and the rest, each also with a _plain variant without colors. This is how DiscordSRV picks up the ranks for its chat bridge: put the placeholder into the DiscordSRV message format.

Changed

- lucktab.use is granted to everyone now, so that /lucktab toggle is usable without op. Every subcommand still checks its own permission, and the new ones are lucktab.toggle (everyone), lucktab.edit and lucktab.benchmark (op). - Name tags and tab list sorting are re-checked every two seconds instead of only on join, because AFK state and name tag visibility change on their own.

Fixed

- LuckTAB did not start on Spigot. The text renderer, the tab list and the sidebar were written against Adventure and Paper-only methods, and Spigot ships neither, so the plugin died during startup before its command executor was registered. The command stayed registered without an executor, which is why /lucktab reload and /lucktab migrate answered with nothing but the /lucktab <reload|migrate> usage line from plugin.yml, while the tab list, the name tags and the sidebar stayed empty. Rendering now runs on the Bukkit API with legacy color codes on every server, and the Adventure calls are isolated in a class that is only loaded on Paper. - A failed start left the plugin marked as enabled. Spigot keeps a plugin enabled when its startup throws, so the broken state was silent apart from one line in the log. Startup errors now disable the plugin and say why. - /lucktab required lucktab.reload for every subcommand, including the migration and the help output. It checks lucktab.use now, and lucktab.reload only where it actually reloads.

Added

- Tab completion for /lucktab, for the subcommands and for the migration directions. Paper servers were never affected by the startup bug and keep the component based scoreboard lines and the chat renderer.

Fixed

- The player's own name inherited the rank prefix's color in the tab list and chat instead of showing its own configured color (or the default). The bundled default config no longer sets a name color for any rank.

LuckTAB v2.2-RELEASE

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

Fixed

- Name tag prefixes above players' heads showed raw color codes (&7[Player]) instead of the actual colors - Players joining a running server were never sorted into rank teams on everyone else's scoreboard, so they appeared without a name tag prefix and unsorted in the tab list until the next reload - Tab list sorting broke as soon as more than ten ranks were configured — lt_10_ sorted between lt_1_ and lt_2_. Rank order is now zero padded - Two groups with long, similar names could be truncated into the same team name and end up sharing a single prefix - Rank teams stayed registered when the plugin was disabled and piled up on the main scoreboard across reloads

Internal

- Split the plugin into separate classes per feature area: ranks, text rendering, tab list, teams, sidebar, chat, migration and update check

LuckTAB v2.1-RELEASE

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

Changelog

- Added /lucktab migrate to-luckperms — pushes all prefixes, suffixes and group weights from config into LuckPerms. Weight is calculated automatically: top rank = 200, each rank below -10 - Added /lucktab migrate from-luckperms — pulls all prefixes and suffixes from LuckPerms groups into config - Added prefix-source: luckperms config option — read prefix/suffix directly from LuckPerms player meta instead of config. Correctly resolves inheritance and priorities - Fixed prefix-source: luckperms reading from group cache instead of player meta — inheritance now works correctly - Fixed scoreboard line order breaking when line count changes - Fixed resource leak in update checker — connection now always closed in finally block - Fixed regex patterns recompiling on every call — now static final constants - Fixed team options (NAME_TAG_VISIBILITY, COLLISION_RULE) being set every tick — now only on team creation - Fixed migration overwriting other plugins' prefix/suffix nodes — only LuckTAB-managed nodes (matching priority) are removed

New Commands

| Command | Permission | Description | |---|---|---| | /lucktab migrate to-luckperms | lucktab.migrate | Push config prefixes to LuckPerms | | /lucktab migrate from-luckperms | lucktab.migrate | Pull LuckPerms prefixes to config |

New Config Option

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

Dependencies

- [LuckPerms](https://luckperms.net) — required - [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) — optional

Support

Join our Discord: dc.gg/paperstream Author: LucasTHCR

LuckTAB v2.0-RELEASE

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

Changelog

- Smooth animated gradients — no more jumping or rucking, fully fluid color transitions - Smart scoreboard update system — every line is rendered every tick but only written to the scoreboard if the content actually changed - Gradient lines (rank prefix, title) update every 2 ticks automatically - Static lines (ping, online count) only update when their value changes — zero unnecessary writes - Sine-based gradient interpolation — mathematically smooth, no hard color jumps at loop boundaries - Fixed scoreboard title and rank prefix lagging behind gradient animation - Fixed gradient lines being updated in slow task instead of fast task

How it works

The update system is fully automatic — no manual configuration needed. Every line is compared to its cached value each tick. If nothing changed, it is skipped. If it changed (e.g. gradient moved, ping updated), it is written.

Dependencies

- [LuckPerms](https://luckperms.net) — required - [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) — optional

Support

Join our Discord: dc.gg/paperstream Author: LucasTHCR

LuckTAB v1.9-RELEASE

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

Changelog

- Added %lucktab_ping_colored% — ping automatically colored green, yellow or red based on configurable thresholds (ping-colors.good and ping-colors.medium in config) - Added per-world header/footer — define different designs per world name, falls back to default if no world-specific design is found - Added per-world scoreboard — different sidebar title and lines per world, falls back to default - Config fully rewritten — clean, simple and self-explaining with inline examples for every feature

New Placeholders

| Placeholder | Description | |---|---| | %lucktab_ping_colored% | Ping in ms, colored green/yellow/red |

New Config Options

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

# Per-world scoreboard (falls back to default)
scoreboard:
  designs:
    default:
      title: "<gradient:#FF0000:#FF7700>MyServer</gradient>"
      lines:
        - "&7Ping: %lucktab_ping_colored%"
    world_nether:
      title: "&4&lThe Nether"
      lines:
        - "&7Ping: %lucktab_ping_colored%"

Dependencies

- [LuckPerms](https://luckperms.net) — required - [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) — optional

Support

Join our Discord: dc.gg/paperstream Author: LucasTHCR

LuckTAB v1.8-RELEASE

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

Changelog

- Spigot support improved to 90% — zero flicker scoreboard via Team-prefix trick (entry key never changes, only prefix updates) - Instant rank update — LuckPerms UserDataRecalculateEvent listener reacts immediately when a player's rank changes - Fixed Paper chat format — %message% now correctly appends the player's message as an Adventure Component - Fixed O(N²) performance issue on player join — removed redundant team update loop - Fixed gradient stripping bold/italic formatting codes — &l, &o etc. are now preserved per character - Fixed Spigot scoreboard line rendering — no more Component roundtrip, direct legacy string pipeline - Fixed update checker — now uses Gson for reliable JSON parsing instead of fragile string search - Removed updateInterval from config — animation and static updates are now handled internally at optimal intervals

Server Software

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

Dependencies

- [LuckPerms](https://luckperms.net) — required - [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) — optional

Support

Join our Discord: dc.gg/paperstream Author: LucasTHCR

LuckTAB v1.7-RELEASE

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

Changelog

- Added bStats metrics — anonymous usage statistics to help track how many servers use LuckTAB ([view stats](https://bstats.org/plugin/bukkit/32022)) - Added update checker via Modrinth API — notifies in console on startup and in-game to OPs on join when a new version is available - Fixed corrupted quote characters in internal JSON parsing

Stats

[![bStats](https://bstats.org/signatures/bukkit/LuckTAB%20by%20Lucas…

Dependencies

- [LuckPerms](https://luckperms.net) — required - [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) — optional

Support

Join our Discord: dc.gg/paperstream Author: LucasTHCR

LuckTAB v1.6-RELEASE

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

Changelog

- Added tab-list world filter — set show-only-same-world: true in config to only show players from the same world in the tab list - Improved vanish support — vanished players are now completely hidden from the tab list instead of just showing a [Vanished] prefix - Fixed chat format showing corrupted color codes (§x§F§F...) when using hex or gradient colors - Fixed gradient and hex colors breaking inside chat messages

New Config Option

tab-list:
  # true  = players only see others in the same world
  # false = all players visible (default)
  show-only-same-world: false

Dependencies

- [LuckPerms](https://luckperms.net) — required - [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) — optional

Support

Join our Discord: dc.gg/PaperStream Author: LucasTHCR

LuckTAB v1.5-RELEASE

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

Changelog

- Full hex (&#RRGGBB) and animated gradient (<gradient:#RRGGBB:#RRGGBB>text</gradient>) support in tab list, chat, scoreboard and nametag above head - Fixed scoreboard flickering — complete anti-flicker rewrite using stable score entry keys, only customName() updates each tick - Fixed gradient and hex colors showing black or raw tags in scoreboard lines - Fixed /lucktab reload showing raw MiniMessage tags instead of colored text - Fixed color rendering pipeline — all placeholders, PAPI and gradients now process in the correct order - config.yml fully rewritten — self-explaining with comments and examples for every feature

Color Support

# Legacy
- "vip;&6[VIP] &7;;&6"
# Hex
- "admin;&#FF5555[Admin] &7;;&#FF5555"
# Animated gradient
- "owner;<gradient:#FF0000:#FF7700>[Owner] </gradient>;;&#FF7700"

Dependencies

- [LuckPerms](https://luckperms.net) — required - [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) — optional

Support

Join our Discord: dc.gg/PaperStream Author: LucasTHCR

LuckTAB v1.4-RELEASE

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

Changelog

- Added hex color support via &#RRGGBB — works in prefixes, header, footer, scoreboard and chat - Fixed scoreboard flickering — anti-flicker system now compares rendered lines to a cache and only rebuilds when something actually changed

Hex Color Usage

prefixes:
  - "owner;&#FF5733[Owner] &7;&f"

scoreboard:
  title: "&#FF5733&lMyServer"

Dependencies

- [LuckPerms](https://luckperms.net) — required - [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) — optional

Support

Join our Discord: dc.gg/paperstream Author: LucasTHCR

LuckTAB v1.3-RELEASE

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

Changelog

- Fixed %lucktab_rank% now correctly displays the colored rank prefix in the scoreboard instead of plain white text - Added %lucktab_color% placeholder — returns only the name color of the rank - %lucktab_rank% and %lucktab_prefix% now return identical output — the colored prefix from config

Dependencies

- [LuckPerms](https://luckperms.net) — required - [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) — optional

Support

Join our Discord: **dc.gg/PaperStream

LuckTAB v1.2-RELEASE

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

What's new in v1.2?

- Fixed rank prefix not showing above player heads — nametag visibility now works correctly for all players regardless of scoreboard assignment - Fixed rank priority — the order of the prefixes list in config.yml is now fully respected (top = highest priority) - Fixed nametag rendering — all rank teams are now registered on every player's scoreboard so everyone sees the correct prefix - General stability improvements

Dependencies

- [LuckPerms](https://luckperms.net) — required - [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) — optional

Support

Join our Discord: dc.gg/PaperStream

LuckTAB v1.1 Config.yml has been restructured — if you are updating from an older version, please delete your existing config.yml and let it regenerate. All options remain the same but the layout has been cleaned up. Bug Fixes - Fixed tab sorting not updating correctly when a player's rank changed - Fixed scoreboard flickering on rapid updates - Fixed an issue where inherited LuckPerms groups were not resolved correctly - Fixed chat format not applying on some server configurations If you run into any issues, feel free to reach out on Discord: dc.gg/лукас