ВЕРСИИ (20)

### Fixed - With `prefix-source: luckperms` the name tag above the player still showed the prefix from the `prefixes` list. The name tag teams were built from that list only, so the LuckPerms prefix never reached them. They are now built from the prefixes LuckPerms returns for the players online. - With `prefix-source: luckperms`, players whose LuckPerms group is missing from the `prefixes` list got the prefix of the last entry in that list. They now get their LuckPerms prefix as well; the list only decides colour and order for them, and they sort below the listed groups. - Right after joining, before the rank was loaded, a player briefly showed the last entry of the `prefixes` list. Tested on Paper 26.3 with LuckPerms on MariaDB. Not tested on Folia or Spigot.

### 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 ```yaml # 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 ```yaml # 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 [](https://bstats.org/plugin/bukkit/LuckTAB%20by%20LucasTHCR/32022) ### 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 ```yaml 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 ```yaml # 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 ```yaml 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/лукас