Merge pull request #1741 from TH3N3WN00B/fix/small-bugs

Fix 7 small bugs (bossbar send permission, proxy nametag/vanish sync, Velocity quit, ...) and update dependencies
Address review: keep mysql-connector-j 9.6.0, no warning for default skins
2026-11-12 20:22:01 -05:00 · 2026-11-11 17:19:44 +01:00 · 2026-11-09 12:00:35 -06:00 · 2026-11-09 18:23:15 +01:00 · 2026-11-08 13:31:38 -06:00 · 2026-11-08 13:18:19 -06:00
711 changed files with 38519 additions and 16713 deletions
@@ -0,0 +1,29 @@
+name: Backport
+description: Backport to an older version of MC for modded platforms
+labels: ["Type: Backport"]
+body:
+  - type: input
+    attributes:
+      label: Server software and version
+      description: Server software and version to backport to
+      placeholder: Forge 1.5.2
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Other
+      description: Anything else you may want to say
+      placeholder: Lots of servers want this and it's missing
+    validations:
+      required: false
+
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      description: Let's make sure this request is valid
+      options:
+        - label: This is not a request to update to a new MC version that just came out
+          required: true
+        - label: This version is either not available on Modrinth, or is very outdated
+          required: false
@@ -0,0 +1,20 @@
+name: Problem
+description: A problem with the plugin that is not a bug
+labels: ["Type: Problem"]
+body:
+  - type: textarea
+    attributes:
+      label: Description
+      description: Describe the problem
+      placeholder: |
+        Describe the problem here. This is not limited to the plugin jar itself. You may report issues with the wiki, plugin description on marketplaces, or anything else related to TAB.
+    validations:
+      required: true
+
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      description: Let's make sure this report is valid
+      options:
+        - label: This is not an error, bug report, compatibility issue or anything of that kind
+          required: true
@@ -1,6 +1,6 @@
 # About
-This folder contains the plugin's description as advertised on various marketplaces which use various syntaxes
-(bbcode, markdown).  
+This folder contains the plugin's description as advertised on various marketplaces where each one uses a different syntax.
+(BBCode, Markdown).  
  
 While this is not an accurate folder to have this stored in (`.github`),
 it is the closest if we don't want to create a folder for this in the root.  
@@ -2,12 +2,12 @@
 TAB is an all-in-one plugin for displaying information in various places, which aims to outperform all similar plugins in terms of features, compatibility and performance.
 The compact configuration allows you to get the plugin to work the way you want regardless of how simple or complex you want it to be or how experienced you are. The default configuration already contains useful values and examples to give you a better understanding and get you started quickly with instant results. The extensive [URL='https://github.com/NEZNAMY/TAB/wiki']wiki[/URL] answers any of your questions.

-[IMG]https://img.shields.io/badge/Release-5.0.5-blue.svg[/IMG]
-[IMG]https://img.shields.io/badge/Minecraft-1.5%20--%201.21.4-blue.svg[/IMG]
-[IMG]https://img.shields.io/badge/Java-8+-blue.svg[/IMG]
-[URL='https://github.com/NEZNAMY/TAB'][IMG]https://img.shields.io/badge/GitHub-Source%20code-yellow.svg[/IMG][/URL]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Badge_Release.svg[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Badge_Minecraft.svg[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Badge_Java.svg[/IMG]
+[URL='https://github.com/NEZNAMY/TAB'][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Badge_SourceCode.svg[/IMG][/URL]
 [URL='https://github.com/NEZNAMY/TAB/issues'][IMG]https://img.shields.io/github/issues/neznamy/tab?label=Issues[/IMG][/URL]
-[URL='https://github.com/NEZNAMY/TAB/wiki'][IMG]https://img.shields.io/badge/Documentation-Wiki-yellow.svg[/IMG][/URL]
+[URL='https://github.com/NEZNAMY/TAB/wiki'][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Badge_Documentation.svg[/IMG][/URL]
 [CENTER][B][SIZE=7]Discord?[/SIZE][/B][/CENTER]
 Official support by me is no longer provided to free users due to limited time and extreme inefficiency (see [URL='https://github.com/NEZNAMY/TAB?tab=readme-ov-file#provided-services']provided services[/URL] for more info).
 However, you can join this [URL='https://discord.gg/YPqXt63YQj']fresh new community discord[/URL] made by a nice person who promises to help everyone with all plugins, including TAB.
@@ -15,164 +15,20 @@ However, you can join this [URL='https://discord.gg/YPqXt63YQj']fresh new commun
 Before you consider requiring assistance, check out the [URL='https://github.com/NEZNAMY/TAB/wiki']wiki[/URL] first. It will answer any questions you may have and is also constantly getting improved.

 [CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Features.png[/IMG]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_HeaderFooter.png[/IMG]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_HeaderFooter.png[/IMG][/CENTER]
-[LIST]
-[*]Per-world / per-server support
-[*]Per-group / per-player support
-[*]Disable if a specified condition is met
-[/LIST]
-[CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_NameTags.png[/IMG]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_NameTags.png[/IMG][/CENTER]
-[LIST]
-[*]Configurable prefix and suffix
-[*]Per-world / per-server support
-[*]Per-group / per-player support
-[*]Disable if a specified condition is met
-[*]Make nametags completely invisible
-[*]Control collision rule
-[*]Automatic compensation for 1.8.x client sided bug making nametags of invisible players still visible
-[*]Anti-override to prevent other plugins from overriding this one
-[/LIST]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Sorting.png[/IMG]
-[CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_Sorting.png[/IMG][/CENTER]
-[LIST]
-[*]Sorting by primary permission group
-[*]Sorting by permission nodes
-[*]Sorting by a numeric placeholder from lowest to highest or highest to lowest
-[*]Alphabetically by a placeholder (A-Z or Z-A)
-[*]Sorting by pre-defined placeholder values
-[*]Combination of multiple sorting types
-[*]Enable / disable case-sensitive sorting
-[/LIST]
-[CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_TablistFormatting.png[/IMG]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_TablistFormatting.png[/IMG][/CENTER]
-[LIST]
-[*]Configurable prefix, name and suffix
-[*]Per-world / per-server support
-[*]Per-group / per-player support
-[*]Disable if a specified condition is met
-[*]Anti-override to prevent other plugins from overriding this one
-[/LIST]
-[CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_PlayerlistObjective.png[/IMG]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_PlayerlistObjectiveNumber.png[/IMG]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_PlayerlistObjectiveHealth.png[/IMG]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_PlayerlistObjectiveFancy.png[/IMG][/CENTER]
-[LIST]
-[*]Display value of any numeric placeholder or hearts
-[*]Display any text on 1.20.3+
-[*]Disable if a specified condition is met
-[/LIST]
-[CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Belowname.png[/IMG]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_BelownameComparison.png[/IMG][/CENTER]
-[LIST]
-[*]Display value of any numeric placeholder (<1.20.3) or any text (1.20.3+)
-[*]Configurable text
-[*]Disable if a specified condition is met
-[/LIST]
-[CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Bossbar.png[/IMG]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_BossBar.png[/IMG][/CENTER]
-[LIST]
-[*]Configurable text, progress, color and style
-[*]Define display condition to see a bossbar
-[*]Announce defined bossbar for specified amount of time
-[*]Configurable toggle command and message
-[*]Option to remember toggle choice between logins
-[/LIST]
-[CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_GlobalPlayerlist.png[/IMG][/CENTER]
-[LIST]
-[*]Display players from all servers on a proxy network in tablist
-[*]Configurable server groups to share playerlist instead of with all servers
-[*]Ability to create isolated servers
-[*]Servers where people will see everyone
-[*]Compatible with vanish plugins
-[*]Option to display players from other servers as spectators
-[/LIST]
-[CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Layout.png[/IMG]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_Layout.png[/IMG][/CENTER]
-[LIST]
-[*]Customize all 80 tablist slots
-[*]Create static slots with any text and skin
-[*]Create player groups based on conditions
-[*]Multiple layouts based on conditions
-[/LIST]
-[CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Scoreboard.png[/IMG]
-[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_ScoreboardComparison.png[/IMG][/CENTER]
-[LIST]
-[*]Display up to 15 lines
-[*]Option to show 0 (or any other static number) in every line instead of 1-15
-[*]Fully configurable text on right side of lines on 1.20.3+
-[*]Displaying different scoreboards based on conditions (output of placeholder, permissions)
-[*]Up to 64 characters per line for <1.13, unlimited for 1.13+ clients
-[*]Customizable toggle command and message
-[*]Option to remember toggle choice between logins
-[*]Automatic detection of scoreboards from other plugins to hide own and show it again once other plugin hides its scoreboard
-[/LIST]
-[CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_PerWorldPlayerlist.png[/IMG][/CENTER]
-[LIST]
-[*]Only display players from current world in tablist
-[*]Group worlds which should share players
-[*]Worlds where players see everyone
-[*]Option to see all players in all worlds for players with permission
-[/LIST]
-[CENTER][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_API.png[/IMG][/CENTER]
-[LIST]
-[*]Change player prefix/name/suffix in tablist
-[*]Change header/footer
-[*]Change nametag prefix / suffix
-[*]Change player collision rule and nametag visibility
-[*]Change sorting priority
-[*]Create custom scoreboards, show different scoreboard, toggle scoreboard
-[*]Create custom placeholders
-[*]Create custom boss bars, toggle bossbar visibility, announce bossbar
-[*]... and more!
-[/LIST]
-[LIST]
-[*]Placeholder support
-[LIST]
-[*]Internal placeholders with customizable output
-[*]Create and use custom animations
-[*]All placeholders and animations are supported in all features
-[*]Full PlaceholderAPI support including relational placeholders
-[*]PlaceholderAPI support on BungeeCord
-[/LIST]
-[*]Placeholder output replacements
-[LIST]
-[*]Modify output of any placeholder, including PlaceholderAPI placeholders
-[*]Replace exact text with another text
-[*]Change output if it's in a number interval
-[*]Set value if none of the above is met
-[*]Use original placeholder's output in new one
-[*]Support for nested placeholders
-[*]Can be used in other plugins as well
-[/LIST]
-[*]RGB Support
-[LIST]
-[*]5 supported RGB patterns
-[*]4 supported gradient patterns
-[*]Automatically display closest color to legacy clients
-[*]Configurable color for legacy clients
-[*]Supported in all features [B]where possible[/B]
-[/LIST]
-[*]Conditional placeholders
-[LIST]
-[*]Conditions based on placeholder output (comparing numeric value, exact output)
-[*]Conditions based on permission node
-[*]Combine conditions with AND or OR
-[*]Configurable output of both cases when condition is and isn't met
-[*]Placeholder support in condition output
-[/LIST]
-[*]High performance
-[LIST]
-[*]Full control of CPU usage by optimizing configuration and disabling unwanted features
-[*]Fully asynchronous - no impact on TPS
-[*]Check plugin's CPU usage using /tab cpu
-[/LIST]
-[*]RedisBungee support
-[*]MySQL support
-[*]Fully client-sided, server-side stays unaffected (scoreboards with their teams and objectives, bossbar entities, armor stands)
-[*]Disable vanilla feature making players in spectator gamemode appear on the bottom of tablist
-[*]Possible errors moved into a separate file to not spam your console
-[*]Yaml error assistant for more user-friendly messages and fix suggestions
-[*]Many misconfiguration checks to help solve issues much faster
-[/LIST]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_HeaderFooter.png[/IMG][IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_NameTags.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Sorting.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_TablistFormatting.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_PlayerlistObjective.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Belowname.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Bossbar.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_GlobalPlayerlist.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Layout.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Scoreboard.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_PerWorldPlayerlist.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_API.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Placeholders.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_PlaceholderOutputReplacements.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_RGB.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_ConditionalPlaceholders.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_HighPerformance.png[/IMG]
+[IMG]https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_More.png[/IMG][/CENTER]
@@ -4,12 +4,12 @@ The compact configuration allows you to get the plugin to work the way you want
 The default configuration already contains useful values and examples to give you a better understanding and get you started quickly with instant results.
 The extensive [wiki](https://github.com/NEZNAMY/TAB/wiki) answers any of your questions.

-![https://img.shields.io/badge/Release-5.0.5-blue.svg](https://img.shields.io/badge/Release-5.0.5-blue.svg)  
-![https://img.shields.io/badge/Minecraft-1.5%20--%201.21.4-blue.svg](https://img.shields.io/badge/Minecraft-1.5%20--%201.21.4-blue.svg)  
-![https://img.shields.io/badge/Java-8+-blue.svg](https://img.shields.io/badge/Java-8+-blue.svg)  
-[![https://img.shields.io/badge/GitHub-Source%20code-yellow.svg](https://img.shields.io/badge/GitHub-Source%20code-yellow.svg)](https://github.com/NEZNAMY/TAB)  
-[![https://img.shields.io/github/issues/neznamy/tab?label=Issues](https://img.shields.io/github/issues/neznamy/tab?label=Issues)](https://github.com/NEZNAMY/TAB/issues)  
-[![https://img.shields.io/badge/Documentation-Wiki-yellow.svg](https://img.shields.io/badge/Documentation-Wiki-yellow.svg)](https://github.com/NEZNAMY/TAB/wiki)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Badge_Release.svg)  
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Badge_Minecraft.svg)      
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Badge_Java.svg)  
+[![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Badge_SourceCode.svg)](https://github.com/NEZNAMY/TAB)  
+[![](https://img.shields.io/github/issues/neznamy/tab?label=Issues)](https://github.com/NEZNAMY/TAB/issues)  
+[![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Badge_Documentation.svg)](https://github.com/NEZNAMY/TAB/wiki)

 # Discord?
 Official support by me is no longer provided to free users due to limited time and extreme inefficiency (see [provided services]([https://github.com/NEZNAMY/TAB?tab=readme-ov-file#provided-services](https://github.com/NEZNAMY/TAB?tab=readme-ov-file#provided-services)) for more info).
@@ -18,148 +18,21 @@ However, you can join this [fresh new community discord]([https://discord.gg/YPq
 Before you consider requiring assistance, check out the [wiki](https://github.com/NEZNAMY/TAB/wiki) first. It will answer any questions you may have and is also constantly getting improved.

 ![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Features.png)
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_HeaderFooter.png)  
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_HeaderFooter.png)
-* Per-world / per-server support
-* Per-group / per-player support
-* Disable if a specified condition is met
-
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_NameTags.png)
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_NameTags.png)
-* Configurable prefix and suffix
-* Per-world / per-server support
-* Per-group / per-player support
-* Disable if a specified condition is met
-* Make nametags completely invisible
-* Control collision rule
-* Automatic compensation for 1.8.x client sided bug making nametags of invisible players still visible
-* Anti-override to prevent other plugins from overriding this one
-
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Sorting.png)
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_Sorting.png)
-* Sorting by primary permission group
-* Sorting by permission nodes
-* Sorting by a numeric placeholder from lowest to highest or highest to lowest
-* Alphabetically by a placeholder (A-Z or Z-A)
-* Sorting by pre-defined placeholder values
-* Combination of multiple sorting types
-* Enable / disable case-sensitive sorting
-
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_TablistFormatting.png)  
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_TablistFormatting.png)
-* Configurable prefix, name and suffix
-* Per-world / per-server support
-* Per-group / per-player support
-* Disable if a specified condition is met
-* Anti-override to prevent other plugins from overriding this one
-
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_PlayerlistObjective.png)  
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_PlayerlistObjectiveNumber.png)  
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_PlayerlistObjectiveHealth.png)  
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_PlayerlistObjectiveFancy.png)
-* Display value of any numeric placeholder or hearts
-* Display any text on 1.20.3+
-* Disable if a specified condition is met
-
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Belowname.png)
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_BelownameComparison.png)
-* Display value of any numeric placeholder (<1.20.3) or any text (1.20.3+)
-* Configurable text
-* Disable if a specified condition is met
-
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Bossbar.png)  
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_BossBar.png)
-* Configurable text, progress, color and style
-* Define display condition to see a bossbar
-* Announce defined bossbar for specified amount of time
-* Configurable toggle command and message
-* Option to remember toggle choice between logins
-
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_GlobalPlayerlist.png)
-* Display players from all servers on a proxy network in tablist
-* Configurable server groups to share playerlist instead of with all servers
-* Ability to create isolated servers
-* Servers where people will see everyone
-* Compatible with vanish plugins
-* Option to display players from other servers as spectators
-
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Layout.png)  
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_Layout.png)
-* Customize all 80 tablist slots
-* Create static slots with any text and skin
-* Create player groups based on conditions
-* Multiple layouts based on conditions
-
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_Scoreboard.png)  
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Example_ScoreboardComparison.png)
-* Display up to 15 lines
-* Option to show 0 (or any other static number) in every line instead of 1-15
-* Fully configurable text on the right side of lines on 1.20.3+
-* Displaying different scoreboards based on conditions (output of placeholder, permissions)
-* Up to 64 characters per line for <1.13, unlimited for 1.13+ clients
-* Customizable toggle command and message
-* Option to remember toggle choice between logins
-* Automatic detection of scoreboards from other plugins to hide own and show it again once the other plugin hides its scoreboard
-
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_PerWorldPlayerlist.png)
-* Only display players from the same world in tablist
-* Group worlds which should share players
-* Worlds where players see everyone
-* Option to see all players in all worlds for players with permission
-
-![](https://raw.githubusercontent.com/NEZNAMY/TAB/master/.github/description/images/Section_API.png)
-* Change player prefix/name/suffix in tablist
-* Change header/footer
-* Change nametag prefix / suffix
-* Change player collision rule and nametag visibility
-* Change sorting priority
-* Create custom scoreboards, show different scoreboard, toggle scoreboard
-* Create custom placeholders
-* Create custom boss bars, toggle bossbar visibility, announce bossbar
-* ... and more!
-
-.  
-.  
-.  
-.  
-.  
-Placeholder support
-* Internal placeholders with customizable output
-* Create and use custom animations
-* All placeholders and animations are supported in all features
-* Full [PlaceholderAPI]('https://www.spigotmc.org/resources/placeholderapi.6245/') support including [relational placeholders]('https://www.spigotmc.org/resources/placeholderapi.6245/update?update=167267')
-* PlaceholderAPI support on BungeeCord / Velocity
-
-Placeholder output replacements
-* Modify output of any placeholder, including PlaceholderAPI placeholders
-* Replace exact text with another text
-* Change output if it's in a number interval
-* Set value if none of the above is met
-* Use original placeholder's output in new one
-* Support for nested placeholders
-* Can be used in other plugins as well
-
-RGB Support
-* 5 supported RGB patterns
-* 3 supported gradient patterns
-* Supported in all features **where possible**
-
-Conditional placeholders
-* Conditions based on placeholder output (comparing numeric value, exact output)
-* Conditions based on permission node
-* Combine conditions with `AND` or `OR`
-* Configurable output of both cases when condition is and isn't met
-* Placeholder support in conditions
-
-High performance
-* Full control of CPU usage by optimizing configuration and disabling unwanted features
-* Fully asynchronous - no impact on TPS
-* Check plugin's CPU usage using /tab cpu
-
-RedisBungee support  
-MySQL support  
-Fully client-sided, server-side stays unaffected  
-Disable vanilla feature making players in spectator gamemode appear on the bottom of tablist  
-Possible errors moved into a separate file to not spam your console  
-Yaml error assistant for more user-friendly messages and fix suggestions    
-Many misconfiguration checks to help solve issues much faster  
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_HeaderFooter.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_NameTags.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Sorting.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_TablistFormatting.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_PlayerlistObjective.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Belowname.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Bossbar.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_GlobalPlayerlist.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Layout.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Scoreboard.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_PerWorldPlayerlist.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_API.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_Placeholders.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_PlaceholderOutputReplacements.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_RGB.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_ConditionalPlaceholders.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_HighPerformance.png)
+![](https://raw.githubusercontent.com/NEZNAMY/TAB/refs/heads/master/.github/description/images/Generated_More.png)
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="126" height="20" role="img" aria-label="Documentation: Wiki"><title>Documentation: Wiki</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="126" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="93" height="20" fill="#555"/><rect x="93" width="33" height="20" fill="#d8b800"/><rect width="126" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="475" y="150" fill-opacity=".8" filter="url(#blur)" textLength="830">Documentation</text><text x="475" y="150" fill-opacity=".3" textLength="830">Documentation</text></g><text x="475" y="140" textLength="830">Documentation</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="1085" y="150" fill-opacity=".8" filter="url(#blur)" textLength="230">Wiki</text><text x="1085" y="150" fill-opacity=".3" textLength="230">Wiki</text></g><text x="1085" y="140" textLength="230">Wiki</text></g></g></svg>
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="60" height="20" role="img" aria-label="Java: 8+"><title>Java: 8+</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="60" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="35" height="20" fill="#555"/><rect x="35" width="25" height="20" fill="#007ec6"/><rect width="60" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="185" y="150" fill-opacity=".8" filter="url(#blur)" textLength="250">Java</text><text x="185" y="150" fill-opacity=".3" textLength="250">Java</text></g><text x="185" y="140" textLength="250">Java</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="465" y="150" fill-opacity=".8" filter="url(#blur)" textLength="150">8+</text><text x="465" y="150" fill-opacity=".3" textLength="150">8+</text></g><text x="465" y="140" textLength="150">8+</text></g></g></svg>
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="92" height="20" role="img" aria-label="Release: 6.2.1"><title>Release: 6.2.1</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="92" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="53" height="20" fill="#555"/><rect x="53" width="39" height="20" fill="#007ec6"/><rect width="92" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="275" y="150" fill-opacity=".8" filter="url(#blur)" textLength="430">Release</text><text x="275" y="150" fill-opacity=".3" textLength="430">Release</text></g><text x="275" y="140" textLength="430">Release</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="715" y="150" fill-opacity=".8" filter="url(#blur)" textLength="290">6.2.1</text><text x="715" y="150" fill-opacity=".3" textLength="290">6.2.1</text></g><text x="715" y="140" textLength="290">6.2.1</text></g></g></svg>
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="124" height="20" role="img" aria-label="GitHub: Source code"><title>GitHub: Source code</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="124" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="47" height="20" fill="#555"/><rect x="47" width="77" height="20" fill="#d8b800"/><rect width="124" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="245" y="150" fill-opacity=".8" filter="url(#blur)" textLength="370">GitHub</text><text x="245" y="150" fill-opacity=".3" textLength="370">GitHub</text></g><text x="245" y="140" textLength="370">GitHub</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="845" y="150" fill-opacity=".8" filter="url(#blur)" textLength="670">Source code</text><text x="845" y="150" fill-opacity=".3" textLength="670">Source code</text></g><text x="845" y="140" textLength="670">Source code</text></g></g></svg>
@@ -0,0 +1,285 @@
+from PIL import Image, ImageDraw, ImageFont
+import requests
+
+line_spacing = 10
+padding = 10
+
+class Text:
+
+    def __init__(self, text, color="black", font=ImageFont.truetype("arial.ttf", 20)):
+        self.text = text
+        self.color = color
+        self.font = font
+
+class ImageGenerator:
+
+    def __init__(self, overlay_text, second_images, output_path, texts):
+        self.overlay_text = overlay_text
+        self.second_images = second_images
+        self.output_path = output_path
+        self.texts = texts
+
+        self.header_template = Image.open("Template_Small.png")
+        self.example_images = [Image.open(path) for path in second_images]
+
+    def calculate_total_height(self):
+        total_text_height = 0
+        for text in self.texts:
+            text_width, text_height = ImageDraw.Draw(self.header_template).textbbox((0, 0), text.text, font=text.font)[2:]
+            total_text_height += text_height + line_spacing
+
+        total_second_images_height = sum([img.height+padding for img in self.example_images])
+        return self.header_template.height + total_second_images_height + total_text_height + (3 * padding)
+
+    def draw_rounded_border(self, final_img, draw, radius, color, width):
+        draw.rounded_rectangle([(0, 0), (final_img.width - 1, final_img.height - 1)], radius=radius, outline=color, width=width)
+
+    def paste_top_image(self, final_img, font):
+        header_with_text = self.header_template.copy()
+        draw = ImageDraw.Draw(header_with_text)
+
+        text_width, text_height = draw.textbbox((0, 0), self.overlay_text, font=font)[2:]
+        text_x = (header_with_text.width - text_width) // 2  # Center text horizontally
+        text_y = 20  # Padding from the top
+
+        draw.text((text_x, text_y), self.overlay_text, fill="white", font=font)
+
+        final_img.paste(header_with_text, (padding, padding))
+
+    def paste_examples(self, final_img):
+        y_offset = self.header_template.height + 2 * padding
+        for img2 in self.example_images:
+            img2_x = (final_img.width - img2.width) // 2  # Center horizontally
+            final_img.paste(img2, (img2_x, y_offset))
+            y_offset += img2.height + padding
+
+        return y_offset
+
+    def paste_text(self, final_draw, y_offset):
+        y_offset += padding  # Extra padding before text
+        for text in self.texts:
+            fancy_line = f"• {text.text}"  # Add bullet point
+            final_draw.text((padding, y_offset), fancy_line, fill=text.color, font=text.font)
+            y_offset += ImageDraw.Draw(self.header_template).textbbox((0, 0), fancy_line, font=text.font)[3] + line_spacing  # Add space between lines
+
+    def save(self, final_img):
+        final_img.save(self.output_path)
+
+
+def create_image(overlay_text, second_images, output_path, texts):
+    generator = ImageGenerator(overlay_text, second_images, output_path, texts)
+    final_img = Image.new("RGB", (generator.header_template.width + 2 * padding, generator.calculate_total_height()), "white")
+    final_draw = ImageDraw.Draw(final_img)
+
+    # Rounded border
+    generator.draw_rounded_border(final_img, final_draw, 15, (39, 0, 114), 5)
+
+    # Template with text
+    generator.paste_top_image(final_img, ImageFont.truetype("arial.ttf", 60))
+
+    # Examples
+    y_offset = generator.paste_examples(final_img)
+
+    # Text
+    generator.paste_text(final_draw, y_offset)
+
+    # Save
+    generator.save(final_img)
+
+def download_image(url, save_path):
+    try:
+        response = requests.get(url, stream=True)
+        response.raise_for_status()
+
+        with open(save_path, "wb") as file:
+            for chunk in response.iter_content(1024):
+                file.write(chunk)
+
+    except requests.RequestException as e:
+        print(f"Error downloading image: {e}")
+
+if __name__ == "__main__":
+    create_image("Header & Footer", ["Example_HeaderFooter.png"], "Generated_HeaderFooter.png",
+                 [
+                     Text("Per-world / per-server support"),
+                     Text("Per-group / per-player support"),
+                     Text("Disable if a specified condition is met")
+                 ]
+    )
+    create_image("NameTags", ["Example_NameTags.png"], "Generated_NameTags.png",
+                 [
+                     Text("Configurable prefix and suffix"),
+                     Text("Per-world / per-server support"),
+                     Text("Per-group / per-player support"),
+                     Text("Disable if a specified condition is met"),
+                     Text("Make nametags completely invisible"),
+                     Text("Control collision rule"),
+                     Text("Automatic compensation for 1.8.x client sided bug making nametags of invisible players still visible"),
+                     Text("Anti-override to prevent other plugins from overriding this one")
+                 ]
+    )
+    create_image("Sorting", ["Example_Sorting.png"], "Generated_Sorting.png",
+                 [
+                     Text("Sorting by primary permission group"),
+                     Text("Sorting by permission nodes"),
+                     Text("Sorting by a numeric placeholder from lowest to highest or highest to lowest"),
+                     Text("Alphabetically by a placeholder (A-Z or Z-A)"),
+                     Text("Sorting by pre-defined placeholder values"),
+                     Text("Combination of multiple sorting types"),
+                     Text("Enable / disable case-sensitive sorting")
+                 ]
+    )
+    create_image("Tablist Formatting", ["Example_TablistFormatting.png"], "Generated_TablistFormatting.png",
+                 [
+                     Text("Configurable prefix, name and suffix"),
+                     Text("Per-world / per-server support"),
+                     Text("Per-group / per-player support"),
+                     Text("Disable if a specified condition is met"),
+                     Text("Anti-override to prevent other plugins from overriding this one")
+                 ]
+    )
+    create_image("Playerlist Objective",
+                 [
+                     "Example_PlayerlistObjectiveNumber.png",
+                     "Example_PlayerlistObjectiveHealth.png",
+                     "Example_PlayerlistObjectiveFancy.png"
+                 ],
+                 "Generated_PlayerlistObjective.png",
+                 [
+                     Text("Display value of any numeric placeholder or hearts"),
+                     Text("Display any text on 1.20.3+"),
+                     Text("Disable if a specified condition is met")
+                 ]
+    )
+    create_image("Belowname", ["Example_BelownameComparison.png"], "Generated_Belowname.png",
+                 [
+                     Text("Display value of any numeric placeholder (<1.20.3) or any text (1.20.3+)"),
+                     Text("Configurable text"),
+                     Text("Disable if a specified condition is met")
+                 ]
+    )
+    create_image("Bossbar", ["Example_BossBar.png"], "Generated_Bossbar.png",
+                 [
+                     Text("Configurable text, progress, color and style"),
+                     Text("Define display condition to see a bossbar"),
+                     Text("Announce defined bossbar for specified amount of time"),
+                     Text("Configurable toggle command and message"),
+                     Text("Option to remember toggle choice between logins")
+                 ]
+    )
+    create_image("Global Playerlist", [], "Generated_GlobalPlayerlist.png",
+                 [
+                     Text("Display players from all servers on a proxy network in tablist"),
+                     Text("Configurable server groups to share playerlist instead of with all servers"),
+                     Text("Ability to create isolated servers"),
+                     Text("Servers where people will see everyone"),
+                     Text("Compatible with vanish plugins"),
+                     Text("Option to display players from other servers as spectators")
+                 ]
+    )
+    create_image("Layout", ["Example_Layout.png"], "Generated_Layout.png",
+                 [
+                     Text("Customize all 80 tablist slots"),
+                     Text("Create static slots with any text and skin"),
+                     Text("Create player groups based on conditions"),
+                     Text("Multiple layouts based on conditions")
+                 ]
+    )
+    create_image("Scoreboard", ["Example_ScoreboardComparison.png"], "Generated_Scoreboard.png",
+                 [
+                     Text("Display up to 15 lines"),
+                     Text("Option to show 0 (or any other static number) in every line instead of 1-15"),
+                     Text("Fully configurable text on right side of lines on 1.20.3+"),
+                     Text("Displaying different scoreboards based on conditions (output of placeholder, permissions)"),
+                     Text("Up to 64 characters per line for <1.13, unlimited for 1.13+ clients"),
+                     Text("Customizable toggle command and message"),
+                     Text("Option to remember toggle choice between logins"),
+                     Text("Automatic detection of scoreboards from other plugins to hide own and show it again once other plugin hides its scoreboard")
+                 ]
+    )
+    create_image("Per world Playerlist", [], "Generated_PerWorldPlayerlist.png",
+                 [
+                     Text("Only display players from current world in tablist"),
+                     Text("Group worlds which should share players"),
+                     Text("Worlds where players see everyone"),
+                     Text("Option to see all players in all worlds for players with permission")
+                 ]
+    )
+    create_image("API", [], "Generated_API.png",
+                 [
+                     Text("Tablist formatting - Change player prefix/name/suffix"),
+                     Text("Header / Footer - Change values"),
+                     Text("Teams - Change nametag prefix / suffix, change visibility, collision rule"),
+                     Text("Sorting - Change sorting priority"),
+                     Text("Scoreboard - Create custom scoreboards, show different scoreboard, toggle scoreboard, announce scoreboard"),
+                     Text("Bossbar - Create custom boss bars, toggle bossbar visibility, announce/send bossbar"),
+                     Text("Layout - Create custom layouts, send existing layouts"),
+                     Text("Placeholders - Create custom placeholders")
+                 ]
+    )
+    create_image("Placeholders", [], "Generated_Placeholders.png",
+                 [
+                     Text("Internal placeholders with customizable output"),
+                     Text("Create and use custom animations"),
+                     Text("All placeholders and animations are supported in all features"),
+                     Text("Full PlaceholderAPI support including relational placeholders"),
+                     Text("PlaceholderAPI support on BungeeCord / Velocity"),
+                     Text("Conditional placeholders")
+                 ]
+    )
+    create_image("Conditional placeholders", [], "Generated_ConditionalPlaceholders.png",
+                 [
+                     Text("Conditions based on placeholder output (comparing numeric value, exact output)"),
+                     Text("Conditions based on permission node"),
+                     Text("Combine conditions with AND or OR"),
+                     Text("Configurable output of both cases when condition is and isn't met"),
+                     Text("Placeholder support in condition output")
+                 ]
+    )
+    create_image("Placeholder replacements", [], "Generated_PlaceholderOutputReplacements.png",
+                 [
+                     Text("Modify output of any placeholder, including PlaceholderAPI placeholders"),
+                     Text("Replace exact text with another text"),
+                     Text("Change output if it's in a number interval"),
+                     Text("Set value if none of the above is met"),
+                     Text("Use original placeholder's output in new one"),
+                     Text("Support for nested placeholders"),
+                     Text("Can be used in other plugins as well")
+                 ]
+    )
+    create_image("RGB Support", [], "Generated_RGB.png",
+                 [
+                     Text("5 supported RGB patterns"),
+                     Text("3 supported gradient patterns"),
+                     Text("Automatically display closest color to legacy clients"),
+                     Text("Supported in all features where possible")
+                 ]
+    )
+    create_image("High Performance", [], "Generated_HighPerformance.png",
+                 [
+                     Text("Full control of CPU usage by optimizing configuration and disabling unwanted features"),
+                     Text("Fully asynchronous - no impact on TPS"),
+                     Text("Check plugin's CPU usage using /tab cpu"),
+                     Text("Constant improvements to reduce usage"),
+                     Text("Handle thousands of players")
+                 ]
+    )
+    create_image("And more!", [], "Generated_More.png",
+                 [
+                     Text("RedisBungee support for multiple proxies"),
+                     Text("MySQL support to store groups/users"),
+                     Text("Potential errors logged into a file instead of spamming the console"),
+                     Text("Yaml error assistant for more user-friendly messages and fix suggestions"),
+                     Text("Many misconfiguration checks to help solve issues much faster")
+                 ]
+    )
+
+    release = "6.2.1"
+    download_image(f"https://img.shields.io/badge/Release-{release}-blue.svg", "Badge_Release.svg")
+
+    java = "8+"
+    download_image(f"https://img.shields.io/badge/Java-{java}-blue.svg", "Badge_Java.svg")
+
+    download_image(f"https://img.shields.io/badge/GitHub-Source%20code-yellow.svg", "Badge_SourceCode.svg")
+
+    download_image(f"https://img.shields.io/badge/Documentation-Wiki-yellow.svg", "Badge_Documentation.svg")
@@ -14,11 +14,11 @@
 * [Global playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist)
 * [Header/Footer](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Header-&-Footer)
 * [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout)
+* [Multi server support](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Multi-server-support)
 * [Nametags](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Nametags)
 * [Per world playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Per-world-playerlist)
 * [Ping spoof](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Ping-Spoof)
 * [Playerlist objective](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Playerlist-Objective)
-* [RedisBungee support](https://github.com/NEZNAMY/TAB/wiki/Feature-info:-RedisBungee-support)
 * [Scoreboard](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Scoreboard)
 * [Sorting in tablist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Sorting-players-in-tablist)
 * [Spectator fix](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Spectator-fix)
@@ -26,12 +26,12 @@

 ## Functions
 * [Animations](https://github.com/NEZNAMY/TAB/wiki/Animations)
+* [Component usage (RGB, fonts, sprites)](https://github.com/NEZNAMY/TAB/wiki/How-to-use-Minecraft-components)
 * [Conditional placeholders](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders)
 * [Error logging](https://github.com/NEZNAMY/TAB/wiki/Error-logging)
 * [MySQL](https://github.com/NEZNAMY/TAB/wiki/MySQL)
 * [Placeholder output replacements](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Placeholder-output-replacements)
 * [Placeholders](https://github.com/NEZNAMY/TAB/wiki/Placeholders)
-* [RGB/font usage](https://github.com/NEZNAMY/TAB/wiki/How-to-use-RGB-color-codes)

 ## Other
 * [Additional information](https://github.com/NEZNAMY/TAB/wiki/Additional-information)
@@ -11,24 +11,24 @@ This is a collection of random information about the plugin not necessarily limi
 * [Debug config option](#debug-config-option)

 # Vanish detection
-Although TAB does not manage vanishing players in any way,
-it checks vanish status for features to be properly compatible.
+TAB is not a vanish plugin and does not manage vanishing players in any way, therefore, is not responsible for removing vanished players from the tablist.
+However, it checks vanish status for features to be properly compatible.
 At the moment, vanishing detection is used for:
 * `%vanished%` placeholder (used for internal functionality, but can be used to display vanish status if one wants to)
 * `%online%`, `%serveronline%`, `%worldonline%` and `%staffonline%` will not count vanished players
 * [Global playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist) makes vanish plugins unable to remove players on other servers from tablist, vanish check will make TAB remove vanished players.
 * Hide vanished players from [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout).
-* Unregister teams of vanished players to players who cannot see them to prevent third party client exploits from seeing vanished players.
+* [Unregister teams of vanished players](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Nametags#additional-note-6---vanish-hook) to players who cannot see them to prevent third party client exploits from seeing vanished players.

 Permission `tab.seevanished` allows players to:
 * See vanished players in [Global playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist).
 * See vanished players in [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout).
-* Not have teams of vanished players unregistered, which would make them not appear sorted properly and have no nametag prefix/suffix.
+* Not have [teams of vanished players unregistered](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Nametags#additional-note-6---vanish-hook), which would make them not appear sorted properly and have no nametag prefix/suffix.

 For a player to be detected, player has to have `vanished` metadata flag set to `true`.
 Most, (if not all) vanish plugins do this, including, but not limited to CMI,
 Essentials, SuperVanish, PremiumVanish and probably more.
-If TAB is installed on BungeeCord,
+If TAB is installed on proxy,
 [Bridge](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge) must be installed on backend servers
 to forward vanish status to the proxy.

@@ -59,7 +59,7 @@ TAB's objective and team naming:
 # Per-version experience
 Minecraft has changed over the years.
 It had some limits removed, some added, some bugs fixed, but also some bugs added.
-TAB adapts code based on player's version for the best possible experience on each minecraft version.
+TAB adapts code based on player's version for the best possible experience on each Minecraft version.

 ## Detection
 When TAB is installed on a proxy, the proxy's API is used to get player's version.  
@@ -71,10 +71,8 @@ You can check what version the plugin thinks player has by using any of the foll
 * Set `debug: true` in config and check console messages on player join, it will send a message containing game version ViaVersion API has returned

 Player game version detection may fail. Here are a few possible scenarios why:
-* ViaVersion is installed on BungeeCord
-  * And TAB on BungeeCord as well - ViaVersion makes BungeeCord API return version of the backend server player is connected to instead of player's actual version
-  * And TAB is on backend servers - There is no ViaVersion to hook into, therefore, there is no suspicion of player not using server's version and not having a way to verify it
-* ViaVersion API returns `-1` - There is currently no known cause when or why this happens. However, when this happens, TAB prints a console warn notifying this has happened. Plugin will assume player is using the same version as the server in such cases.
+* ViaVersion is installed on proxy and TAB is on backend servers - There is no ViaVersion to hook into, therefore, there is no suspicion of player not using server's version and not having a way to verify it.
+* ViaVersion API returns `-1` - This was an issue in the past and hasn't been reported in years now.

 When a player's game version is not detected correctly, player's experience will be very limited, see below.

@@ -86,7 +84,7 @@ You will not experience all of these, only those that affect the version differe
 | Change of logic                                                                                                                                                                                                                                                                                                               | Negative side effect if version is not detected correctly                                                                                                                                                 |
 |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | Disabling [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) for 1.7 players                                                                                                                                                                                                                                 | [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) entries being sent into the tablist of the player, breaking it as the layout is not designed support 1.7                              |
-| use alternate way of sorting [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) entries for 1.19.3 - 1.21.1 as the optimal sorting way cannot be used                                                                                                                                                        | [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) entries being out of order for 1.19.3 - 1.21.1 <br />Layout entries appearing in chat complete for <1.19.3 even if they don't have to |
+| Use alternate way of sorting [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) entries for 1.19.3 - 1.21.1 as the optimal sorting way cannot be used                                                                                                                                                        | [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) entries being out of order for 1.19.3 - 1.21.1 <br />Layout entries appearing in chat complete for <1.19.3 even if they don't have to |
 | Show 1.9+ bossbar on 1.8 servers for 1.9+ players using ViaVersion API                                                                                                                                                                                                                                                        | No 1.9+ bossbar for 1.9+ players on 1.8 server                                                                                                                                                            |
 | Disabling [Tablist name formatting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Tablist-name-formatting) for 1.7 and lower due to a 16-character limit total to take advantage of the mechanic where nametags are displayed in tablist, which extends the limit to up to 48 characters (16 prefix, 16 name, 16 suffix) | Trying to fit the entire formatting into 16 characters, resulting in massive cutting and nametag feature not working                                                                                      |
 | Play around <1.13 limitations of [Scoreboard](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Scoreboard)                                                                                                                                                                                                                  | Scoreboard lines limited to ~26 characters, even for 1.13+ clients <br />Scoreboard lines limited to 14 characters for < 1.13 clients                                                                     |
@@ -44,6 +44,7 @@ That includes header/footer, prefix/suffix, belowname, playerlist objective, bos
 # Tips & Tricks
 * Animations don't need to be fast. You can use them as a changing text in general.
 * Animations can also be used as a short alias to a long text. You can do this by creating an animation with one frame.
+* Adding to the previous point, animations can be used as a way to wrap a placeholder, having two different identifiers return the same value, allowing to use both original and replaced output from [Placeholder output replacements](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Placeholder-output-replacements).

 # External tools
 If you want an animation too complicated to be done manually, you can check out these websites:
@@ -56,5 +57,5 @@ If you want an animation too complicated to be done manually, you can check out
 All animations start at the same time, which is time of plugin being (re)loaded.
 Thanks to this, all animations with the same number of frames and the same change interval will be synchronized.  
 If you want to synchronize multiple animations with a different change interval and different number of frames,
-you need to make sure `(frame count)*(change interval)` is same for both animations,
-for example one animation with 10 frames and 1000ms and second animation with 2 frames and 5000ms.
+you need to make sure `(frame count)*(change interval)` is same for both animations.
+For example, one animation with 10 frames and 1000ms and second animation with 2 frames and 5000ms.
@@ -5,12 +5,13 @@

 # Detection
 For TAB to properly detect player as a bedrock player, floodgate and TAB must be installed on the same server instance.
-If TAB is installed on bukkit and floodgate is on both bungeecord and bukkit,
+If TAB is installed on backend and floodgate is on both proxy and backend,
 make sure [they are connected](https://geysermc.org/wiki/floodgate/setup/?platform=proxy-servers).

-To make sure floodgate is configured correctly, you have two options:
+To make sure floodgate is configured correctly, you can do any of the following:
 * Set `debug: true` in TAB config and check console output on join/reload. It should say `Floodgate returned bedrock status TRUE for player <player>`.
 * Run `/tab parse <player> %bedrock%`. It should return `true`.
+* Run `/tab dump <player>`, open the link and see `  bedrockPlayer: '<true|false> (floodgate is installed: <true|false>)'`

 If any of them say `false` for an actual bedrock player, you didn't connect floodgate correctly.

@@ -5,10 +5,12 @@
 * [Tablist entry widths](#tablist-entry-widths)

 # About
-This is a collection of mechanics related to the plugin explaining how does the minecraft client process information from the server and what you can and what you cannot impact.
+This is a collection of mechanics related to the plugin explaining how does the Minecraft client process information from the server and what you can and what you cannot impact.

 # Nametag format in tablist
-When disabling [Tablist name formatting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Tablist-name-formatting), nametag prefix/suffix will be displayed in tablist instead. If you don't want any prefixes in tablist, keep the feature enabled but don't set any prefixes. Disabling this option is only useful to allow other plugins to use the feature or to intentionally display teams in tablist.
+Tablist names can be formatted in 2 ways. The main one, designed explicitly for tablist names was added into Minecraft in version 1.8 and can be controlled by TAB's [Tablist name formatting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Tablist-name-formatting) feature.  
+If the feature is disabled or not applied properly (disabled with condition, some deeper compatibility issue ...), nametag prefix/suffix will be displayed in tablist instead. This mechanic is also used for <1.8 players due to 16-character tablist name limit there. You can also do this intentionally, for example for better performance.  
+If you don't want any prefixes in tablist, keep the feature enabled but don't set any prefix / suffix. Disabling this feature is only useful to allow other plugins to use the feature or to intentionally display teams in tablist.

 # Tablist entry overlap
 When having enough online players for 3–4 columns (or using [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout)) and their name formats are too long, they might overlap. This is caused by attempting to display text wider than the monitor can handle.  
@@ -2,28 +2,31 @@
 This page lists all the commands and permissions that are available with TAB.
 Commands have required permissions associated with them.

-**BungeeCord / Velocity users:**
-* If you have TAB installed **on the proxy**, use **/btab** instead of /tab. Permissions are the same.
-* Permission nodes are checked on the server where the plugin is installed (by default). This means that with TAB on BungeeCord, permission nodes are checked on BungeeCord, and therefore you'll need a permission plugin there as well. If you wish to take permission groups and checks from backend servers instead, set `use-bukkit-permissions-manager: true` in config.
+**Users who installed TAB on a proxy server:**
+* Use **/btab** instead of /tab. Permissions are the same.
+* Permission nodes are checked on the server where the plugin is installed (by default). This means that with TAB on proxy, permission nodes are checked on the proxy, and therefore you'll need a permission plugin there as well. If you wish to take permission groups and checks from backend servers instead, set `use-bukkit-permissions-manager: true` in config.
+* Giving yourself OP on the backend server does not give you permissions on the proxy. It's a completely different server. You'll need to give yourself permissions using a permission plugin installed on the proxy (unless you enabled the option above).
+* You are not able to execute proxy commands using a backend plugin (for example some menu plugin). If you want to achieve this, you'll need to find an updated plugin that allows you to send commands to the proxy.

 # Content
 * [Configuration](#configuration-commands)
-  * [/tab \<player/group/playeruuid\> \<name\> \<property\> [value] [options]](#tab-playergroupplayeruuid-name-property-value-options)
+  * [/tab \<player/group/playeruuid\> \<name\> \<property\> \[value\] \[options\]](#tab-playergroupplayeruuid-name-property-value-options)
  * [/tab \<player/group/playeruuid\> \<name\> remove](#tab-playergroupplayeruuid-name-remove)
  * [/tab reload](#tab-reload)
-  * [/tab debug [player]](#tab-debug-player)
+  * [/tab dump \[player\]](#tab-dump-player)
  * [/tab group \<group\>](#tab-group-group)
  * [/tab groups](#tab-groups)
 * [Bossbar](#bossbar)
  * [/tab bossbar send \<name\> \[player\]](#tab-bossbar-show-name-player)
-  * [/tab bossbar [on/off/toggle] [player] [options]](#tab-bossbar-onofftoggle-player-options)
+  * [/tab bossbar \[on/off/toggle\] \[player\] \[options\]](#tab-bossbar-onofftoggle-player-options)
  * [/tab bossbar announce \<name\> \<length\>](#tab-bossbar-announce-name-duration)
 * [Scoreboard](#scoreboard)
  * [/tab scoreboard show \<name\> \[player\]](#tab-scoreboard-show-name-player)
-  * [/tab scoreboard [on/off/toggle] [player] [options]](#tab-scoreboard-onofftoggle-player-options)
+  * [/tab scoreboard \[on/off/toggle\] \[player\] \[options\]](#tab-scoreboard-onofftoggle-player-options)
  * [/tab scoreboard announce \<name\> \<length\>](#tab-scoreboard-announce-name-duration)
 * [Nametags / Teams](#nametags--teams)
-  * [/tab nametag toggle](#tab-nametag-toggle)
+  * [/tab nametag <show/hide/toggle> \[player\] \[viewer\] \[options\]](#tab-nametag-showhidetoggle-player-viewer-options)
+  * [/tab nametag <showview/hideview/toggleview> \[viewer\] \[options\]](#tab-nametag-showviewhideviewtoggleview-viewer-options)
  * [/tab setcollision <player> <true/false>](#tab-setcollision-player-truefalse)
 * [MySQL](#mysql)
  * [/tab mysql upload](#tab-mysql-upload)
@@ -34,7 +37,7 @@ Commands have required permissions associated with them.
 * [Additional permissions](#additional-permissions)

 # Configuration commands
-## /tab \<player/group/playeruuid\> \<name\> \<property\> [value] [options]
+## /tab \<player/group/playeruuid\> \<name\> \<property\> \[value\] \[options\]
 * **Permission:** `tab.change.<property>`
 * **Description:** Changes a property of a group/player to the given value. No value argument will result in that property being deleted.

@@ -62,13 +65,9 @@ Commands have required permissions associated with them.
 * **Permission:** `tab.reload`
 * **Description:** Unloads the plugin, loads configuration files including changes and loads the plugin.

-## /tab debug [player]
-* **Permission:** `tab.debug`
-* **Description:** Shows the server version, plugin version, permission group choice logic, and sorting type. If player argument is filled, shows info about that player:
-  * On BungeeCord, shows whether player is connected to the backend server with [Bridge](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge) plugin or not.
-  * Sorting value & explanation, useful to see what went wrong if players are not sorted correctly.
-  * Primary group set using [How to assign players into groups](https://github.com/NEZNAMY/TAB/wiki/How-to-assign-players-into-groups)
-  * List of all configured properties, their values and source.
+## /tab dump \<player\>
+* **Permission:** `tab.dump`
+* **Description:** Creates a very detailed dump about the specified player to help with troubleshooting, uploads it to a paste site and shows the generated URL.

 ## /tab group \<group\>
 * **Permission:** `tab.groupinfo`
@@ -83,7 +82,7 @@ Commands have required permissions associated with them.
 * **Permission:** `tab.scoreboard.show` for showing to yourself, `tab.scoreboard.show.other` for showing to others.
 * **Description:** Shows the scoreboard with the given `name`, either to yourself if no `player` was given, or to the given `player`.

-## /tab scoreboard [on/off/toggle] [player] [options]
+## /tab scoreboard \[on/off/toggle\] \[player\] \[options\]
 * **Permission:** `tab.scoreboard.toggle` for toggling for yourself, `tab.scoreboard.toggle.other` for toggling for others.
 * **Description:** Shows / hides / toggles scoreboard of specified player. If no player was given, command affects the sender.
 * **Options:**
@@ -98,7 +97,7 @@ Commands have required permissions associated with them.
 * **Permission:** `tab.bossbar.show` for showing to yourself, `tab.bossbar.show.other` for showing to others.
 * **Description:** Shows the bossbar with the given `name`, either to yourself if no `player` was given, or to the given `player`.

-## /tab bossbar [on/off/toggle] [player] [options]
+## /tab bossbar \[on/off/toggle\] \[player\] \[options\]
 * **Permission:** `tab.bossbar.toggle` for toggling for yourself, `tab.bossbar.toggle.other` for toggling for others.
 * **Description:** Shows / hides / toggles bossbar of specified player. If no player was given, command affects the sender.
 * **Options:**
@@ -109,9 +108,17 @@ Commands have required permissions associated with them.
 * **Description:** Shows the bossbar with the given `name` to every player on the server for the given `duration`, in seconds.

 # Nametags / Teams
-## /tab nametag toggle
-* **Permission:** `tab.nametag.toggle`
-* **Description:** Toggles nametag visibility on all players for player who ran the command. Running the command again will make nametags visible again.
+## /tab nametag <show/hide/toggle> \[player\] \[viewer\] \[options\]
+* **Permission:** `tab.nametag.visibility` (`tab.nametag.visibility.other` for toggling for other players)
+* **Description:** Shows / hides / toggles nametag of a specified player. If viewer is specified, view is only affected for the viewer.
+* **Options:**
+  * `-s` for silent toggling (no chat message for affected player)
+
+## /tab nametag <showview/hideview/toggleview> \[viewer\] \[options\]
+* **Permission:** `tab.nametag.view` (`tab.nametag.view.other` for toggling for other players)
+* **Description:** Shows / hides / toggles nametag VIEW of a specified player. When hidden, the viewer will not see anyone's nametags.
+* **Options:**
+  * `-s` for silent toggling (no chat message for affected player)

 ## /tab setcollision \<player\> \<true|false\>
 * **Permission:** `tab.setcollision`
@@ -1,144 +1,110 @@
 # Content
 * [Requirements](#requirements)
+  * [Java](#java)
 * [Supported server software and versions](#supported-server-software-and-versions)
 * [Supported features per platform](#supported-features-per-platform)
-* [Plugin hooks](#plugin-hooks)
-  * [All platforms](#all-platforms)
-  * [Bukkit](#bukkit)
-  * [BungeeCord](#bungeecord)
-  * [Fabric](#fabric)
-  * [Sponge](#sponge)
-  * [Velocity](#velocity)
+* [Plugin / mod hooks](#plugin--mod-hooks)
 * [Compatibility issues](#compatibility-issues)

 # Requirements
-TAB does not depend on any other plugins.  
-It is compiled with Java 8 and therefore supports any version of 8 and above.
+TAB does not depend on any other plugins. The experience can however be enhanced by installing other plugins, see below. There is also no additional Java version requirement. If your server runs on your Java version, TAB will too.

 # Supported server software and versions
-<table>
-    <thead>
-        <tr>
-            <th>Software type</th>
-            <th>Software name</th>
-            <th>Supported versions</th>
-        </tr>
-    </thead>
-    <tbody>
-        <tr>
-            <td rowspan=2>Vanilla</td>
-            <td rowspan=1><a href="https://getbukkit.org/">Bukkit</a> (+forge hybrids)</td>
-            <td>✔ (1.5 - 1.21.4)</td>
-        </tr>
-        <tr>
-            <td rowspan=1><a href="https://www.spongepowered.org/">Sponge</a></td>
-            <td>✔ (1.9<sup>1</sup> - 1.21.4)</td>
-        </tr>
-    </tbody>
-    <tbody>
-        <tr>
-            <td rowspan=2>Modded</td>
-            <td rowspan=1><a href="https://fabricmc.net">Fabric</a></td>
-            <td>✔ (1.14 - 1.21.4)</td>
-        </tr>
-        <tr>
-            <td rowspan=1><a href="https://minecraftforge.net">Forge</a></td>
-            <td>❌</td>
-        </tr>
-    </tbody>
-    <tbody>
-        <tr>
-            <td rowspan=2>Proxies</td>
-            <td rowspan=1><a href="https://ci.md-5.net/job/BungeeCord/">BungeeCord</a></td>
-            <td>✔ (latest only<sup>2</sup>)</td>
-        </tr>
-        <tr>
-            <td rowspan=1><a href="https://www.velocitypowered.com/">Velocity</a></td>
-            <td>✔ (latest only<sup>2</sup>)</td>
-        </tr>
-    </tbody>
-</table>
-<sup>1</sup> Due to a bug in Sponge 7, it cannot coexist in the same jar with classes compiled with Java higher than 8, which is required by some other platforms. To get the plugin to run on Sponge 7, you will need to do one of the following:  
+With the introduction of new Minecraft versions, it is becoming harder and harder to support many versions in the same jar, eventually making it impossible since Minecraft 26.1.  
+**As a general rule, if you want the latest TAB version for your server, please use [Modrinth](https://modrinth.com/plugin/tab-was-taken)'s download filter, where you can select your server software and version and you'll get the latest jar.**

-* Compile the plugin yourself and use the jar from `sponge7/build/libs`, which only contains sponge support instead of the universal jar from `jar/build/libs`.
-* Unzip the plugin jar, go to `me/neznamy/tab/platforms/` and delete everything except `sponge7`.
+Currently, the latest Minecraft version supported by TAB is **26.3**. When new versions come out, TAB is always updated soon after to support them.

-<sup>2</sup> Latest only doesn't mean only the latest build will work,
-it means the plugin was made to be compatible with the latest version/build.
+If your server software and version is reasonably popular and TAB hasn't been backported to that version in a very long time, you may [request a backport](https://github.com/NEZNAMY/TAB/issues/new/choose) (unless backports to that version are no longer offered, see below).  
+Since TAB 6.0.0, Minecraft 1.x started taking hits with each subsequent TAB versions - Bukkit versions started disappearing and **modded platforms no longer offer backports of TAB 6.0.0+ to MC 1.x** (this is because the build scripts had to be massively changed for MC 26+).
+
+The sections below provide **additional** information for each platform.
+
+## Bukkit
+Since TAB 6.0.0, support for unused 1.x versions started disappearing and will continue to disappear with each subsequent Minecraft release.  
+Currently, the latest release supports the following versions:
+* 1.7.10
+* 1.8.8
+* 1.12.2
+* 1.16.5
+* 1.17.1
+* 1.18.2
+* 1.19.4 - 26.3
+
+If you want a jar with support for a 1.x version that is no longer supported, you can use TAB v5.5.0, which supports all MC 1.x versions. For 1.5.2 - 1.6.4, use TAB v5.2.5.
+
+## BungeeCord / Velocity
+For proxies, the plugin is made to work with the latest build.
 Since breaking changes don't happen too often, it means a wide range of versions is usually supported.
 When a breaking change occurs, the plugin is updated to support the new version,
 automatically making old versions incompatible.
 Since proxies support all client versions, there is never a reason to stay outdated,
-so you can always safely update to new version/build of your proxy software if the plugin requires it.
-
-# Supported features per platform
-| Feature \ Platform | Bukkit / Hybrid | Sponge | Fabric | BungeeCord | Velocity |
-| ------------- | ------------- | ------------- | ------------- | ------------- | ------------- |
-| [Belowname](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Belowname) | ✔ | ✔ | ✔ | ✔ | ✔ (via [VSAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/releases)) |
-| [BossBar](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Bossbar) | ✔ | ✔ | ✔ | ✔ | ✔ |
-| [Global Playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist) | ❌ | ❌ | ❌ | ✔ | ✔ |
-| [Header/Footer](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Header-&-Footer) | ✔ | ✔ | ✔ | ✔ | ✔ |
-| [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) | ✔ | ✔ | ✔ | ✔ | ✔ |
-| [Nametags](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Nametags) & [Sorting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Sorting-players-in-tablist) | ✔ |  ❗ | ✔ | ✔ | ✔ (via [VSAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/releases)) |
-| [Per world playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Per-world-playerlist) | ✔ | ❌ | ❌ | ❌ | ❌ |
-| [Playerlist objective](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Playerlist-Objective) | ✔ | ✔ | ✔ | ✔ | ✔ (via [VSAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/releases)) |
-| [Scoreboard](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Scoreboard) | ✔ | ❗ | ✔ | ✔ | ✔ (via [VSAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/releases)) |
-| [Spectator fix](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Spectator-fix) | ✔ | ✔ | ✔ | ✔ | ✔ |
-| [Tablist names](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Tablist-name-formatting) | ✔ | ✔ | ✔ | ✔ | ✔ |
-
-✔ = Fully functional  
- ❗ = NameTags: Anti-override missing, Scoreboard: [compatibility with other plugins](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Scoreboard#compatibility-with-other-plugins) missing.  
-❌ = Completely missing
-
-# Plugin hooks
-To enhance user experience, TAB hooks into other plugins for better experience.
-This set of plugins is different for each platform based on their availability.
-Some are available on all platforms, some only in a few.
-## All platforms
-[**Floodgate**](https://github.com/GeyserMC/Floodgate) - For properly detecting bedrock players to adapt features for the best possible user experience.  
-[**LuckPerms**](https://github.com/LuckPerms/LuckPerms) - Detecting permission groups of players for per-group settings.  
-[**ViaVersion**](https://github.com/ViaVersion/ViaVersion) - For properly detecting player's version to adapt features for the best possible user experience.
-
-## Bukkit
-[**LibsDisguises**](https://github.com/libraryaddict/LibsDisguises) - Detecting disguised players to disable collision to avoid endless push by colliding with own copy created by LibsDisguises.  
-[**PlaceholderAPI**](https://github.com/PlaceholderAPI/PlaceholderAPI) - Allows users to use its placeholders inside TAB.  
-[**PremiumVanish**](https://www.spigotmc.org/resources/14404) - Supporting PremiumVanish's vanishing levels instead of using a basic compatibility system.  
-[**Vault**](https://github.com/milkbowl/Vault) - Detecting permission groups of players for per-group settings.
-
-## BungeeCord
-[**PremiumVanish**](https://www.spigotmc.org/resources/14404) -
-Supporting PremiumVanish's vanishing levels instead of using a basic compatibility system.  
-[**RedisBungee**](https://github.com/ProxioDev/RedisBungee) -
-Communicating with other proxies to properly display visuals on players on another proxy.
+so you can always safely update to a new build of your proxy software if the plugin requires it.

 ## Fabric
-[**fabric-permissions-api**](https://github.com/lucko/fabric-permissions-api) - Supporting permission nodes instead of OP levels.
+Every TAB update only supports the latest Fabric version(s) at the time of release.
+
+Minecraft 1.x - TAB 5.5.0 was backported to 1.20 - 1.21.11 and the jars were uploaded to Modrinth. TAB 5.0.7 supports all Fabric versions from 1.14 to 1.19.4. Backports to 1.x are no longer offered.
+
+## Forge
+Every TAB update only supports the latest Forge version(s) at the time of release.
+
+Minecraft 1.x - TAB 5.5.0 was backported to 1.20 - 1.21.11 and the jars were uploaded to Modrinth, along with a few other random versions people requested. If your version is not available, you may request a backport.
+
+## NeoForge
+Every TAB update only supports the latest NeoForge version(s) at the time of release.
+
+Minecraft 1.x - TAB 5.5.0 was backported to all existing NeoForge versions (1.20.2+) and the jars were uploaded to Modrinth. Backports to 1.x are no longer offered.

 ## Sponge
-*None*
+This platform is no longer supported as no one is using it and it has breaking changes to the API with each Minecraft version. Sponge is supposed to be combined with Forge or NeoForge, both of which TAB supports. You can use Modrinth's download filter to see what is available.

-## Velocity
-[**PremiumVanish**](https://www.spigotmc.org/resources/14404) -
-Supporting PremiumVanish's vanishing levels instead of using a basic compatibility system.  
-[**RedisBungee**](https://github.com/ProxioDev/RedisBungee) -
-Communicating with other proxies to properly display visuals on players on another proxy.  
-[**VelocityScoreboardAPI**](https://github.com/NEZNAMY/VelocityScoreboardAPI) -
-Sending scoreboard packets (scoreboard-teams, belowname-objective, playerlist-objective, scoreboard)
+# Supported features per platform
+| Feature          <sup>Platform</sup>                                                                                                                               | Bukkit / Hybrid | Fabric / Forge / NeoForge | BungeeCord | Velocity                                                                   |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------|---------------------------|------------|----------------------------------------------------------------------------|
+| [Belowname](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Belowname)                                                                                          | ✔               | ✔                         | ✔          | ✔ (via [VSAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/releases)) |
+| [BossBar](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Bossbar)                                                                                              | ✔               | ✔                         | ✔          | ✔                                                                          |
+| [Global Playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist)                                                                          | ✔               | ✔                         | ✔          | ✔                                                                          |
+| [Header/Footer](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Header-&-Footer)                                                                                | ✔               | ✔                         | ✔          | ✔                                                                          |
+| [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout)                                                                                                | ✔               | ✔                         | ✔          | ✔                                                                          |
+| [Nametags](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Nametags) & [Sorting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Sorting-players-in-tablist) | ✔               | ✔                         | ✔          | ✔ (via [VSAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/releases)) |
+| [Per world playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Per-world-playerlist)                                                                    | ✔               | ❌                         | ❌          | ❌                                                                          |
+| [Playerlist objective](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Playerlist-Objective)                                                                    | ✔               | ✔                         | ✔          | ✔ (via [VSAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/releases)) |
+| [Scoreboard](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Scoreboard)                                                                                        | ✔               | ✔                         | ✔          | ✔ (via [VSAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/releases)) |
+| [Spectator fix](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Spectator-fix)                                                                                  | ✔               | ✔                         | ✔          | ✔                                                                          |
+| [Tablist names](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Tablist-name-formatting)                                                                        | ✔               | ✔                         | ✔          | ✔                                                                          |
+
+✔ = Fully functional  
+❌ = Completely missing
+
+# Plugin / mod hooks
+To enhance user experience, TAB hooks into other plugins / mods for better experience.
+This set of plugins / mods is different for each platform based on their availability.
+Some are available on all platforms, some only in a few.
+
+| Platform      | Plugins / mods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| All platforms | [**Floodgate**](https://github.com/GeyserMC/Floodgate) - For properly detecting bedrock players to adapt features for the best possible user experience. <br /> [**LuckPerms**](https://github.com/LuckPerms/LuckPerms) - Detecting permission groups of players for per-group settings. <br />  [**ViaVersion**](https://github.com/ViaVersion/ViaVersion) - For properly detecting player's version to adapt features for the best possible user experience.                                                                                                                                                           |
+| Bukkit        | [**LibsDisguises**](https://github.com/libraryaddict/LibsDisguises) - Detecting disguised players to disable collision to avoid endless push by colliding with own copy created by LibsDisguises. <br />[**PlaceholderAPI**](https://github.com/PlaceholderAPI/PlaceholderAPI) - Allows users to use its placeholders inside TAB. <br />[**PremiumVanish**](https://www.spigotmc.org/resources/14404) - Supporting PremiumVanish's vanishing levels instead of using a basic compatibility system. <br />[**Vault**](https://github.com/milkbowl/Vault) - Detecting permission groups of players for per-group settings. |
+| BungeeCord    | [**PremiumVanish**](https://www.spigotmc.org/resources/14404) - Supporting PremiumVanish's vanishing levels instead of using a basic compatibility system. <br />[**RedisBungee**](https://github.com/ProxioDev/RedisBungee) - Communicating with other proxies to properly display visuals on players on another proxy.                                                                                                                                                                                                                                                                                                 |
+| Fabric        | [**fabric-permissions-api**](https://github.com/lucko/fabric-permissions-api) - Supporting permission nodes instead of OP levels. <br />[**placeholder-api**](https://modrinth.com/mod/placeholder-api) - Displaying placeholders from that mod and offering TAB's placeholders into it.                                                                                                                                                                                                                                                                                                                                 |
+| Forge         | [**LuckPerms**](https://github.com/LuckPerms/LuckPerms) - Permission checks with a string instead of using vanilla OP levels. <br /> [**ForgePlaceholderAPI**](https://github.com/EnvyWare/ForgePlaceholderAPI) - Allows users to use its placeholders inside TAB. <br /> [**Vanishmod**](https://modrinth.com/mod/vanishmod) - Getting player's vanish status.                                                                                                                                                                                                                                                          |
+| NeoForge      | [**LuckPerms**](https://github.com/LuckPerms/LuckPerms) - Permission checks with a string instead of using vanilla OP levels.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| Velocity      | [**PremiumVanish**](https://www.spigotmc.org/resources/14404) - Supporting PremiumVanish's vanishing levels instead of using a basic compatibility system. <br />[**RedisBungee**](https://github.com/ProxioDev/RedisBungee) - Communicating with other proxies to properly display visuals on players on another proxy. <br />[**VelocityScoreboardAPI**](https://github.com/NEZNAMY/VelocityScoreboardAPI) - Sending scoreboard packets (scoreboard-teams, belowname-objective, playerlist-objective, scoreboard)                                                                                                      |

 # Compatibility issues
 * **Glow plugins** will fail to apply glow color correctly. Check [How to make the plugin compatible with glow plugins](https://github.com/NEZNAMY/TAB/wiki/How-to-make-TAB-compatible-with-glow-plugins) for more information.
-* **[Tablisknu](https://forums.skunity.com/resources/tablisknu.727/)** (skript addon) prevents TAB from assigning teams (sorting & nametags).
-* **SkBee** (skript addon) sends empty scoreboard, causing TAB's to not show sometimes.
-* **Waterfall**'s `disable_tab_list_rewrite: true` **may** cause tablist to use offline UUIDs while TAB expects online uuids, causing various problems (most notably tablist formatting not working). Checking for this option is not an option either, because tablist rewrite might still be enabled despite being disabled (don't ask how, I have no idea). Set the option to `false` if you are experiencing issues.
-* **ViaVersion on BungeeCord and TAB on backend** acts like a client-sided protocol hack, making it impossible for TAB to know player's real version and causing issues related to it, see [Per-version experience](https://github.com/NEZNAMY/TAB/wiki/Additional-information#per-version-experience) for more info. Avoid this combination. Either install ViaVersion on all backend servers instead or install TAB on BungeeCord instead.
-* **ViaVersion**'s `hide-scoreboard-numbers` config option makes [Belowname](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Belowname)'s `value` and [Playerlist objective](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Playerlist-Objective)'s `value` not visible for 1.20.3+ clients on <1.20.3 server when enabled. When using this setup, you'll need to keep the option disabled (sadly scoreboard numbers will not be hidden, solving this would require an implementation on ViaVersion's side).
-* **Custom clients / resource packs** - Unofficially modified minecraft clients often tend to break things. Just Lunar client has tons of bugs that can be reproduced with TAB. Resource packs may also contain modifications you are not aware of, making things not look the way you want them to. If you are experiencing any visual issue and are using a custom client or resource pack, try it with a clean vanilla client. If it works there, it's an issue with the client / resource pack and TAB cannot do anything about it.  
+* Some Skript addons may cause features to not work properly, such as sorting and scoreboard.
+* **Waterfall**'s `disable_tab_list_rewrite: true` **may** cause tablist to use offline UUIDs while TAB expects online UUIDs, causing various problems (most notably tablist formatting not working). Checking for this option is not an option either, because tablist rewrite might still be enabled despite being disabled (don't ask how, I have no idea). Set the option to `false` if you are experiencing issues.
+* **ViaVersion on proxy and TAB on backend** acts like a client-sided protocol hack, making it impossible for TAB to know player's real version and causing issues related to it, see [Per-version experience](https://github.com/NEZNAMY/TAB/wiki/Additional-information#per-version-experience) for more info. Avoid this combination. Either install ViaVersion on all backend servers instead or install TAB on the proxy as well.
+* **Nexo**'s `hide_scoreboard_numbers` config option (may apply to ItemsAdder and Oraxen as well) makes [Belowname](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Belowname)'s and [Playerlist objective](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Playerlist-Objective)'s `value` and `fancy-value` not visible. When using these features, you'll need to keep the option disabled.
+* **Custom clients / resource packs** - Unofficially modified Minecraft clients often tend to break things. Just Lunar client has tons of bugs that can be reproduced with TAB. Resource packs may also contain modifications you are not aware of, making things not look the way you want them to. If you are experiencing any visual issue and are using a custom client or resource pack, try it with a clean vanilla client. If it works there, it's an issue with the client / resource pack and TAB cannot do anything about it.  
  For example, here are a few bugs in LunarClient / FeatherClient that you may run into when using TAB:
  * They add their icon to players in tablist, but don't widen the entries. This results in player names overlapping with latency bar. You can avoid this by configuring some spaces in tabsuffix.
  * They don't support color field in chat components, which means they don't support RGB codes and will display bossbar without colors as well.
-  * Bossbar is not visible on 1.8.
  * Rendering belowname 3 times.
  * They don't respect nametag visibility rule, showing their own nametag using F5 even if set to invisible by the plugin.
  * When the scoreboard is set to use all 0s, lines are rendered in opposite order on 1.20.3+.
  * They don't display 1.20.3+ NumberFormat feature in scoreboard objectives.
-* **Random Spigot/BungeeCord forks** - All safe patches for improving security & performance are present in well-known public opensource projects, such as Paper, Purpur or Waterfall. Using a random overpriced closed-source (and probably obfuscated) fork from BuiltByBit may not be safe, since they likely include unsafe patches that may break compatibility with plugins in an attempt to fix things that are not broken. Before spending your entire budget on such a fork, reconsider it first. Paper (and its forks) is a performance-oriented fork used by 2/3 of all MC servers worldwide, while the rest is still stuck on Spigot. It is highly unlikely your needs are so specific you need every single "improvement" anyone can come up with. If you need a feature, Purpur is a feature-oriented fork. Together with plugins you should achieve what you are looking for.
+* **XCord** - Has additional amazing optimizations that prevent TAB from being able to read outgoing packets and modify them if needed, resulting in some features not working properly, such as [tablist name formatting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Tablist-name-formatting).
+* **Random Spigot/BungeeCord forks** - All safe patches for improving security & performance are present in well-known public open-source projects, such as Paper, Purpur or Waterfall. Using a random overpriced closed-source (and probably obfuscated) fork from BuiltByBit may not be safe, since they likely include unsafe patches that may break compatibility with plugins in an attempt to fix things that are not broken. Before spending your entire budget on such a fork, reconsider it first. Paper (and its forks) is a performance-oriented fork used by 2/3 of all MC servers worldwide, while the rest is still stuck on Spigot. It is highly unlikely your needs are so specific you need every single "improvement" anyone can come up with. If you need a feature, Purpur is a feature-oriented fork. Together with plugins you should achieve what you are looking for.
@@ -1,4 +1,5 @@
 # Page content
+* [About](#about)
 * [Adding the dependency](#adding-the-dependency)
 * [Getting started](#getting-started)
 * [Lifespan of API calls](#lifespan-of-api-calls)
@@ -13,22 +14,31 @@
 * [Tablist name formatting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Tablist-name-formatting#api)
 * [Placeholders](https://github.com/NEZNAMY/TAB/wiki/Placeholders#api)

+# About
+This page explains how to import TAB's API into your project and together with other pages everything you can do with it.
+
+Before starting, please seriously reconsider if you really need this and cannot already achieve it using existing features (such as registering placeholders into PlaceholderAPI instead of TAB, using display conditions for scoreboards, ...). If not, consider making a request.
+
 # Adding the dependency

 For Maven users, you can add the API dependency like this:

 ```xml
-<repository>
-    <id>jitpack.io</id>
-    <url>https://jitpack.io</url>
-</repository>
+<repositories>
+    <repository>
+        <id>jitpack.io</id>
+        <url>https://jitpack.io</url>
+    </repository>
+</repositories>

-<dependency>
-    <groupId>com.github.NEZNAMY</groupId>
-    <artifactId>TAB-API</artifactId>
-    <version>5.0.5</version>
-    <scope>provided</scope>
-</dependency>
+<dependencies>
+    <dependency>
+        <groupId>com.github.NEZNAMY</groupId>
+        <artifactId>TAB-API</artifactId>
+        <version>6.1.2</version>
+        <scope>provided</scope>
+    </dependency>
+</dependencies>
 ```

 Or, for Gradle users, here are a few examples:
@@ -40,7 +50,7 @@ repositories {
 }

 dependencies {
-    compileOnly 'com.github.NEZNAMY:TAB-API:5.0.5'
+    compileOnly 'com.github.NEZNAMY:TAB-API:6.1.2'
 }
 ```

@@ -51,15 +61,18 @@ repositories {
 }

 dependencies {
-    compileOnly("com.github.NEZNAMY", "TAB-API", "5.0.5")
+    compileOnly("com.github.NEZNAMY", "TAB-API", "6.1.2")
 }
 ```

-**WARNING: DO NOT SHADE THE API IN TO YOUR JAR! DO NOT RELOCATE THE API FROM ITS ORIGINAL PACKAGE!**
-
-If you relocate, the API that you are calling will also get relocated in your code, meaning that you will be trying to call the relocated API. If you shade the API in, your code could load that bundled API, causing class path conflicts.
+> [!WARNING]
+> DO NOT SHADE THE API IN TO YOUR JAR! DO NOT RELOCATE THE API FROM ITS ORIGINAL PACKAGE!**
+> If you relocate, the API that you are calling will also get relocated in your code, meaning that you will be trying to call the relocated API. If you shade the API in, your code could load that bundled API, causing class path conflicts.
 Ensure that you are using **`<scope>provided</scope>` for Maven**, or **`compileOnly` for Gradle**.

+> [!WARNING]
+> If you are on Paper and your plugin is defined as a paper plugin (paper-plugin.yml), TAB's classes may not be visible to the class loader that loaded your plugin. To avoid this issue, do not use paper-plugin.yml in your plugin, just plugin.yml.
+
 # Getting started
 First, you need to get an instance of the API.
 You can do this with `TabAPI.getInstance()`.  
@@ -1,51 +1,93 @@
 # Content
 * [About](#about)
 * [Configuration](#configuration)
+* ~Commands~
+* ~Placeholders~
+* [Limitations](#limitations)
+* [Compatibility with other plugins](#compatibility-with-other-plugins)
 * [Additional info](#additional-info)
  * [Additional note 1 - Copying nametag visibility rule](#additional-note-1---copying-nametag-visibility-rule)
-  * [Additional note 2 - Hidden on sneak on 1.8](#additional-note-2---hidden-on-sneak-on-18)
-  * [Additional note 3 - Visible on NPCs](#additional-note-3---visible-on-npcs)
-* [Tips & Tricks](#tips--tricks)
-  * [Tip 1 - Heart symbol](#tip-1---heart-symbol)
-  * [Tip 2 - Displaying health as 0-10 or in %](#tip-2---displaying-health-as-0-10-or-in-)
-* [Limitations](#limitations)
+  * [Additional note 2 - [1.8.x] Hidden on sneak](#additional-note-2---18x-hidden-on-sneak)
+  * [Additional note 3 - [26.1.2-] Visible on NPCs](#additional-note-3---2612--visible-on-npcs)
+    * [[26.1.x] Visible on all entities](#261x-visible-on-all-entities)
+  * [Additional note 4 - Compatibility with modified clients](#additional-note-4---compatibility-with-modified-clients)
+* [Troubleshooting](#troubleshooting)
+* ~API~
 * [Examples](#examples)
  * [Example 1 - Per-world values](#example-1---per-world-values)
  * [Example 2 - Hiding `title` for 1.20.3+ players](#example-2---hiding-title-for-1203-players)
+  * [Example 3 - Displaying health as 0-10 or in %](#example-3---displaying-health-as-0-10-or-in-)
+  * [Example 4 - Health bar using hearts](#example-4---health-bar-using-hearts)
+  * [Example 5 - Conditionally hiding belowname for 26.2+ viewers](#example-5---conditionally-hiding-belowname-for-262-viewers)
+* [Tips & Tricks](#tips--tricks)
+  * [Tip 1 - Heart symbol](#tip-1---heart-symbol)

 # About
-The scoreboard objective with BELOW_NAME display slot that adds another line of text below nametag of players.
-It is only visible on players within 8-block range.
-This value is client sided and cannot be changed by the plugin.  
+This features gives you control over Minecraft's scoreboard objective feature with BELOW_NAME slot.  
+On Minecraft 1.21.11 and below, it is visible on all player entities (including NPCs). On 26.1.x, it is visible on all player entities and all named entities (such as holograms), making this feature unusable. On 26.2 and above, it only appears on entities with a score assigned (the ideal implementation).  
+It is only visible when the target player is within a 10-block range of the viewer (the value is configurable since Minecraft 26.1).
+
+Example visual effect:  
 ![](https://images-ext-1.discordapp.net/external/YlGPCRDJVeZZI0TPWmVBKyHszxSkjatmclyqUThvTz8/https/image.prntscr.com/image/jcETUzVQQYqectQ2aI4iqQ.png)

-This line automatically appears on all player entities when enabled. **Therefore, it is not possible to only display it on some players or not display it on NPCs**.
+The displayed line is not one continuous configurable text. It consists of 2 parts (score and title) joined with a space.  
+The exact format is `[score]` + space + `title` (no, the space cannot be removed), where `[score]` is:
+* `value` for 1.20.2- (will show `0` on NPCs), which only supports numbers (integers)
+* `fancy-value` for 1.20.3+ (will show `fancy-value-default` on NPCs), which supports any text

-The feature can be configured in **config.yml** under **belowname-objective** section.
-
-The feature's properties are displayed as `[score]` + space + `title` (no, the space cannot be removed), where `[score]` is:
-* `value` for 1.20.2- (will show `0` on NPCs)
-* `fancy-value` for 1.20.3+ (will show `fancy-value-default` on NPCs)
+As you can see, the feature still has limits, even on 1.20.3+. If you are below this version or still don't like the forced space before title, you are out of luck and cannot use this feature the way you would like to. If you have seen this feature seemingly limitless, it could be a feature that was a part of TAB, but removed later. This feature hid the original nametag and placed invisible armor stands instead. If you are interested in this kind of solution, you'll need to look into other plugins.

 # Configuration
-| Option name         | Default value         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-|---------------------|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| enabled             | true                  | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| value               | %health%              | [1.20.2-] An integer from -2147483648 to 2147483647, doesn't support decimal values. The number is always white. Supports placeholders with player-specific output, such as player health. Only visible on 1.20.2 and lower. <br/> **Note**: Even if you only support 1.20.3+, you still need to configure this value to properly evaluate to a number, because the value is still sent to the client (just not displayed). You can set it to `0` for simplicity.                                                              |
-| fancy-value         | &c%health%            | [1.20.3+] Any text, supports placeholders with per-player output. Only visible on 1.20.3+.                                                                                                                                                                                                                                                                                                                                                                                                                                     |
-| fancy-value-default | NPC                   | [1.20.3+] Default display for all player entities. Plugin uses the value above for every real player, therefore this default value will only appear on player entities which are not actual players, a.k.a. NPCs. Only visible on 1.20.3+.                                                                                                                                                                                                                                                                                     |
-| title               | Health                | Text displayed after `value`. It is formally called scoreboard title, which is displayed on all player entities and value is shared on all players and therefore not bound to specific players, which makes it unable to display the value per-player. It should only contain static text or placeholders which return same value for all players. All inserted placeholders are parsed for the player viewing the text. This is intentional to allow advanced configuration with conditions for per-world values for example. |
-| disable-condition   | %world%=disabledworld | A [condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for disabling the feature for players. Set to empty for not disabling the feature ever.                                                                                                                                                                                                                                                                                                                            |
+The feature can be configured in **config.yml** under **belowname-objective** section.  
+This is how the default configuration looks:
+```
+belowname-objective:
+  enabled: false
+  value: "%health%"
+  title: "&cHealth"
+  fancy-value: "&c%health%"
+  fancy-value-default: "NPC"
+  disable-condition: '%world%=disabledworld'
+```
+All the options are explained in the following table.
+
+| Option name         | Default value         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+|---------------------|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| enabled             | true                  | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| value               | %health%              | [1.20.2-] An integer from -2147483648 to 2147483647, doesn't support decimal values. The number is always white. Supports placeholders with player-specific output, such as player health. Only visible on 1.20.2 and lower. <br/> **Note**: Even if you only support 1.20.3+, you still need to configure this value to properly evaluate to a number, because the value is still sent to the client (just not displayed). You can set it to `0` for simplicity.                                                                                                                                                                          |
+| fancy-value         | &c%health%            | [1.20.3+] Any text, supports placeholders with per-player output. Only visible on 1.20.3+, where it completely replaces `value`. When evaluates to an empty string, the entire belowname is hidden for viewers using MC 26.2+ (when it was made possible).                                                                                                                                                                                                                                                                                                                                                                                 |
+| fancy-value-default | NPC                   | [1.20.3 - 26.1.2] Default number format (`fancy-value`) for all player entities. `fancy-value` is displayed on every real player, therefore this default value will only appear on player entities which are not actual players, a.k.a. NPCs. Only visible on since 1.20.3 (the function did not exist prior) until 26.1.2 (player entities without scores no longer display any belowname since 26.2).                                                                                                                                                                                                                                    |
+| title               | Health                | Shared label shown after the score for every player entity. Player sees the same text on everyone (= placeholders are parsed for the viewer). Use the `value`/`fancy-value` fields for per‑player data; use `title` only for static labels like `Health` or placeholders which are supposed to be parsed for the viewing player.                                                                                                                                                                                                                                                                                                           |
+| disable-condition   | %world%=disabledworld | A [condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) (either name of a condition or a conditional expression) that must be met for disabling the feature for players. Set to empty for not disabling the feature ever. <br/> **Note**: Disabling the feature for a player means sending objective unregister packet to them, which results in player not seeing belowname on anyone anymore. It doesn't work the other way around - you cannot disable this feature on target players, only for viewers (at least not until 26.2+, in which case see `fancy-value` description to see how to do it). |
+| view-distance       | 10                    | [26.1+] How close (in blocks) to a player one must be to see their belowname. This value is configurable since Minecraft 26.1, so this option won't work on older versions.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+
+# Limitations
+* [1.12.2-] Title length is limited to 32 characters (including color codes).
+* [1.20.2-] `value` is limited to a white number.
+* [Bedrock] Doesn't support 1.20.3+ features (`fancy-value`), `value` will be displayed instead, just like on <1.20.3.
+* The format is a **[score] + space + shared title**. No, the space cannot be removed.
+* The title is the same on all players, therefore, it cannot be personalized (such as player's faction). Only [score] can be per-player.
+* It appears on all entities of player type. **This includes player NPCs.**
+
+# Compatibility with other plugins
+TAB does not contain any sort of compatibility functionality for this feature.
+It will not try to prevent other plugins from applying the feature and neither will it detect it to re-add back once the other plugin removes it.
+Therefore, if another plugin also sends belowname objective, TAB's may not show anymore (depending on who sends it first).
+Make sure you do not have any other plugin sending it to ensure the feature works properly.
+
+You can check the list of objectives registered by either commands or plugins using Bukkit API using `/scoreboard objectives list`.  
+If it contains one that could be the cause, you can unregister it by running `/scoreboard objectives remove <name>`. After doing so, reload TAB, so it resends its objectives again.  
+Note that if this was automatically generated by a plugin, it will probably be added back again.

 # Additional Info
 ## Additional note 1 - Copying nametag visibility rule
-The minecraft feature is programmed to be affected by nametag visibility rule.
+The Minecraft feature is programmed to be affected by nametag visibility rule.
 This means that when the nametag is set to invisible, belowname will be invisible as well.

-## Additional note 2 - Hidden on sneak on 1.8
+## Additional note 2 - [1.8.x] Hidden on sneak
 Belowname is not visible on 1.8.x clients when player is sneaking. This is client-sided behavior and cannot be changed by the server.

-## Additional note 3 - Visible on NPCs
+## Additional note 3 - [26.1.2-] Visible on NPCs
 Belowname objective is automatically attached to all entities of player type with the default value of
 `0` (<1.20.3) or value configured as `fancy-value-default` (1.20.3+).
 This includes player NPCs.
@@ -60,28 +102,45 @@ This is how you can achieve it using the following popular NPC plugins:
  * 1 - Select the NPC (`/npc select <ID>` or `/npc select` to select the nearest NPC)
  * 2 - Hide its original nametag (which also hides belowname) using `/npc name`
  * 3 - Display your desired text using `/npc hologram add <text>` ([more info](https://wiki.citizensnpcs.co/Commands#:~:text=the%20NPC%20hitbox-,/npc%20hologram,-add%20%5Btext%5D%20%7C%20set))
+* **FancyNpcs with FancyHolograms**:
+  * 1 - Create a hologram with `/hologram create text <name>`.
+  * 2 - Link your newly created hologram with your NPC: `/hologram edit <hologram name> linkWithNpc <NPC name>`.  
+    Its original name will be hidden automatically, so you don't need to manually do it.
+  * 3 - Change the NPC's name by editing your hologram's line(s): `/hologram edit hi setline 1 <text>`.  
+    You can also add more lines if you want. See [FancyNpcs's wiki](https://docs.fancyinnovations.com/fancyholograms/commands/hologram/#text-hologram-modification) for more commands & info.

-# Tips & Tricks
-## Tip 1 - Heart symbol
-If you want to show health of players and display a heart symbol as text, you can use this one: `❤`.
+### [26.1.x] Visible on all entities
+In Minecraft version 26.1, Mojang "fixed" [MC-99647](https://bugs.mojang.com/browse/MC/issues/MC-99647), which reported that belowname is not visible on non-player entities. As a result, the belowname is now visible on all entities with a custom name (this even includes invisible armor stands, holograms and more). A new bug report was made for this: [MC-307012](https://bugs.mojang.com/browse/MC/issues/MC-307012).
+
+**This is a client-sided bug. You will experience it on 26.1.x regardless of the server version**.  
+If your server is on 26.1.x, or you support players with this version through ViaVersion, this might be a dealbreaker for you. If that's the case, either disable this feature entirely, or set
 ```
 belowname-objective:
-  title: "&4❤"
+  disable-condition: "%player-version-id%=775"
 ```
-> [!IMPORTANT]
-> Make sure your config is saved in UTF-8 encoding to properly read the heart symbol.
+which will make 26.1.x players not see this feature on anyone (remember: disabling this feature disables it for the viewer, not target players).  
+**This bug was fixed in Minecraft version 26.2.**

-## Tip 2 - Displaying health as 0-10 or in %
-If you want health to display health as 0-10 instead of 0-20, you can achieve it with PlaceholderAPI:
-* `%math_0_{player_health}/2%` for 0-10
-* `%math_0_{player_health}*5%` for 0-100
+## Additional note 4 - Compatibility with modified clients
+Sadly, this feature is suffering from bugs introduced by third party clients such as Feather and Lunar. These two completely ignore `fancy-value` as if it was never added into the game, even on 1.20.3+. This is just an example, and it's not limited to these two clients and this one issue. If you experience issues with the feature and believe you configured it correctly, use vanilla client to make sure it's not caused by a broken client.

-# Limitations
-* [1.5 - 1.12.2] Title length is limited to 32 characters (including color codes).
-* [1.5 - 1.20.2] `value` is limited to a white number.
-* The format is a **[score] + space + shared title**. No, the space cannot be removed.
-* The title is the same on all players, therefore, it cannot be personalized (such as player's faction). Only [score] can be per-player.
-* It appears on all entities of player type. **This includes player NPCs.**
+# Troubleshooting
+This is a collection of tips to help you figure out why the feature isn't working as you expect.  
+To get started, run `/tab dump <any player>` (this feature doesn't contain per-player content in dump output) and open the generated link. Scroll down to `features` -> `BelowName` and check the content:
+* If it says `BelowName: Feature is disabled`, it means you disabled the feature. Enable it by setting
+  ```
+  belowname-objective:
+    enabled: true
+  ```
+* Check the `configuration` section and compare it with your config file. If it's different, you either forgot to reload TAB, or uploaded the config to the wrong server (or did not upload it at all).
+* If a player cannot see belowname on anyone, check the table of players and make sure it's not because `Disabled with condition` is `true`.
+* Check the table of players for `value`, `fancy-value` and `title` and make sure they match your expectations. Don't forget `value` only supports numbers.
+* If you want to see `fancy-value` instead of just `value`'s number:
+  * Make sure your client is on 1.20.3+.
+  * Make sure your server is on 1.20.3+ (using TAB on proxy counts as being latest).
+  * Make sure you are not using a 3rd party client that removed this feature from 1.20.3+, such as Lunar or Feather.
+* Keep in mind `title` parses for viewer and is visible on all other players, it does not parse for each target player. Do not use placeholders with strictly per-player results in `title`.
+* If you have TAB on Velocity, install [VelocityScoreboardAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/releases) (and make sure it is not outdated).

 # Examples
 ## Example 1 - Per-world values
@@ -121,9 +180,8 @@ create two condition chains, one for each value and use them.

 > [!NOTE]
 > This is just an example, the plugin is not limited to displaying different values only per world.
-> If you want per server values on BungeeCord, use %server% with server names.
-> If you want WorldGuard regions, use %worldguard_region_name% with region names.
-> This works for any placeholder offered by the plugin or by PlaceholderAPI.
+> If you want per server values on proxy, use %server% with server names.
+> This works for any placeholder offered by TAB or by PlaceholderAPI.

 ## Example 2 - Hiding `title` for 1.20.3+ players
 1.20.3 has replaced `value` field,
@@ -158,4 +216,50 @@ belowname-objective:
 Unfortunately, due to the limitations of this feature,
 there is a forced space between `value`/`fancy-value` and `title`,
 even if the `title` is empty.
-You'll either need to live with it, or put some shared text there to avoid having a space at the end.  
+You'll either need to live with it, or put some shared text there to avoid having a space at the end.
+
+## Example 3 - Displaying health as 0-10 or in %
+If you want health to display health as 0-10 instead of 0-20, you can achieve it with PlaceholderAPI:
+* `%math_0_{player_health}/2%` for 0-10
+* `%math_0_{player_health}*5%` for 0-100
+
+## Example 4 - Health bar using hearts
+You can achieve this on `1.20.3+` using `healthbar` expansion from PlaceholderAPI:
+```
+belowname-objective:
+  fancy-value: "%healthbar_healthbar%"
+  title: ""
+```
+<img width="130" height="159" alt="image" src="https://github.com/user-attachments/assets/cef217ec-0a39-41ad-8457-f8f67a1e4b02" />  
+
+Sadly, there is no way to remove the forced space between `fancy-value` and `title`. You can only try to play around it by adding some static text after it, to make it look like the space is intended. Or you can just ignore the space and live with it.
+
+# Tips & Tricks
+## Tip 1 - Heart symbol
+If you want to show health of players and display a heart symbol instead of text saying "Health", you can use this one: `❤`.
+```
+belowname-objective:
+  title: "&4❤"
+```
+> [!IMPORTANT]
+> Make sure your config is [saved in UTF-8 encoding](https://github.com/NEZNAMY/TAB/wiki/How-to-save-the-config-in-UTF8-encoding) to properly read the heart symbol.
+
+## Example 5 - Conditionally hiding belowname for 26.2+ viewers
+Since Minecraft 26.2, belowname only appears on entities with a score. This can be used to disable the belowname on players with a condition. We are trying to achieve a condition like this: "If something, hide belowname for 26.2+ viewers".  
+TAB is made to reset score (= hide belowname) of target players for 26.2+ viewers (<26.2 viewers are not affected, resetting scores for them would result in `fancy-value-default` to be shown, which is undesirable) if `fancy-value` evaluated to an empty string. Therefore, we will need to make a [relational condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders#relational-conditions) that checks the viewer's version and returns empty string if some condition is met.  
+Here is an example of hiding it if target player has less than 10 health (5 hearts):
+```
+conditions:
+  belowname-health:
+    conditions:
+      - "%viewer:player-version-id%>=776"  # 26.2 uses 776, check for viewer's version, not target player's
+      - "%health%<10"  # This should check target player's health
+    type: AND
+    true: ""  # Viewer is on 26.2+ and target has less than 10 health, return empty string to hide it
+    false: "%health%"  # Display health as normal
+```
+Then, use this condition as a relational condition (because it checks both viewer and target players):
+```
+belowname-objective:
+  fancy-value: "%rel_condition:belowname-health%"
+```
@@ -1,134 +1,137 @@
 # Content
 * [About](#about)
 * [Configuration](#configuration)
-    * [Defining bossbars](#defining-bossbars)
-        * [style](#style)
-        * [color](#color)
-        * [progress](#progress)
-        * [text](#text)
-        * [announcement-bar](#announcement-bar)
-        * [display-condition](#display-condition)
-    * [Announce command](#announce-command)
-    * [Additional settings](#additional-settings)
+* [Commands](#commands)
+* [Placeholders](#placeholders)
 * [Limitations](#limitations)
+* [Compatibility with other plugins](#compatibility-with-other-plugins)
 * [Additional info](#additional-info)
-    * [Additional note 1 - Hiding bar itself](#additional-note-1---hiding-bar-itself)
-    * [Additional note 2 - Not hiding on server switch](#additional-note-2---not-hiding-on-server-switch)
+  * [Additional note 1 - Hiding bar itself](#additional-note-1---hiding-bar-itself)
+* [Troubleshooting](#troubleshooting)
 * [API](#api)
-* [Tips & Tricks](#tips--tricks)
-    * [Tip 1 - Animated bossbar color](#tip-1---animated-bossbar-color)
-    * [Tip 2 - Switching between bossbars with condition](#tip-2---switching-between-bossbars-with-condition)
+* [Examples](#examples)
+  * [Example 1 - Changing text](#example-1---changing-text)
+  * [Example 2 - Switching between bossbars with condition](#example-2---switching-between-bossbars-with-condition)
+  * [Example 3 - Periodical appearing and disappearing](#example-3---periodical-appearing-and-disappearing)
+  * [Example 4 - Dynamic progress tracking a relative placeholder value](#example-4---dynamic-progress-tracking-a-relative-placeholder-value)

 # About
-![](https://images-ext-2.discordapp.net/external/0H5v5gcK12jm-O_kljlx-iYdJ1Q3wBsY_Dch7Jr_aAk/https/image.prntscr.com/image/x4VewIuiRwO-XLGTvDxfWw.png)  
-Bars with text on top of the screen originally designed to display the health of ender dragon & wither,
-but plugins found another use for it.
-In 1.9, mojang added a packet
-dedicated to displaying text without requiring an entity and allowing customizable color and style as well.
-TAB only supports this new functionality, and the feature does not support 1.8 and lower.
-
-This feature can be configured in **config.yml** under **bossbar** section.
+This feature allows you to send modern bossbars to players, which appear on top of the screen.
+Only works on Minecraft 1.9 and up.
+Supporting 1.8 and lower would require an entity to be spawned (wither / dragon), which TAB no longer offers.  
+![](https://images-ext-2.discordapp.net/external/0H5v5gcK12jm-O_kljlx-iYdJ1Q3wBsY_Dch7Jr_aAk/https/image.prntscr.com/image/x4VewIuiRwO-XLGTvDxfWw.png)

 # Configuration
-## Defining bossbars
+The feature can be configured in **config.yml** under **bossbar** section.
+This is how the default configuration looks:
 ```
 bossbar:
+  enabled: false
+  toggle-command: /bossbar
+  remember-toggle-choice: false
+  hidden-by-default: false
  bars:
-    MyBossbar:
-      style: "PROGRESS"
-      color: "%animation:barcolors%"
-      progress: "100"
+    ServerInfo:
+      style: "PROGRESS" # for 1.9+: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20
+      color: "%animation:barcolors%" # for 1.9+: BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
+      progress: "100" # in %
      text: "&fWebsite: &bwww.domain.com"
 ```
-Every bossbar line has 4 properties:
+All the options are explained in the following table.

-### style
-Type of bossbar division.  
-You can choose from 5 styles: **PROGRESS**, **NOTCHED_6**, **NOTCHED_10**, **NOTCHED_12** and **NOTCHED_20**  
-![](https://images-ext-1.discordapp.net/external/yMuJNksnulOd_ZtI3yGw6CaQhon-ewVHsqaMzT8RcGk/https/image.prntscr.com/image/FzWSvsalTW6YVRPPK3oa9g.png)  
-These were defined by mojang, no other options are available. Other plugins may be using different names, but it's the same result in the end.
+| Option name            | Default value | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+|------------------------|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| enabled                | false         | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| toggle-command         | /bossbar      | A command to toggle bossbar visibility for player running the command. This command requires `tab.bossbar.toggle` permission. <br />**Note:** Commands are not supposed to be registered / unregistered dynamically at runtime. As such, you may run into small issues when changing the toggle command and reloading. After you modify the command to your liking, reconnect to properly see it in tabcomplete. If you don't use TAB on a proxy, consider restarting the server as well for the old command to actually be unregistered. |
+| remember-toggle-choice | false         | When enabled, disabling bossbar using `toggle-command` is remembered between reloads and restarts.                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| hidden-by-default      | false         | When enabled, bossbar will automatically be hidden until toggle command is used.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| bars                   | *Map*         | Map of defined bossbars, see below for more information.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |


-### color
-Color of bossbar.  
-You can choose from 7 colors: **BLUE**, **GREEN**, **PINK**, **PURPLE**, **RED**, **WHITE** and **YELLOW**  
-![](https://images-ext-2.discordapp.net/external/MwNGvtNT0vspb_xiGUyx_WQNayvSmb8h0Sk4W7Vxfoc/https/image.prntscr.com/image/fM7kq5XIRCiTN5n-ffpNyA.png)  
-These were defined by mojang, no other options are available.
+Bossbars can be defined in `bars` section. Bossbar name can be anything, but you cannot use the same name for 2 bossbars.  
+A bossbar consists of up to 6 properties:

+| Option            | Example         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+|-------------------|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| style             | PROGRESS        | Type of bossbar division. You can choose from 5 styles: **PROGRESS**, **NOTCHED_6**, **NOTCHED_10**, **NOTCHED_12** and **NOTCHED_20**. <br /> ![](https://images-ext-1.discordapp.net/external/yMuJNksnulOd_ZtI3yGw6CaQhon-ewVHsqaMzT8RcGk/https/image.prntscr.com/image/FzWSvsalTW6YVRPPK3oa9g.png) <br /> These were defined by mojang, no other options are available. Other plugins may be using different names, but it's the same result in the end. |
+| color             | BLUE            | Color of bossbar. You can choose from 7 colors: **BLUE**, **GREEN**, **PINK**, **PURPLE**, **RED**, **WHITE** and **YELLOW**. <br /> ![](https://images-ext-2.discordapp.net/external/MwNGvtNT0vspb_xiGUyx_WQNayvSmb8h0Sk4W7Vxfoc/https/image.prntscr.com/image/fM7kq5XIRCiTN5n-ffpNyA.png) <br /> These were defined by mojang, no other options are available.                                                                                            |
+| progress          | 100             | A number between 0 and 100. Accepts decimals. <br /> ![image](https://user-images.githubusercontent.com/6338394/196031770-2208848c-8e38-44cc-aa49-c86427160cab.png)                                                                                                                                                                                                                                                                                         |
+| text              | "Hi"            | Text of the bossbar. Length is not limited, supports RGB codes on 1.16+. Does not support newlines.                                                                                                                                                                                                                                                                                                                                                         |
+| announcement-bar  | false           | When set to `true`, the bossbar will not appear by default, only when used in announce command.                                                                                                                                                                                                                                                                                                                                                             |
+| display-condition | "%world%=world" | [Condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for player to see the bossbar. Even when using announce command on a bossbar with display condition, players must meet it to see the bossbar. When condition is not defined, bossbar has no requirement to be displayed.                                                                                                                          |

-### progress
-A number from 0 to 100. Accepts decimals.  
-![image](https://user-images.githubusercontent.com/6338394/196031770-2208848c-8e38-44cc-aa49-c86427160cab.png)  
-If you want to show the progress of a placeholder's value relative to a maximum one, you can use the [Math Expansion](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#math) from PlaceholderAPI and use a placeholder like this one: `%math_{placeholder_current_value}/{placeholder_max_value}*100%` or `%math_{placeholder_current_value}/<max_value>*100%` if your max value is fixed.
-
-> [!NOTE]
-> Replace the text in between the `{}` with the actual placeholder you want to use and `<max_value>` with a valid number
-(i.e., 20).  
-You cannot use the `%placeholder%` format inside the math placeholder.
-
-Example for showing a player's health: `%math_{player_health}/20*100%` or `%math_{player_health}/{player_max_health}*100%`
-
-### text
-Text of the bossbar. Length is not limited, supports RGB codes on 1.16+. Does not support newlines.
-
-### announcement-bar
-When set to true, the bossbar will not appear by default, only when used in announce command.
+Here is an example using all 6 properties:
 ```
-bossbar:
  bars:
-    MyBossbar:
-      style: "PROGRESS"
-      color: "BLUE"
+    ServerInfo:
+      style: "PROGRESS" 
+      color: "PURPLE"
      progress: "100"
-      text: "Text"
-      announcement-bar: true #false or undefined means it will be visible all the time
-```
-### display-condition
-[Condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for player to see the bossbar. Even when using announce command on a bossbar with display condition, players must meet it to see the bossbar. When condition is not defined, bossbar has no requirement to be displayed.  
-**Example**:
-```
-bossbar:
-  bars:
-    MyBossbar:
-      style: "PROGRESS"
-      color: "BLUE"
-      progress: "100"
-      text: "This bossbar is only visible in world 'world'"
-      display-condition: "%world%=world"
+      text: "Welcome to the nether!"
+      announcement-bar: false
+      display-condition: "%world%=world_nether"
 ```

-## Announce command
-`/tab bossbar announce <name> <time>`  
-`name` is name of bossbar defined in config.yml under **bossbar** section, `time` is length of display time in seconds.
+# Commands
+| Command                                               | Permission                                                                         | Description                                                                                                                                                                                   |
+|-------------------------------------------------------|------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| /tab bossbar show \<name\> \[player\]                 | `tab.bossbar.show` (for yourself) <br /> `tab.bossbar.show.other` (for others)     | Shows the bossbar with the given `name`, either to yourself if no `player` was given, or to the given `player`.                                                                               |
+| /tab bossbar \[on/off/toggle\] \[player\] \[options\] | `tab.bossbar.toggle` (for yourself) <br /> `tab.bossbar.toggle.other` (for others) | Shows / hides / toggles bossbar of specified player. If no player was given, command affects the sender. You can use `-s` as option for silent toggling (no chat message for affected player) |
+| /tab bossbar announce \<name\> \<duration\>           | `tab.announce.bar`                                                                 | Shows the bossbar with the given `name` to every player on the server for the given `duration`, in seconds.                                                                                   |

-When using a bossbar announcement, you have a new placeholder available:
-`%countdown%` that shows remaining time of the announcement in seconds.
-You can further use this placeholder in progress, for example,
-using Math expansion from PlaceholderAPI, such as `%math_{tab_placeholder_countdown}/<total time>*100%`.
+# Placeholders
+Here are TAB's internal placeholders you can use when this feature is enabled:
+| Placeholder | Description |
+|-------------|-------------|
+| `%bossbar_announce_time_left_<bossbar>%` | Returns remaining time of the announcement of specified bossbar (in seconds). |
+| `%bossbar_announce_time_total_<bossbar>%` | Returns total time of the announcement of specified bossbar (in seconds) (the inputted number). |

-## Additional settings
-| Option name            | Default value | Description                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-|------------------------|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| enabled                | false         | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                              |
-| toggle-command         | /bossbar      | A command to toggle bossbar visibility for player running the command. This command requires `tab.bossbar.toggle` permission. <br />**Note:** This command will not appear in command auto-complete, because it's not a real registered command. Registered commands must be defined in plugin jar directly and cannot be dynamic. If you want to solve this, you can try getting a dummy private plugin made which registers that command. |
-| remember-toggle-choice | false         | When enabled, disabling bossbar using `toggle-command` is remembered between reloads and restarts.                                                                                                                                                                                                                                                                                                                                          |
-| hidden-by-default      | false         | When enabled, bossbar will automatically be hidden until toggle command is used.                                                                                                                                                                                                                                                                                                                                                            |
+You can further use these placeholders in progress, for example, using Math expansion from PlaceholderAPI, such as `%math_{tab_placeholder_bossbar_announce_time_left_<bossbar>}/{tab_placeholder_bossbar_announce_time_total_<bossbar>}*100%` (remember to replace `<bossbar>` with the actual name of the bossbar).
+
+Here are TAB's PlaceholderAPI placeholders you can use when this feature is enabled:
+| Placeholder | Description |
+|-------------|-------------|
+| `%tab_bossbar_visible%` | "Enabled" if visible (not toggled with a command), "Disabled" if not (toggled with a command) |

 # Limitations
 * Does not support newlines. If you want to display more lines, you'll need to create multiple bossbars.
-* The bar itself cannot be removed from the server side. However, it can be removed with a resource pack.
+* The bar itself cannot be removed from the server side. However, it can be removed with a resource pack (see below for more info).
+* While there is no explicit limit to how many bossbars you can configure, the client will only display up to 9 depending on window size and GUI scale in client settings.
+
+# Compatibility with other plugins
+Bossbar is a feature that can have multiple instances sent and displayed, so there is no possible conflict like in scoreboard for example. Every plugin manages its own bossbars and doesn't care about others.
+
+One thing to mention is the order of bossbars. They are ordered by the order they were received. This means the final order depends on which plugin is faster (or slower), which is something you can't really control. As such, there is no feasible way to control the order of bossbars across different plugins. TAB's own bossbars are sent in the order they are defined in the configuration, so that won't be a problem.

 # Additional info
 ## Additional note 1 - Hiding bar itself
 If you want to hide the bossbar itself and only show text, this is possible, but not from the plugin's side.
-You'll need to create a custom resource pack where the bar is invisible.
-Then, you need to force your players to get the resource pack.
+You'll need to create a custom resource pack where the bar is invisible and force your players to get the resource pack.
+Here is how to do it:  
+**Minecraft 1.20+**:
+* Navigate to `assets/minecraft/textures/gui/sprites/boss_bar`. You will need to create 2 files. In this example, we will use `WHITE` Bossbar color.
+* Use GIMP or any other photo editing software and create a **1x1 px** image, that is fully transparent.
+* Name the file **white_progress.png**. Now copy-paste the same file and name it **white_background.png**.
+
+**Minecraft 1.19.4-**:
+* Navigate to `assets/minecraft/textures/gui/`. You will need to download the default `bars.png` file (https://github.com/Faithful-Pack/Default-Java/blob/1.19.4/assets/minecraft/textures/gui/bars.png).
+* Use GIMP or any other Photo editing software and remove the White bars in the file. Save the file and move it to `assets/minecraft/textures/gui/`.
+
+Finally, set your Bossbar color in TAB Config to `WHITE`. Now the line will be invisible!
+
+# Troubleshooting
+This is a collection of tips to help you figure out why the feature isn't working as you expect.  
+To get started, run `/tab dump <affected player>` and open the generated link. Scroll down to `features` -> `BossBar` and check the content:
+* If it says `BossBar: Feature is disabled`, it means you disabled the feature. Enable it by setting
+  ```
+  bossbar:
+    enabled: true
+  ```
+* Check the `configuration` section and compare it with your config file. If it's different, you either forgot to reload TAB, or uploaded the config to the wrong server (or did not upload it at all).
+* Check the `bossbar conditions` section and for each bossbar and analyze the `display-condition` options (the value, with placeholders parsed, whether it is met or not) if it matches what you expect. If not, you may have made a mistake in your conditions.
+* Check `bossbars visible` value to make sure user did not toggle the bossbar(s).
+* Check `currently displayed bossbars` section and compare it with your expectations, as well as the actual in-game result. If it doesn't match your expectations, you didn't configure something correctly. If the output doesn't match the in-game result, it might be a bug.

-## Additional note 2 - Not hiding on server switch
-When under a proxy network and having TAB installed on backend server and switching to another server,
-the bossbar will not hide.
-This is because BungeeCord makes it look like a world switch to the client.
-To avoid this, the only way is to install TAB on BungeeCord and disable bossbar on that server.

 # API
 *To get started with the API, see [Developer API](https://github.com/NEZNAMY/TAB/wiki/Developer-API) page.*
@@ -173,30 +176,32 @@ Methods in `BossBar`:
 * `BossBar#containsPlayer(TabPlayer)` - Returns `true` if player can see this bossbar, `false` if not.
 * `BossBar#isAnnouncementBar()` - Returns `true` if this bossbar is defined as announcement bar in config, `false` if visible permanently.

-# Tips & Tricks
-## Tip 1 - Animated bossbar color
-You can animate the color of a bossbar using [animations](https://github.com/NEZNAMY/TAB/wiki/Animations).  
+# Examples
+## Example 1 - Changing text
+You can make the change text periodically using [animations](https://github.com/NEZNAMY/TAB/wiki/Animations).  
 First, create an animation in **animations.yml**, such as
 ```
-BossColor:
+BossBarText:
  change-interval: 1000
  texts:
-    - "BLUE"
-    - "YELLOW"
+    - "Text1"
+    - "Text2"
 ```
 Then, use the animation in bossbar configuration
 ```
  bars:
    ServerInfo:
      style: "PROGRESS"
-      color: "%animation:BossColor%"
+      color: "PURPLE"
      progress: "100"
-      text: "&fWebsite: &bwww.domain.com"
+      text: "%animation:BossBarText%"
 ```
-This bossbar will change color every second between blue and yellow colors.  
-You can do the same with progress, style and text as well.
+This bossbar will change text every second between `text1` and `text2`. You can make the change interval higher and add more texts to suit your needs.

-## Tip 2 - Switching between bossbars with condition
+> [!NOTE]
+> This works for style, color and progress as well, not just text. Just make sure the animation returns a valid value accepted by the field (listed enum constants for style and color, number between 0 and 100 for progress).
+
+## Example 2 - Switching between bossbars with condition
 If you want the plugin to switch between bossbars based on a condition, first consider using condition for text itself
 (or some other property).
 If this is not an option (you want text, color, style and progress to be different, which would result in 4 conditions),
@@ -218,4 +223,39 @@ For number comparisons, negate `<` using `>=` and so on.
      progress: "0"
      text: "&cYou took damage"
      display-condition: "%health%!=20"
-```
+```
+
+## Example 3 - Periodical appearing and disappearing
+This can be achieved using [animations](https://github.com/NEZNAMY/TAB/wiki/Animations) and [conditions](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders). We will create an animation with 2 frames and check if it's on the first one, then display the bossbar. Otherwise, don't display it.  
+To get started, create an animation in **animations.yml**:
+```
+animations:
+  bossbar-toggle:
+    change-interval: 10000
+    texts:
+      - "ON"
+      - "OFF"
+```
+Then, create a display condition that checks if the animation is on the first frame (`ON`):
+```
+  bars:
+    ServerInfo:
+      display-condition: "%animation:bossbar-toggle%=ON" # Check for the first frame of the animation
+      style: "PROGRESS"
+      color: "PURPLE"
+      progress: "100"
+      text: "&fWebsite: &bwww.domain.com"
+```
+Now, the bossbar will appear and disappear every 10 seconds.
+
+## Example 4 - Dynamic progress tracking a relative placeholder value
+If you want to show the progress of a placeholder's value relative to a maximum one, you can use the [Math Expansion](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#math) from PlaceholderAPI and use a placeholder like this one: `%math_{placeholder_current_value}/{placeholder_max_value}*100%` or `%math_{placeholder_current_value}/<max_value>*100%` if your max value is fixed.
+
+> [!NOTE]
+> Replace the text in between the `{}` with the actual placeholder you want to use and `<max_value>` with a valid number (i.e., 20).
+
+You cannot use the `%placeholder%` format inside the math placeholder.
+Example for showing a player's health:  
+`progress: "%math_{player_health}/20*100%"`  
+or  
+`progress: "%math_{player_health}/{player_max_health}*100%"` 
@@ -1,172 +1,175 @@
 # Content
 * [About](#about)
 * [Condition types](#condition-types)
-  * [Number comparations](#number-comparations)
+  * [Number comparisons](#number-comparisons)
  * [Text operations](#text-operations)
  * [Permission](#permission)
-* [Multiple condition requirements](#multiple-condition-requirements)
-* [Condition output](#condition-output)
-* [Configuration](#configuration)
 * [Usage](#usage)
-  * [Displaying text](#displaying-text)
-  * [Display condition of a feature](#display-condition-of-a-feature)
-    * [Short format](#short-format)
+  * [Conditional text](#conditional-text)
+  * [Using in a field where condition is expected](#using-in-a-field-where-condition-is-expected)
+  * [Using in a field where condition is expected (short format)](#using-in-a-field-where-condition-is-expected-short-format)
+  * [Relational conditions](#relational-conditions)
 * [Refresh interval](#refresh-interval)
+* [Additional info](#additional-info)
+  * [Additional note 1 - Choosing the correct AND / OR type](#additional-note-1---choosing-the-correct-and--or-type)
 * [Examples](#examples)
  * [Example 1 - Chaining conditional placeholders](#example-1---chaining-conditional-placeholders)
-  * [Example 2 - Conditions in conditions](#example-2---conditions-in-conditions)
+  * [Example 2 - Combining AND and OR](#example-2---combining-and-and-or)
+  * [Example 3 - Showing vanish status only for staff members](#example-3---showing-vanish-status-only-for-staff-members)

 # About
 Conditions / conditional placeholders allow you
 to create output which depends on the output of other placeholders or permission requirement.  
 They have 2 main uses in the plugin:
-* Display condition which must be met to be able to see something (bossbar, scoreboard, layout)
-* Conditional placeholders which return defined outputs in both cases if the condition passes or fails
+* `display-condition` which must be met to be able to see something (bossbar, scoreboard, layout) or `disable-condition` for disabling a feature (scoreboard-teams, tablist-name-formatting, ...)
+* Conditional placeholders which return defined outputs based on if the condition passes or fails

 # Condition types
-## Number comparations
-`>=`: greater than or equal to  
-Example: `%ping%>=100` will pass if the player's ping is greater than or equal to `100`.
-
-`>`: greater than   
-Example: `%ping%>100` will pass if the player's ping is greater than `100`.
-
-`<=`: less than or equal to  
-Example: `%ping%<=100` will pass if the player's ping is less than or equal to `100`.
-
-`<`: less than  
-Example: `%ping%<100` will pass if the player's ping is less than `100`.
+## Number comparisons
+| Operation | Description              | Example                                                                        |
+|-----------|--------------------------|--------------------------------------------------------------------------------|
+| `>=`      | Greater than or equal to | `%ping%>=100` will pass if the player's ping is greater than or equal to `100` |
+| `>`       | Greater than             | `%ping%>100` will pass if the player's ping is greater than `100`              |
+| `<=`      | Less than or equal to    | `%ping%<=100` will pass if the player's ping is less than or equal to `100`    |
+| `<`       | Less than                | `%ping%<100` will pass if the player's ping is less than `100`                 |

 ## Text operations
-`=`: equal to (must match exactly)  
-Example: `%world%=world` will pass if player is in world `world`.
+| Operation | Description                                                                  | Example                                                                                                               |
+|-----------|------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------|
+| `=`       | Equal to                                                                     | `%world%=world` will pass if player is in world `world`                                                               |
+| `!=`      | Not equal to                                                                 | `%world%!=world` will pass if player is in any world except `world`                                                   |
+| `<-`      | Contains (left side for full text, right side text to contain)               | `%world%<-lobby-` will pass if player is in any world that contains `lobby-` (such as `lobby-1` etc.)                 |
+| `!<-`     | Not Contains (left side for full text, right side text to not contain)       | `%world%!<-lobby-` will pass if player is in any world that does not contain `lobby-` (such as `lobby-1` etc.)        |
+| `\|-`     | Starts with (left side for full text, right side text to start with)         | `%world%\|-lobby-` will pass if player is in any world that starts with `lobby-` (such as `lobby-1` etc.)             |
+| `!\|-`    | Not Starts with (left side for full text, right side text to not start with) | `%world%!\|-lobby-` will pass if player is in any world that does not start with `lobby-` (such as `lobby-1` etc.)    |
+| `-\|`     | Ends with (left side for full text, right side text to end with)             | `%world%-\|nether` will pass if player is in any world that ends with `nether` (such as `world_nether` etc.)          |
+| `!-\|`    | Not Ends with (left side for full text, right side text to not end with)     | `%world%!-\|nether` will pass if player is in any world that does not end with `nether` (such as `world_nether` etc.) |

-`!=`: not equal to (opposite of the above)  
-Example: `%world%!=world` will pass if player is in any world except `world`.
+> [!NOTE]
+> For `=` and `!=` you can check for empty output of a placeholder using `%my_placeholder%=` and `%my_placeholder%!=`.

-**Note 1**: For `=` and `!=` you can check for empty output of a placeholder using `%my_placeholder%=` and `%my_placeholder%!=`.
-
-`<-`: contains (left side for full text, right side text to contain)  
-Example: `%world%<-lobby-` will pass if player is in any world that contains `lobby-` (such as `lobby-1` etc.).
-
-`|-`: starts with (left side for full text, right side text to start with)  
-Example: `%world%|-lobby-` will pass if player is in any world that starts with `lobby-` (such as `lobby-1` etc.).
-
-`-|`: ends with (left side for full text, right side text to end with)  
-Example: `%world%-|nether` will pass if player is in any world that ends with `nether` (such as `world_nether` etc.).
-
-**Note 2**: For string operators, the text must match placeholder's output exactly, including color codes.
+> [!NOTE]
+> For string operations, the text must match placeholder's output exactly, including color codes, as well as lower/UPPER case letters.
 If you are using [Placeholder output replacements](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Placeholder-output-replacements),
 condition must contain the altered output.  
 To see the exact output of a placeholder including color codes, use `/tab parse <player> <placeholder>`.

 ## Permission
-`permission:<value>`: permission requirement  
-Example: `permission:my.permission` will pass if player has `my.permission` permission.
+> [!WARNING]
+> Giving someone OP status will automatically give them all permissions, which will make all the permission checks in conditions pass.

-# Multiple condition requirements
-Each condition has a `conditions` parameter, which a list of conditions. If you define more than 1 condition, you must specify the condition type.  
-This value can be found under `type` field. Types are:
-* `AND` - all sub-conditions must be met for the final condition to pass
-* `OR` - at least one sub-condition must be met for the final condition to pass
-
-If you only defined one subcondition, you don't need to define the type at all, since it's not used for anything.
-
-# Condition output
-If using condition as a placeholder, you can specify output in both cases using `yes` and `no` values. `yes` is used when condition passes, `no` if not. If using condition only as a view requirement, you can leave these values empty / not specify them at all.
-
-# Configuration
-Open **config.yml** and find this section:
-```
-conditions:
-  health:
-    conditions:
-    - '%health%<21'
-    - '%health%>15'
-    type: AND
-    yes: Healthy!
-    no: Damaged!
-```
-`health` is name of our condition in this case.  
-`conditions` is a list of subconditions that must be met for this condition to pass.  
-`type` defines whether all subconditions must be met or at least one.  
-`yes` & `no` define output in both cases.
+| Operation             | Description                     | Example                                                                                      |
+|-----------------------|---------------------------------|----------------------------------------------------------------------------------------------|
+| `permission:<value>`  | Permission requirement          | `permission:my.permission` will pass if player has `my.permission` permission                |
+| `!permission:<value>` | Negative permission requirement | `!permission:my.permission` will pass if player **does not have** `my.permission` permission |

 # Usage
-You have 2 ways to use conditions.
+There are multiple different ways you can use conditions, all of which are described below.

-## Displaying text
-The first way is to use conditions to display text.
-Configure outputs in `yes` and `no` values and then use `%condition:<name>%`,
-which will output text defined in `yes` or `no` depending on if condition is met or not.
-<details>
-  <summary>Example</summary>
+## Conditional text
+This way allows you to create conditional text that depends on other placeholders.

+First, find the `conditions` section in your config and create a new condition like this one:
 ```
 conditions:
-  serverName:
+  lobby:
    conditions:
-      - "%server%=lobby"
-    yes: "You are in the lobby"
-    no: "You are not in lobby"
+    - '%server%=lobby'
+    true: "You are in lobby"
+    false: "You are not in lobby"
 ```
+This condition checks if player is in server `lobby` and if yes, displays `"You are in lobby"`, otherwise displays `"Your are not in lobby"`.  
+To check for more than just 1 condition, add more to the list. Additionally, you will now need to specify `type`, which is either `AND` or `OR`.

-Use with `%condition:serverName%`
-</details>
-
-## Display condition of a feature
-The second way is to use condition's name in places where a condition is accepted.
-This includes display conditions for bossbar, scoreboard and layout.
-In these cases, yes/no texts are unused; therefore, they do not need to be defined.
-<details>
-  <summary>Example</summary>
-
+For example,
 ```
 conditions:
-  MyCondition:
+  lobby:
    conditions:
-      - "permission:tab.admin"
+    - '%server%=lobby'
+    - '%server%=lobby2'
+    type: OR
+    true: "You are in lobby"
+    false: "You are not in lobby"
 ```
+will return the lobby text if player is in server `lobby` **OR** in server `lobby2`. If you want both of those conditions to be required to display text, use `type: AND`.  
+It is not possible to combine both `AND` and `OR` in a single condition. To do that, create multiple conditions and use one inside another (see Example 2 below).
+
+Now that the condition is created, we can use it using `%condition:lobby%`. This placeholder will return the texts configured in `true` and `false` values based on whether the condition was met or not.
+
+## Using in a field where condition is expected
+A lot of the features support either `display-condition` or `disable-condition`. The value configured is expected to be a condition. Let's say we want to use it as a display condition somewhere, for example when player is in server `lobby`. First, create the condition:
 ```
-scoreboards:
-  MyScoreboard:
-    display-condition: MyCondition
+conditions:
+  lobby:
+    conditions:
+    - '%server%=lobby'
 ```
+As you can see, `true` and `false` were not configured. This is because we are not trying to display any text, we are passing the condition as an object to evaluate.  
+Then, use `display-condition: lobby` in the feature. This will evaluate the condition named `lobby` and either display or not display the visual based on player's server. To check for 2 servers, use
+```
+conditions:
+  lobby:
+    conditions:
+    - '%server%=lobby'
+    - '%server%=lobby2'
+    type: OR
+```
+Now, the condition `lobby` will pass if player is in server `lobby` **OR** in server `lobby2`. To require both of the conditions to be met instead of at least 1, use `type: AND`.  
+It is not possible to combine both `AND` and `OR` in a single condition. To do that, create multiple conditions and use one inside another (see Example 2 below).

-In this example, scoreboard will only be displayed to players with `tab.admin` permission.
-</details>
+## Using in a field where condition is expected (short format)
+When using condition as a `display-condition` or `disable-condition`, you don't need to specify `true` / `false` texts. In fact, you only need the list of conditions and separator (AND / OR).  
+For this purpose, short format was created. Instead of having to create a condition and using it, you can specify the expression directly.

-### Short format
-If trying to use a condition on place where it's available (bossbar display condition, scoreboard display condition) where you don't need the yes/no values, you can use a short format instead.
-
-This can be used by simply creating all subconditions and separating them with `;` for `AND` condition type. For `OR` type, use `|`.
-<details>
-  <summary>Example</summary>
-
-Single condition:
+**Single condition example**:
 ```
 display-condition: "%server%=lobby"
 ```

-Multiple conditions, all of them must be met:
+**Multiple conditions, all of them must be met**:
 ```
 display-condition: "%server%=lobby;%world%=world"
 ```

-Multiple conditions, at least one of them must be met:
+**Multiple conditions, at least one of them must be met**:
 ```
 display-condition: "%server%=lobby|%server%=lobby2"
 ```
+It is not possible to combine both `AND` (`;`) and `OR` (`|`) in a single condition. To do that, create multiple conditions and use one inside another (see Example 2 below).

-</details>
+## Relational conditions
+> [!NOTE]
+> This section only describes differences from standard conditions. For more information about those, see sections above.
+
+Relational conditions allow you to check placeholder outputs for the player who is looking instead of only the target player.
+
+To make placeholder check for viewer instead of the target player, use `%viewer:<placeholder>%` instead of just `%placeholder%`.  
+You can still check for target player using `%placeholder%` or `%target:<placeholder>%` (if you want to make it more clear for the reader).  
+Example: `%viewer:server%=%server%` will pass if viewer is in the same server as the target player.
+
+There are 2 ways to use it:
+* display-condition of layout player groups (which is currently the only feature supporting it as it would not make sense elsewhere)
+* A placeholder using `%rel_condition:<condition>%` syntax
+
+Using `%viewer:...%` will upgrade the condition to a relational condition and standard version will no longer be available.  
+If trying to use relational condition in `%condition:name%` syntax, it will return a warning text instead of evaluating the condition.  
+Same the other way around - if trying to use standard condition in `%rel_condition:name%` syntax, it will return a warning text.

 # Refresh interval
 Conditions are just placeholders after all, and, as such, they must be refreshed periodically.
 Refresh intervals of conditions are not directly configurable.
-They are based on placeholders used inside (subconditions, yes/no values).  
+They are based on placeholders used inside (subconditions, true/false values).  
 Permission checks count as 1000ms.  
 To configure refresh intervals of placeholders,
-check out the [Optimization guide](https://github.com/NEZNAMY/TAB/wiki/Optimizing-the-plugin#2---placeholder-refresh-intervals).
+check out the [Optimization guide](https://github.com/NEZNAMY/TAB/wiki/Optimizing-the-plugin#2---all-platforms-placeholder-refresh-intervals).
+
+# Additional Info
+## Additional note 1 - Choosing the correct AND / OR type
+Sometimes you want to combine multiple expressions using `AND` or `OR`. When doing this, you must pick the correct one based on your needs.  
+A common mistake is trying to turn spoken language directly into config, which can be wrong.
+
+For example, you say you want to display scoreboard in servers `server1` **and** `server2`. As such, you may accidentally use `type: AND` or `;` in short format (`%server%=server1;%server%=server2`). This is, however, wrong, because that would mean your server must be `server1` **and** `server2` at the same time, which is obviously impossible. The correct type is `OR` here (`|`). So instead of thinking "I want to display scoreboard in `server1` **and** `server2`", you should think "I want to display scoreboard if player is in `server1` **or** `server2`.

 # Examples
 ## Example 1 - Chaining conditional placeholders
@@ -196,9 +199,8 @@ conditions:
 Finally, we can use this ping placeholder using `%condition:ping%`.  
 This example chained 2 conditions, but more can be used. There is no limit.

-# Example 2 - Conditions in conditions
-If you want to use a condition in another one,
-for example, to use both "AND" and "OR" types, create 2 conditions and use one in the other one.  
+## Example 2 - Combining AND and OR
+If you want to combine both "AND" and "OR" types, create 2 conditions and use first one in the second one.  
 For example, if we want to check that player is in server `lobby` **and** in worlds **either** `world1` or `world2`,
 it can be achieved in the following way:
 ```
@@ -214,4 +216,27 @@ conditions:
      - "%server%=lobby"
    type: AND
 ```
-Then, use condition `main` as the display condition. Note that `yes`/`no` values were not defined, as such, they default to `true` and `false`, respectively. Therefore, we use the placeholder from the condition and check if the result is `true`. Then, check if player is also in the specified server.  
+Then, use condition `main` as the display condition (or as a placeholder - `%condition:main%`). Note that `true`/`false` values were not defined, as such, they default to `true` and `false`, respectively. Therefore, we use the placeholder from the condition and check if the result is `true`. Then, check if player is also in the specified server.
+
+## Example 3 - Showing vanish status only for staff members
+This example shows you how to show some text on vanished players, but only available to see to staff members. For that, we will use a relational condition.  
+We want to create a condition that checks for 2 things - target player is vanished and the viewer has permission. If both of them are met (`AND`), some text should display. Otherwise, nothing should display.  
+Let's build the individual components of the condition:
+* Vanish placeholder - in this example, we will use `%essentials_vanished%`. The placeholder returns `yes` if player is vanished, otherwise `no`. If you configured [placeholder output replacements](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Placeholder-output-replacements) for the vanish placeholder, you will either need to use the replaced output, or remove the replacement (since you aren't going to use the placeholder directly anyway). To check what exactly a placeholder returns, you can run `/tab parse <player> <placeholder>`.
+* Staff check - for the lack of a better idea, let's name our permission `my.permission`. The important part is that we want to check this permission for the player who is looking at the tablist, not the target player who is vanished. Following the guide on relational placeholders, we will use `%viewer:player_has_permission_my.permission%`. We need to compare it to the "true" value, (typically `yes`), just like with vanish placeholder. See above for more info.
+* true / false texts - The `true` value will be set to the value to show if target player is vanished and viewer has the permission. `false` value will be displayed otherwise. This will probably remain empty.
+
+After combining all of this, here is what the condition may look like:
+```
+conditions:
+  vanish:
+    conditions:
+      - '%viewer:player_has_permission_my.permission%=yes'
+      - '%essentials_vanished%=yes'
+    type: AND
+    true: ' &7&l[V]&r'
+    false: ''
+```
+You may replace the leading space in `true` value with a trailing one based on your needs. Afterwards, use the placeholder using `%rel_condition:vanish%` in `tabprefix` / `tabsuffix` for example.
+
+The usefulness of this example is questionable, but the purpose of examples is to teach afterall, not to just be copied over to your config (I know you have been doing that!). This one is, however, useful, because unvanishing will result in TAB instantly formatting the player name before placeholders are periodically updated, which would otherwise result in a small flash of vanished text visible for everyone for a split second after unvanishing.
@@ -2,24 +2,53 @@
 * [About](#about)
 * [Configuration](#configuration)
  * [Grouping players only from certain servers](#grouping-players-only-from-certain-servers)
+    * [Pattern Matching](#pattern-matching)
  * [Configuring isolated servers](#configuring-isolated-servers)
  * [Seeing all players on the network from some server](#seeing-all-players-on-the-network-from-some-server)
-* [Compatibility with vanish plugins](#compatibility-with-vanish-plugins)
+* ~Commands~
+* [Placeholders](#placeholders)
+* ~Limitations~
+* [Compatibility with other plugins](#compatibility-with-other-plugins)
+* ~Additional Info~
+* [Troubleshooting](#troubleshooting)
+* ~API~
+* ~Examples~

 # About
-This feature allows you to see players from other servers under a bungeecord network, instead of only seeing players on the same server.  
-To use this feature, you need [TAB installed on bungeecord](https://github.com/NEZNAMY/TAB/wiki/Installation#bungeecord). This option is not available on bukkit and will not be added.
+This feature allows you to see players from different servers, instead of only seeing players on the same server. The typical use is to show players under the whole proxy network.  
+If TAB is installed on a backend server, you'll need to set up [Multi server support](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Multi-server-support) to properly make the servers communicate. On proxy installation, this is not needed, unless you have multiple proxies.

 # Configuration
-| Option name                            | Default value | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-|----------------------------------------|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| enabled                                | false         | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| server-groups                          | *Map*         | See [Grouping players only from certain servers](#grouping-players-only-from-certain-servers)                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| spy-servers                            | *List*        | See [Seeing all players on the network from some server](#seeing-all-players-on-the-network-from-some-server)                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| display-others-as-spectators           | false         | When enabled, players on different servers will appear as having spectator gamemode in tablist.                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| display-vanished-players-as-spectators | true          | When enabled, vanished players will show as in spectator gamemode for those, who have permission to see vanished players (tab.seevanished) (others will obviously not see them at all). Vanished players will still see themselves in the gamemode they are actually in, since changing that would cause problems (client would think it's in spectator gamemode while it isn't).                                                                                                                                                      |
-| isolate-unlisted-servers               | false         | When enabled, servers not listed in any group will not share playerlist with any other server, instead of sharing it with other unlisted servers.                                                                                                                                                                                                                                                                                                                                                                                      |
-| update-latency                         | false         | When **enabled**, plugin will send ping update to players on other servers, since backend servers only send ping updates of players on the same server. This is displayed as the green bar in tablist, unless altered by a mod / resource pack (?). <br /> <br />When **disabled**, ping of players on other servers will be set to 0 (5 bars).  <br /> <br />Disabled by default, because it's not only not very useful, but also has a very high CPU usage to due spamming a large amount of packets (especially on large networks). |
+The feature can be configured in **config.yml** under **global-playerlist** section.  
+This is how the default configuration looks:
+```
+global-playerlist:
+  enabled: false
+  display-others-as-spectators: false
+  display-vanished-players-as-spectators: true
+  isolate-unlisted-servers: false
+  update-latency: false
+  spy-servers:
+    - spyserver1
+    - spyserver2
+  server-groups:
+    lobbies:
+      - lobby1
+      - lobby2
+    group2:
+      - server1
+      - server2
+```
+All of the options are explained in the following table.  
+| Option name                            | Default value | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+|----------------------------------------|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| enabled                                | false         | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| display-others-as-spectators           | false         | When enabled, players on different servers will appear as having spectator gamemode in tablist.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| display-vanished-players-as-spectators | true          | When enabled, vanished players will show as in spectator gamemode for those, who have permission to see vanished players (tab.seevanished) (others will obviously not see them at all). Vanished players will still see themselves in the gamemode they are actually in, since changing that would cause problems (client would think it's in spectator gamemode while it isn't).                                                                                                                                                                                                                                                                |
+| isolate-unlisted-servers               | false         | When enabled, servers not listed in any group will not share playerlist with any other server, instead of sharing it with other unlisted servers.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| update-latency                         | false         | When **enabled**, plugin will send ping update to players on other servers, since backend servers only send ping updates of players on the same server. This is displayed as the green bar in tablist, unless altered by a mod / resource pack (?). <br /> <br />When **disabled**, ping of players on other servers will be set to `0` (![image](https://user-images.githubusercontent.com/6338394/179717531-3c6409b6-6bf8-41c1-a150-ce0ed615e5a5.png)).  <br /> <br />Disabled by default, because it's not only not very useful, but also has a very high CPU usage to due spamming a large amount of packets (especially on large networks). |
+| spy-servers                            | *List*        | See [Seeing all players on the network from some server](#seeing-all-players-on-the-network-from-some-server)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| server-groups                          | *Map*         | See [Grouping players only from certain servers](#grouping-players-only-from-certain-servers)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

 ## Grouping players only from certain servers
 In case you want multiple servers to share playerlist,
@@ -37,7 +66,7 @@ global-playerlist:
 ```
 Contains 2 groups, each of them consisting of 2 servers.
 Server group name can be anything (in our case, they're called "lobbies" and "group2").
-Under group name, list the actual server names defined in config.yml of bungeecord.
+Under group name, list the actual server names defined in config.yml of the proxy server.

 With this setup, "lobby1" and "lobby2" will share playerlist, as well as "server1" with "server2". All unlisted servers are automatically put into a hidden default group and share playerlist. This means that all other servers except these 4 will share playerlist.

@@ -46,6 +75,36 @@ To make all servers share the playerlist, simply clear server groups and set
  server-groups: {}
 ```

+### Pattern Matching
+Server names in groups support multiple pattern types for flexible configuration:
+
+**Exact Match** - Matches server name exactly:
+```yaml
+server-groups:
+  lobbies:
+    - lobby1
+    - lobby2
+```
+
+**Wildcard Patterns** - Use `*` for prefix or suffix matching:
+```yaml
+server-groups:
+  lobbies:
+    - "Lobby-*"      # Matches: Lobby-1, Lobby-2, Lobby-Hub, etc.
+    - "*-lobby"      # Matches: eu-lobby, us-lobby, etc.
+```
+
+**Regex Patterns** - Use `regex:` prefix for advanced pattern matching:
+```yaml
+server-groups:
+  lobbies:
+    - regex:Lobby-[0-9]+        # Matches: Lobby-1, Lobby-23, but not Lobby-Hub
+  smp:
+    - regex:SMP-(EU|US)-[0-9]+  # Matches: SMP-EU-1, SMP-US-2, etc.
+```
+
+Note: Wildcard patterns are case-insensitive, while regex patterns are case-sensitive by default (use `(?i)` flag for case-insensitive regex).
+
 ## Configuring isolated servers
 If you want servers which are isolated (no one will see these players, and they will not see anyone on other servers),
 create a new group and only put that 1 server there.
@@ -59,6 +118,8 @@ global-playerlist:
      - isolatedServer2
 ```

+This is not needed when `isolate-unlisted-servers` is set to `true`, in which case all unlisted servers are isolated by default.
+
 ## Seeing all players on the network from some server
 If, despite configuring server groups,
 you want players to see everyone on the network if they're connected to specific server(s),
@@ -71,5 +132,30 @@ global-playerlist:
 ```
 Now, players connected to "spyserver1" or "spyserver2" will see everyone on the network in tablist, but no one else (unless on another spy server / in the same server group) will see them.

-# Compatibility with vanish plugins
-For compatibility with vanish plugins, vanish status must be detected correctly. See [Additional information - Vanish detection](https://github.com/NEZNAMY/TAB/wiki/Additional-information#vanish-detection) for more info.
+# Placeholders
+Here are TAB's internal placeholders you can use when this feature is enabled:
+| Placeholder | Description |
+|-------------|-------------|
+| %playerlist-group_\<group\>% | Amount of online players in specified global playerlist group |
+
+# Compatibility with other plugins
+For compatibility with vanish plugins, vanish status must be detected correctly. See [Additional information - Vanish detection](https://github.com/NEZNAMY/TAB/wiki/Additional-information#vanish-detection) for more info.
+
+# Troubleshooting
+This is a collection of tips to help you figure out why the feature isn't working as you expect.  
+To get started, run `/tab dump <player looking at the tablist>` and open the generated link. Scroll down to `features` -> `GlobalPlayerList` and check the content:
+* If it says `GlobalPlayerList: Feature is disabled`, it means you did not enable the feature. Enable it by setting
+  ```
+  global-playerlist:
+    enabled: true
+  ```
+* Check the `configuration` section and compare it with your config file. If it's different, you either forgot to reload TAB, uploaded the config to the wrong server, or did not upload it at all.
+* Check the `player info` section and make sure everything is as expected - server name, server group and other servers in that group. If server name says `N/A`, it means you did not configure `server-name` (TODO create section and link it).
+* Check the `visibility from viewer's perspective` table. Find the target player who the viewer should see but doesn't (or vice versa) and check their server, server group and whether they should be visible or not.
+  <br /> **If "visible" doesn't match the expected result, but matches what is shown in-game:**
+  * See the full message for a hint why the player is or is not visible
+  * Make sure server groups are configured as desired
+  * If the issue involves vanishing, see [Vanish Detection](https://github.com/NEZNAMY/TAB/wiki/Additional-information#vanish-detection). In short, make sure the player has `tab.seevanished` permission to see vanished players and if the vanish plugin is PremiumVanish, its layered vanish system does not block the target player from being seen by the viewer
+
+  **If "visible" matches the expected result, but not in-game result:**
+  * If both players are on the same server, the visibility is managed purely by the server (and plugins there), not by TAB. It means the player was hidden by another plugin or not shown by the server itself, for example when using redis to connect the servers and TAB, but the different servers acting  as one do not share tablist information between them.
@@ -1,14 +1,20 @@
 # Content
 * [About](#about)
 * [Configuration](#configuration)
-  * [Global settings](#global-settings)
-  * [Per-world / per-server](#per-world--per-server)
-  * [Per-group / per-player](#per-group--per-player)
+  * [Design](#design)
+  * [Chaining designs](#chaining-designs)
+* ~Commands~
+* ~Placeholders~
+* ~Limitations~
+* [Compatibility with other plugins](#compatibility-with-other-plugins)
 * [Additional info](#additional-info)
-  * [Additional note 1 - Not resetting on server switch](#additional-note-1---not-resetting-on-server-switch)
-* [Tips & Tricks](#tips--tricks)
-  * [Tip 1 - Dynamic line count](#tip-1---dynamic-line-count)
+  * [Additional note 1 - [1.8 - 1.20.1] Not resetting on server switch](#additional-note-1---18---1201-not-resetting-on-server-switch)
+* [Troubleshooting](#troubleshooting)
 * [API](#api)
+* [Examples](#examples)
+  * [Example 1 - Per-version header/footer](#example-1---per-version-headerfooter)
+  * [Example 2 - Per-world header/footer](#example-2---per-world-headerfooter)
+  * [Example 3 - Dynamic line count](#example-3---dynamic-line-count)

 # About
 Minecraft feature **introduced in 1.8** showing text above and below playerlist. It cannot be displayed on 1.7 clients in any way.
@@ -16,87 +22,176 @@ Minecraft feature **introduced in 1.8** showing text above and below playerlist.
 ![](https://images-ext-2.discordapp.net/external/Jm9G7_fX8Rq4KU-Syj57W2a_leel380bZ4lmd6c0vBs/https/image.prntscr.com/image/qvuAdtgZTDeZ4IeABi8I3g.png)

 # Configuration
-| Option name       | Default value         | Description                                                                                                                                                                                         |
-|-------------------|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| enabled           | true                  | Enables / Disables the feature                                                                                                                                                                      |
-| disable-condition | %world%=disabledworld | A [condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for disabling the feature for players. Set to empty for not disabling the feature ever. |
-
-## Global settings
-The example above is using this configuration:
+The feature can be configured in **config.yml** under **header-footer** section.  
+This is how the default configuration looks:
 ```
 header-footer:
-  header:
-  - "This is the first line of header"
-  - "2nd line of header"
-  footer:
-  - "This is the first line of footer"
-  - "2nd line of footer"
-```
-It is the default header/footer for everyone, unless overridden in some way.
-
-## Per-world / per-server
-```
-header-footer:
-  per-world:
-    <your world>:
+  enabled: true
+  designs:
+    world-test:
+      display-condition: "%world%=test"
      header:
-        - "Header in specified world"
+        - "Test header in world 'test'"
      footer:
-        - "Footer in specified world"
-  per-server:
-    <your server>:
+        - "Test footer in world 'test'"
+    default:
      header:
-        - "Header in specified server"
+        - "<#FFFFFF>&m                                                </#FFFF00>"
+        - "&3&lServer name"
+        - "&r&7&l>> %animation:Welcome%&3 &l%player%&7&l! &7&l<<"
+        - "&r&7Online players: &f%online%"
+        - "&6Online staff: &e%staffonline%"
+        - ""
      footer:
-        - "Footer in specified server"
+        - "%animation:time%"
+        - "&2Ping: %ping%"
+        - "&7&l Used memory: %memory-used% MB / %memory-max% MB"
+        - ""
+        - "&r&7Visit our webpage %animation:web%"
+        - "<#FFFFFF>&m                                                </#FFFF00>"
 ```
+All the options are explained in the following table.

-For multiple worlds/servers to share the same settings, separate them with `;`.  
-For worlds/servers starting with a specified text, use `*` after the shared part. For ending with a shared part, use `*` at the beginning.  
-Example:
+| Option name       | Default value         | Description                                                       |
+|-------------------|-----------------------|-------------------------------------------------------------------|
+| enabled           | true                  | Enables / Disables the feature                                    |
+| designs           | *Map*                 | Designs to display based on conditions (see below for more info). |
+
+## Design
+A header/footer design consists of the following options:
+| Option name | Description      |
+|-------------|------------------|
+| `display-condition` (optional) | [Condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) (either condition name or a conditional expression) <br /> that must be met for the design to be displayed. <br />If not defined, design will be displayed without any required condition. <br />If player does not meet condition, another design may be displayed <br /> based on chaining (see below for more info). |
+| `header`                       | List of lines to display in the header. |
+| `footer`                       | List of lines to display in the footer. |
+
+**Example**:
 ```
 header-footer:
-  per-world:
-    world1;world2:
+  enabled: true
+  designs:
+    MyDesign:  # Design name
+      display-condition: "%world%=world"  # Delete the line for no condition requirement
      header:
-        - "Shared header in worlds world1 and world2"
-    lobby-*:
-      header:
-        - "Header in all worlds starting with lobby-"
+        - "Header for world %world%"
+      footer:
+        - "Footer for world %world%"
 ```

-> [!NOTE]
-> To make per-world work on proxy installation,
-> install the [TAB-Bridge](https://www.mc-market.org/resources/21641) plugin on your backend servers.
-
-## Per-group / per-player
-**groups.yml**
+## Chaining designs
+When defining more than 1 design in config, the plugin will display the correct design based on conditions.
+The plugin goes through all defined designs, starting with the design on top.
+If the design's condition is met or not set, it is displayed.
+If not, the next defined design is checked and so on.
+If no suitable design is found (the last one has a condition requirement which wasn't met), none is displayed.  
+**Example**:
 ```
-MyGroup:
-  header:
-    - "This is a header for MyGroup group"
-  footer:
-    - "This is a footer for MyGroup group"
-per-world:
-  MyWorld:
-    TestGroup:
+header-footer:
+  enabled: true
+  designs:
+    per-world:
+      display-condition: "%world%=world"
      header:
-        - "Header for group TestGroup in world MyWorld"
+        - "Header for world world"
+      footer:
+        - "Footer for world world"
+    default:  # No display condition
+      header:
+        - "Header for every world except world"
+      footer:
+        - "Footer for every world except world"
 ```
-Same for users, which can be configured in **users.yml**.
+Design `per-world` is checked first. If condition is not met, `default` is displayed.  
+If a chaining 3 or more and player meets 2 or more conditions for 2 (or more) different designs, the first one defined in the config will be displayed.  You can swap order of designs based on your priority needs.
+
+# Compatibility with other plugins
+Header/Footer is a feature that cannot be handled by multiple plugins at once.
+To make sure no other plugin sends their own Header/Footer when not disabled in the plugin's config properly, TAB will block header/footer coming from all other plugins if this feature is enabled (and not disabled for a player with a condition).
+An exception to this is Velocity installation, where this "anti-override" is not available.

 # Additional info
-## Additional note 1 - Not resetting on server switch
+## Additional note 1 - [1.8 - 1.20.1] Not resetting on server switch
 When under a BungeeCord network and having TAB installed on backend server and switching to another server, the header/footer will not reset. This is because BungeeCord makes it look like a world switch to the client. To avoid this, you have 2 options:
 * Install TAB on BungeeCord and disable header/footer on the server.
 * Install a plugin that sends some, or even empty header/footer on join.

-# Tips & Tricks
-## Tip 1 - Dynamic line count
+Velocity sends a reset packet on server switch, so it isn't a problem there. It is also not a problem since 1.20.2, where configuration phase was added.
+
+# Troubleshooting
+This is a collection of tips to help you figure out why the feature isn't working as you expect.  
+To get started, run `/tab dump <affected player>` and open the generated link. Scroll down to `features` -> `HeaderFooter` and check the content:
+* If it says `HeaderFooter: Feature is disabled`, it means you disabled the feature. Enable it by setting
+  ```
+  header-footer:
+    enabled: true
+  ```
+* Check the `configuration` section and compare it with your config file. If it's different, you either forgot to reload TAB, or uploaded the config to the wrong server (or did not upload it at all).
+* Check the `chain` section and for each design and analyze the `display-condition` options (the value, with placeholders parsed, whether it is met or not) if it matches what you expect. If not, you may have made a mistake in your conditions. If more display conditions for more than 1 design are met, the first design with display condition met is displayed. See [Chaining designs](#chaining-designs) for more info.
+* Check `currently displayed design` and compare it with your expectations, as well as the actual in-game result. If it doesn't match your expectations, you didn't configure something correctly.
+* Make sure you don't have another plugin sending header/footer, such as CMI. While TAB should block other plugins from applying it, this functionality is not available on Velocity installation.
+
+
+# API
+*To get started with the API, see [Developer API](https://github.com/NEZNAMY/TAB/wiki/Developer-API) page.*
+
+To access this feature, you'll need to obtain `HeaderFooterManager` instance. Get it using `TabAPI.getInstance().getHeaderFooterManager()`. If this feature is disabled, the method will return `null`.
+
+To set the header and/or footer for a player, use the following:
+* `HeaderFooterManager#setHeader(TabPlayer, String)`
+* `HeaderFooterManager#setFooter(TabPlayer, String)`
+* `HeaderFooterManager#setHeaderAndFooter(TabPlayer, String, String)`
+
+To reset the header and/or footer for a player back to their original values, use `null` as argument.
+
+# Examples
+## Example 1 - Per-version header/footer
+Minecraft 1.21.9 has introduced [object components](https://github.com/NEZNAMY/TAB/wiki/How-to-use-Minecraft-components#object-components-1219), but these are not available for older versions. Let's make 2 designs, one for 1.21.9+ and second one for <1.21.9.
+```
+header-footer:
+  enabled: true
+  designs:
+    newer-client:
+      display-condition: "%player-version-id%>=773" # 1.21.9 uses 773
+      header:
+        - "Look, it's your head! <head:name:%player%>"
+      footer:
+        - "Cool, isn't it?"
+    older-client:
+      header:
+        - "Regular header for old clients"
+      footer:
+        - "Consider updating your game"
+```
+
+## Example 2 - Per-world header/footer
+For this, we can use design chaining with conditions. There is no limit to how many worlds we can configure, but let's stick to 3 designs - one for `world`, one for `world2` and one for the rest.
+```
+header-footer:
+  enabled: true
+  designs:
+    world:
+      display-condition: "%world%=world" # Only show if player is in world "world"
+      header:
+        - "Header for world world"
+      footer:
+        - "Footer for world world"
+    world2:
+      display-condition: "%world%=world2" # Only show if player is in world "world2"
+      header:
+        - "Header for world world2"
+      footer:
+        - "Footer for world world2"
+    default:
+      header:
+        - "Header for all worlds except world and world2"
+      footer:
+        - "Footer for all worlds except world and world2"
+```
+
+## Example 3 - Dynamic line count
 The entire header is just a single character sequence that allows newline symbol (`\n`) for new lines. It is only being split into multiple lines in config for convenience to make it readable when configuring and editing. Same for footer.  
-If using a placeholder that returns the newline symbol, it will create a new line. You can use this to your advantage and create a [conditional placeholder](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) or an [animation](https://github.com/NEZNAMY/TAB/wiki/Animations) that includes newline in some frames.
-<details>
-  <summary>Example</summary>
+If using a placeholder that returns the newline symbol, it will create a new line. You can use this to your advantage and create a [conditional placeholder](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) or an [animation](https://github.com/NEZNAMY/TAB/wiki/Animations) that includes newline in some frames.  
+**Example**:

 **animations.yml**
 ```
@@ -109,19 +204,8 @@ MyAnimation:
 **config.yml**
 ```
 header-footer:
-  header:
-    - "%animation:MyAnimation%"
-```
-</details>
-
-# API
-*To get started with the API, see [Developer API](https://github.com/NEZNAMY/TAB/wiki/Developer-API) page.*
-
-To access this feature, you'll need to obtain `HeaderFooterManager` instance. Get it using `TabAPI.getInstance().getHeaderFooterManager()`. If this feature is disabled, the method will return `null`.
-
-To set the header and/or footer for a player, use the following:
-* `HeaderFooterManager#setHeader(TabPlayer, String)`
-* `HeaderFooterManager#setFooter(TabPlayer, String)`
-* `HeaderFooterManager#setHeaderAndFooter(TabPlayer, String, String)`
-
-To reset the header and/or footer for a player back to their original values, use `null` as argument.  
+  designs:
+    DesignName:
+      header:
+        - "%animation:MyAnimation%"
+```
@@ -1,54 +1,105 @@
 # Content
 * [About](#about)
-* [Creating a layout](#creating-a-layout)
-  * [Display condition](#display-condition)
-  * [Fixed slots](#fixed-slots)
-  * [Player groups](#player-groups)
-* [Managing multiple layouts with conditions](#managing-multiple-layouts-with-conditions)
-* [Skins](#skins)
-  * [Format](#format)
-* [Additional settings](#additional-settings)
+* [Configuration](#configuration)
+  * [Layout](#layout)
+    * [Fixed slots](#fixed-slots)
+    * [Player groups](#player-groups)
+  * [Chaining layouts](#chaining-layouts)
+  * [Skins](#skins)
+* ~Commands~
+* ~Placeholders~
+* ~Limitations~
+* [Compatibility with other plugins](#compatibility-with-other-plugins)
+* [Compatibility with other features](#compatibility-with-other-features)
+  * [Playerlist objective incompatibility](#playerlist-objective-incompatibility)
+  * [Global playerlist incompatibility](#global-playerlist-incompatibility)
+  * [Per world playerlist incompatibility](#per-world-playerlist-incompatibility)
 * [Additional info](#additional-info)
-  * [Additional note 1 - Playerlist objective incompatibility](#additional-note-1---playerlist-objective-incompatibility)
-  * [Additional note 2 - Global playerlist incompatibility](#additional-note-2---global-playerlist-incompatibility)
-  * [Additional note 3 - [1.19.3 - 1.21.1] Entries in chat complete](#additional-note-3---1193---1211-entries-in-chat-complete)
-  * [Additional note 4 - Per world playerlist incompatibility](#additional-note-4---per-world-playerlist-incompatibility)
-  * [Additional note 5 - [1.8 - 1.21.3] Second layer of skin missing](#additional-note-5---18---1213-second-layer-of-skin-missing)
+  * [Additional note 1 - [1.19.3 - 1.21.1] Entries in chat complete](#additional-note-1---1193---1211-entries-in-chat-complete)
+  * [Additional note 2 - [1.8 - 1.21.3] Second layer of skin missing](#additional-note-2---18---1213-second-layer-of-skin-missing)
+  * [Additional note 3 - Entry overlap](#additional-note-3---entry-overlap)
+* ~Troubleshooting~
+* [API](#api)
 * [Examples](#examples)
  * [Example 1 - Per-server columns](#example-1---per-server-columns)
+  * [Example 2 - Per-world playerlist](#example-2---per-world-playerlist)

 # About
-This feature allows you to customize all 80 tablist slots. Displaying less than 4 columns is currently not supported. This feature can be enabled and configured in **config.yml** file under **layout** section.
+This feature allows you to customize all 80 tablist slots (possibly less on 1.19.3+). This feature can be enabled and configured in **config.yml** file under **layout** section.

 This feature is only available for versions **1.8** and up due to massive tablist changes, which would make 1.7- compatibility require a complete rewrite of the functionality and could still cause all kinds of visual issues, including, but not limited to compatibility with other plugins adding/removing players from the tablist.

-# Creating a layout
-Layouts can be creating in config under `layout.layouts` section. Each layout contains 3 settings: Fixed slots, player groups and display condition (optional).
-
-## Display condition
-Condition that must be met for player to see the layout.
-If player does not meet the condition, the next defined layout's condition is checked.
-If a player does not meet any defined display condition, they will see the default tablist.
-Display condition is optional and doesn't need to be set.  
-For list of possible condition types see [Conditions page](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders).  
-Example:
+# Configuration
+The feature can be configured in **config.yml** under **layout** section.  
+This is how the default configuration looks:
 ```
-layouts:
-  staff:
-    condition: "permission:tab.staff"
+layout:
+  enabled: false
+  direction: COLUMNS
+  default-skin: mineskin:37e93c8e12cd426cb28fce31969e0674
+  enable-remaining-players-text: true
+  remaining-players-text: '... and %s more'
+  empty-slot-ping-value: 1000
+  layouts:
+    default:
+      slot-count: 80
+      fixed-slots:
+        - '1|&3Website&f:'
+        - '2|&bmyserver.net'
+        - '3|&8&m                       '
+        - '4|&3Name&f:'
+        - '5|&b%player%'
+        - '7|&3Rank&f:'
+        - '8|Rank: %group%'
+        - '10|&3World&f:'
+        - '11|&b%world%'
+        - '13|&3Time&f:'
+        - '14|&b%time%'
+        - '21|&3Teamspeak&f:'
+        - '22|&bts.myserver.net'
+        - '23|&8&m                       '
+        - '41|&3Store&f:'
+        - '42|&bshop.myserver.net'
+        - '43|&8&m                       '
+      groups:
+        staff:
+          display-condition: permission:tab.staff
+          slots:
+            - 24-40
+        players:
+          slots:
+            - 44-80
 ```
-This layout will only be visible to players with `tab.staff` permission.
+All the options are explained in the following table.

-## Fixed slots
+| Option name                   | Default value        | Description                                                                                                                                                                                                                                                                |
+|-------------------------------|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| enabled                       | true                 | Enables / Disables the feature                                                                                                                                                                                                                                             |
+| direction                     | COLUMNS              | Defines direction of slots. Options are COLUMNS (top to bottom, left to right) and ROWS (left to right, top to bottom). This does not only change the slot numbers in configuration, but will also affect the way players are being filled into player groups.             |
+| default-skin                  | "mineskin:383747683" | Default skin to display for fixed slots that do not define a skin, empty slots and fixed slots with invalid skin.                                                                                                                                                          |
+| enable-remaining-players-text | true                 | When enabled and there are more players in a player group than available slots, the last slot of player group will show how many more players there are, instead of using the last slot for one more player.                                                               |
+| remaining-players-text        | "... and %s more"    | Text to show if option above is enabled. Use `%s` variable for defining how many more players there are.                                                                                                                                                                   |
+| empty-slot-ping-value         | 1000                 | Ping value to use for fixed slots and empty slots. The ping intervals for bars are client sided and are as following: <br />- Negative value: ✖ <br />- 0 - 149: 5 bars <br />- 150 - 299: 4 bars <br />- 300 - 599: 3 bars <br />- 600 - 999: 2 bars <br />- 1000+: 1 bar |
+| layouts                       | *Map*                | Layouts to display based on conditions (see below for more info).                                                                                                                                                                                                          | 
+
+## Layout
+A layout consists of the following options:
+| Option name | Description      |
+|-------------|------------------|
+| `display-condition` (optional) | [Condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) (either condition name or a conditional expression) that must be met for the layout to be displayed. If not defined, layout will be displayed without any required condition. If player does not meet condition, another layout may be displayed based on chaining (see below for more info). |
+| `default-skin` (optional)      | Overrides global `default-skin` setting for this layout. |
+| `slot-count` (optional)        | Amount of slots to show in this layout. If not specified, defaults to `80`. **Only works on 1.19.3+**. |
+| `fixed-slots`                  | List of fixed slots, see below for more info. |
+| `player-groups`                | Map of player groups, see below for more info. |
+
+### Fixed slots
 These are slots with fixed position that contain configurable text and skin.  
-They can be configured under `fixed-slots` option of each layout. The definition syntax is `SLOT|TEXT|SKIN`. If you don't want to define custom skin for that slot, use `SLOT|TEXT`.  
+They can be configured under `fixed-slots` option of each layout. The definition syntax is `SLOT|TEXT[|SKIN]` (skin is optional). If you don't want to define custom skin for that slot, use `SLOT|TEXT`.  
 `SLOT` - The position of the fixed slot. It can be from 1 to 80. By default, the direction is set to columns, so the first column is 1-20.  
 `TEXT` - the text. It supports placeholders.  
 `SKIN` - layout's skin, see below for configuration.  
 Example:
 ```
-layouts:
-  staff:
    fixed-slots:
      - '1|&3RAM&f:'
      - '2|&b%memory-used%MB / %memory-max%MB'
@@ -56,11 +107,18 @@ layouts:
      - '4|&3TPS&f:'
      - '5|&b%tps%'
 ```
+If you do not wish to use any fixed slots, make it an empty list (`[]`).  
+Example:
+```
+  layouts:
+    staff:
+      fixed-slots: []
+```

-## Player groups
+### Player groups
 These are groups of players that meet the specified condition. They consist of 2 parts - condition and slots.

-**1. Condition**  
+**1. Display Condition**  
 The condition players must meet to be displayed in the group.
 If a player doesn't meet condition for a group, the next group's condition is checked
 (groups are checked in the order they are defined in config).
@@ -71,30 +129,30 @@ Display condition is not required (can be used to make a "default" group with th
 Slot intervals dedicated to the group. Interval `1-5` would mean all slots from 1 to 5. In case you want to define multiple intervals to exclude some slots, define another interval below the first one.  
 Example:
 ```
-layouts:
-  myLayout:
-    groups:
-      staff:
-        condition: permission:tab.staff
-        slots:
-          - '24-40'
-      players:
-        slots:
-          - '44-80'
+  layouts:
+    myLayout:
+      groups:
+        staff:
+          display-condition: permission:tab.staff
+          slots:
+            - '24-40'
+        players:
+          slots:
+            - '44-80'
 ```
 In this example, slots `24-40` will be reserved for players with `tab.staff` permission. Players without that permission will be in slots `44-80`.

-# Managing multiple layouts with conditions
-You can define multiple layouts and display them based on a condition.
-To do so, define `condition` for layouts.
-Conditions are checked in the order layouts are defined in config.
-If layout doesn't specify condition, it is displayed with no requirement.
-If a player does not meet display condition for any layout, they will see the classic tablist.  
+## Chaining layouts
+When defining more than 1 layout in config, the plugin will display the correct design based on conditions.
+The plugin goes through all defined layouts, starting with the design on top.
+If the layout's condition is met or not set, it is displayed.
+If not, the next defined layout is checked and so on.
+If no suitable layout is found (the last one has a condition requirement which wasn't met), no layout is displayed (player will see the normal tablist).
 Example:
 ```
 layouts:
  staff:
-    condition: "permission:tab.staff"
+    display-condition: "permission:tab.staff"
    fixed-slots:
      ...
    groups:
@@ -107,75 +165,33 @@ layouts:
 ```
 In this example, players with `tab.staff` permission will see `staff` layout, others will see `default` layout.

-# Skins
-In slots where players are, their skin is displayed. For fixed slots, if their skin is defined, it is used, otherwise `default-skin` is used. It is also used if invalid skin is specified anywhere.
+## Skins
+*If you're wondering how to enable / disable heads in the tablist, see [FAQ](https://github.com/NEZNAMY/TAB/wiki/Frequently-Asked-Questions#6---how-to-make-player-heads-visible-in-tablist).*

-## Format
-Currently, TAB supports 3 skin formats:
-* `mineskin:<ID>` - takes UUID from [MineSkin](https://mineskin.org). You can find some pre-uploaded skins at the bottom of this page.
-* `player:<name>` - displays skin of player `name`
-* `texture:<texture>` - uses literal skin texture. This lets you use heads from [Minecraft-Heads](https://minecraft-heads.com/custom-heads) by taking the texture in the `Minecraft-URL` field.    
-  ![](https://cdn.discordapp.com/attachments/817789229479624728/916373892237512715/unknown.png)
+For players, their skin is displayed. For fixed slots and empty slots, you can specify which skin to show using the same skin syntax.  
+Currently, TAB supports these skin formats:
+| Format | Example | Description |
+|--------|---------|-------------|
+| `mineskin:<UUID>` | `mineskin:37e93c8e12cd426cb28fce31969e0674` | Takes UUID from [MineSkin](https://mineskin.org). |
+| `player:<name>` | `player:Notch` | Displays skin of specified player. |
+| `texture:<texture>` | `texture:469b3bac406b51ba0e76c2c218aa4d45fde9ea7c101c85fbd8106c92c4aa36dd` | Uses skin texture from `textures.minecraft.net`. Skin browsing websites often show this value (for example `Texture URL` on mineskin.org). |

-Some pre-uploaded Mineskin skins:
-```yml
-BTLP's balance.png: 510604280
-BTLP's clock.png: 2053951237
-BTLP's server.png: 604037953
-BTLP's ping.png: 796704708
-BTLP's players.png: 1160612233
-BTLP's rank.png: 527763880
-Aqua: 1749359849
-Black: 1551047136
-Blue: 1870064311
-Dark Aqua: 1893783461
-Dark Blue: 899643609
-Dark Gray: 383747683
-Dark Green: 588254656
-Dark Purple: 2061328517
-Dark Red: 924139093
-Gold: 1074335506
-Gray: 745109047
-Green: 224445819
-Pink: 1818936290
-Red: 1160568696
-White: 1105851698
-Yellow: 1307755006
-```
+# Compatibility with other plugins
+This feature does not have any compatibility issues with other plugins.  
+When it comes to compatibility with vanish plugins, see [Additional information - Vanish detection](https://github.com/NEZNAMY/TAB/wiki/Additional-information#vanish-detection).

-# Additional settings
-| Option name                   | Default value        | Description                                                                                                                                                                                                                                                                |
-|-------------------------------|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| direction                     | COLUMNS              | Defines direction of slots. Options are COLUMNS (top to bottom, left to right) and ROWS (left to right, top to bottom). This does not only change the slot numbers in configuration, but will also affect the way players are being filled into player groups.             |
-| enable-remaining-players-text | true                 | When enabled, the last slot of player group will show how many more players there are, instead of using the last slot for one more player.                                                                                                                                 |
-| remaining-players-text        | "... and %s more"    | Text to show if option above is enabled.                                                                                                                                                                                                                                   |
-| default-skin                  | "mineskin:383747683" | Default skin to display for fixed slots that do not define a skin, empty slots and fixed slots with invalid skin.                                                                                                                                                          |
-| empty-slot-ping-value         | 1000                 | Ping value to use for fixed slots and empty slots. The ping intervals for bars are client sided and are as following: <br />- Negative value: ✖ <br />- 0 - 149: 5 bars <br />- 150 - 299: 4 bars <br />- 300 - 599: 3 bars <br />- 600 - 999: 2 bars <br />- 1000+: 1 bar |
-
-![image](https://user-images.githubusercontent.com/6338394/179363352-40f815d4-fc37-4ca1-8056-298488e84a60.png)
-![image](https://user-images.githubusercontent.com/6338394/179355373-3e50b8c5-95d7-4470-b93f-deb162ccc145.png)
-
-# Additional info
-## Additional note 1 - Playerlist objective incompatibility
+# Compatibility with other features
+## Playerlist objective incompatibility
 To avoid showing fake players in tab-complete, TAB uses an empty string as the fake players' names.  
 Though Minecraft's scoreboard objectives (which help achieve the Playerlist objective feature) only use players' names and not players' UUIDs to define values.  
 As a result, it is impossible for TAB to assign a different value for each fake player since they all have the same name, making the [Playerlist objective](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Playerlist-Objective) feature incompatible.

-## Additional note 2 - Global playerlist incompatibility
+## Global playerlist incompatibility
 The way this feature works is by pushing all real players out of the tablist and showing fake players instead.  
 As a result, enabling [Global playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist) feature won't make any difference, since real players aren't visible in the tablist.  
-Layout feature is capable of working with all online players connected to the server where TAB is installed, meaning it can show players from all servers when installed on BungeeCord. Because of this, if you use layout, you can disable global playerlist to reduce resource usage.
+Layout feature is capable of working with all online players connected to the server where TAB is installed, meaning it can show players from all servers when installed on a proxy. Because of this, if you use layout, you can disable global playerlist to reduce resource usage.

-## Additional note 3 - [1.19.3 - 1.21.1] Entries in chat complete
-From 1.19.3 until 1.21.1 (inclusive), entries will also appear in chat complete.
-The mechanic used to hide them on <1.19.3 can no longer be used since 1.19.3.
-1.21.2 has added a new way of sorting players, which is being taken advantage of to restore empty chat complete.
-> [!NOTE]
-> To hide entries from chat complete on 1.21.2+,
-the server also has to be 1.21.2+ so TAB can send the new content to the players
-(having TAB installed on proxy counts as using the latest version).
-
-## Additional note 4 - Per world playerlist incompatibility
+## Per world playerlist incompatibility
 Layout works by adding 80 fake players into the tablist, pushing real player entries out of view.
 Because of this,
 when using [per world playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Per-world-playerlist),
@@ -192,19 +208,19 @@ Each layout only displays players in that world.
 ```
  layouts:
    layout1:
-      condition: "%world%=world1"
+      display-condition: "%world%=world1"
      fixed-slots: []
      groups:
        players:
-          condition: "%world%=world1"
+          display-condition: "%world%=world1"
          slots:
            - 1-80
    layout2:
-      condition: "%world%=world2"
+      display-condition: "%world%=world2"
      fixed-slots: []
      groups:
        players:
-          condition: "%world%=world2"
+          display-condition: "%world%=world2"
          slots:
            - 1-80
 ```
@@ -212,11 +228,11 @@ You can also merge multiple worlds into a group.
 ```
  layouts:
    layout1:
-      condition: "%world%=world1|%world%=world2"
+      display-condition: "%world%=world1|%world%=world2"
      fixed-slots: []
      groups:
        players:
-          condition: "%world%=world1|%world%=world2"
+          display-condition: "%world%=world1|%world%=world2"
          slots:
            - 1-80
 ```
@@ -224,7 +240,7 @@ You can also replicate "ignore-effect-in-worlds" by creating a layout with condi
 ```
  layouts:
    globalWorld:
-      condition: "%world%=globalWorld"
+      display-condition: "%world%=globalWorld"
      fixed-slots: []
      groups:
        players: # No condition here to show all players
@@ -233,7 +249,13 @@ You can also replicate "ignore-effect-in-worlds" by creating a layout with condi
 ```
 </details>

-## Additional note 5 - [1.8 - 1.21.3] Second layer of skin missing
+# Additional info
+## Additional note 1 - [1.19.3 - 1.21.1] Entries in chat complete
+From 1.19.3 until 1.21.1 (inclusive), entries will also appear in chat complete.
+The mechanic used to hide them on <1.19.3 can no longer be used since 1.19.3.
+1.21.2 has added a new way of sorting players, which is being taken advantage of to restore empty chat complete.
+
+## Additional note 2 - [1.8 - 1.21.3] Second layer of skin missing
 Layout works by creating 80 fake entries, pushing real players out of the tablist.
 Unfortunately, players must be spawned around the player viewing the tablist to see the second layer of their skin.
 Since those fake entries you see are not the actual players and aren't spawned,
@@ -241,7 +263,42 @@ as a result, you won't see the second layers of skins.
 This can only be fixed by actually letting the real entries display in the tablist,
 which would require a rework of the feature, which is not planned.  
 **1.21.4 has added a new tablist option called "show hats", which layout sets to true.
-They will be visible for 1.21.4+ players on 1.21.4+ servers (using a proxy counts as being latest).**
+They will be visible for 1.21.4+ players.**
+
+## Additional note 3 - Entry overlap
+Tablist entries automatically adapt their width based on the longest entry.
+The final width is global for all columns, not just using the longest width in each respective column.
+When the requested width is higher than the game window can handle, the text in entries will start to overlap.
+This is how it looks with 1/4 screen size, which is the default window size when launching Minecraft.  
+<img width="855" height="519" alt="image" src="https://github.com/user-attachments/assets/2a256b25-c672-49ea-8c8f-d670aa9efd43" />  
+This can be solved by increasing window size either manually, or by pressing the expand button on the top left, next to the "X".
+If it still looks the same for you even though you have the game in full screen, your GUI scale can be messed up.
+
+To fix it, go to `Esc -> Options -> Video Settings...` and set `GUI Scale: ` to a lower value.
+
+If you are looking for a more systematic solution that will automatically work for all of your players and not just you, the only way is to make the entries shorter.
+Here are a few tips how to do that:
+* Avoid using suffix altogether
+* Do not use bold (`&l`) code
+* Use a shorter alternative for your prefixes, such as `A` instead of `Admin`
+* Remove unnecessary brackets from prefix
+
+
+# API
+*To get started with the API, see [Developer API](https://github.com/NEZNAMY/TAB/wiki/Developer-API) page.*
+
+To access this feature, you'll need to obtain `LayoutManager` instance. Get it using `TabAPI.getInstance().getLayoutManager()`. If this feature is disabled, the method will return `null`.
+
+The `LayoutManager` has the following methods:
+* `Layout createNewLayout(String name)` - Creates new layout with given internal name and 80 slots.
+* `Layout createNewLayout(String name, int slotCount)` - Creates new layout with given internal name and slot count (for 1.19.3+, <1.19.3 players will still see 80 slots).
+* `Layout getLayout(String name)` - Returns layout by given internal name. Works for layouts created in both configuration and through the API.
+* `sendLayout(TabPlayer player, Layout layout)` - Sends given layout to the player, overriding configuration. Sending `null` as layout will restore layout from configuration.
+
+After creating a `Layout` using the API or getting it from configuration, you can use the following methods:
+* `String getName()` - Returns layout's name
+* `addFixedSlot(int slot, String text)` / `addFixedSlot(int slot, String text, String skin)` / `addFixedSlot(int slot, String text, int ping)` / `addFixedSlot(int slot, String text, String skin, int ping)` / `addFixedSlot(int slot, String text, String skin, String ping)` - Adds a fixed slot with gieven properties - slot, text, skin (optional) and ping (optional)
+* `addGroup(String condition, int[] slots)` - Adds a new player group with given condition (nullable for no condition) and slots. Condition can be either a conditional expression, or a condition created in config.

 # Examples
 ## Example 1 - Per-server columns
@@ -262,21 +319,65 @@ layout:
      - "61|&2&lSkyblock"
      groups:
        lobby:
-          condition: "%server%=lobby"
+          display-condition: "%server%=lobby"
          slots:
          - 2-20
        survival:
-          condition: "%server%=survival"
+          display-condition: "%server%=survival"
          slots:
          - 22-40
        creative:
-          condition: "%server%=creative"
+          display-condition: "%server%=creative"
          slots:
          - 42-60
        skyblock:
-          condition: "%server%=skyblock"
+          display-condition: "%server%=skyblock"
          slots:
          - 62-80
 ```
-You can also remove the last condition (in this case `condition: "%server=skyblock%"`) and the columns will be used for all other servers, instead of just a specified one.  
+You can also remove the last condition (in this case `display-condition: "%server=skyblock%"`) and the columns will be used for all other servers, instead of just a specified one.  
 ![image](https://github.com/NEZNAMY/TAB/assets/6338394/81016b5a-9b40-445e-8bfc-58204f5457f5)
+
+
+## Example 2 - Per-world playerlist
+If you want to reproduce the per-world-playerlist feature but with layouts, you can use relational conditions to check the viewer's world (`%viewer:world%`) with the target player's world (`%world%`) like so:
+```yml
+layout:
+  enabled: true
+  direction: COLUMNS
+  default-skin: mineskin:383747683
+  enable-remaining-players-text: true
+  remaining-players-text: '... and %s more'
+  empty-slot-ping-value: 1000
+  layouts:
+    default:
+      slot-count: 80
+      fixed-slots:
+        - '1|&3Website&f:'
+        - '2|&bmyserver.net'
+        - '3|&8&m                       '
+        - '4|&3Name&f:'
+        - '5|&b%player%'
+        - '7|&3Rank&f:'
+        - '8|Rank: %group%'
+        - '10|&3World&f:'
+        - '11|&b%world%'
+        - '13|&3Time&f:'
+        - '14|&b%time%'
+        - '21|&3Teamspeak&f:'
+        - '22|&bts.myserver.net'
+        - '23|&8&m                       '
+        - '41|&3Store&f:'
+        - '42|&bshop.myserver.net'
+        - '43|&8&m                       '
+      groups:
+        players:
+          display-condition: "%viewer:world%=%world%"
+          slots:
+            - 24-40
+            - 44-80
+```
+> [!NOTE]
+> This is just an example, relational conditions are not limited to displaying only players in your world.
+> If you want players in your server on proxy, use `%viewer:server%=%server%` in `display-condition`.
+> This works for any placeholder offered by TAB or by PlaceholderAPI.
@@ -0,0 +1,39 @@
+# Enabling
+Find this section in your config:
+```
+proxy-support:
+  enabled: true
+  # Supported types: PLUGIN, REDIS, RABBITMQ
+  type: PLUGIN
+  plugin:
+    # Compatible plugins: RedisBungee
+    # If enabled and compatible plugin is found, hook is enabled to work with proxied players
+    name: RedisBungee
+  redis:
+    url: 'redis://:password@localhost:6379/0'
+  rabbitmq:
+    exchange: 'plugin'
+    url: 'amqp://guest:guest@localhost:5672/%2F'
+```
+Pick your desired way and configure it. I don't know anything about redis or rabbitmq, so good luck.
+
+> [!IMPORTANT]
+> **BACKEND INSTALLATION ONLY**  
+> You should also add this into your **config.yml** and configure it:
+> ```
+> server-name: "server"
+> ```
+> Ideally, name it the same as servers in your proxy config. This value will be used for getting player's server name. Aside from %server% placeholder, it will be used for internal logic when checking for player's server. One of them is global playerlist not adding/removing players who are on the same server in the tablist, as backend servers already do this (and duplicating actions would cause problems).  
+> **As a result, not configuring this value will result in everyone's server being "N/A", therefore global playerlist will think everyone is on the same server and not add anyone into the tablist, effectively making the feature not work.**
+
+Supported plugins:
+* [RedisBungee](https://github.com/ProxioDev/RedisBungee)
+
+# Supported features
+* [Belowname](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Belowname)
+* [Global playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist)
+* [Nametags](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Nametags) & [Sorting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Sorting-players-in-tablist)
+* [Tablist name formatting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Tablist-name-formatting)
+* [Playerlist Objective](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Playerlist-Objective)
+
+The hook does not and will never support [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout), which would require drastic changes to the feature itself and wouldn't be worth it, since the amount of visible players is usually even lower due to fixed slots and RedisBungee is used on networks with many players, so there will be enough players to work with anyway.
@@ -1,24 +1,32 @@
 # Content
 * [About](#about)
 * [Configuration](#configuration)
-  * [Groups and users](#groups-and-users)
-  * [Per-world / per-server](#per-world--per-server)
-  * [Priority system](#priority-system)
-  * [Placeholder support](#placeholder-support)
-  * [Additional settings](#additional-settings)
-* [Tips & Tricks](#tips--tricks)
+  * [config.yml](#configyml)
+  * [groups.yml and users.yml](#groupsyml-and-usersyml)
+    * [Global settings](#global-settings)
+    * [Per-world / per-server](#per-world--per-server)
+    * [Priorities](#priorities)
+  * [Name color](#name-color)
+* [Commands](#commands)
+* [Placeholders](#placeholders)
 * [Limitations](#limitations)
+* [Compatibility with other plugins](#compatibility-with-other-plugins)
 * [Additional info](#additional-info)
  * [Additional note 1 - NPC (in)compatibility](#additional-note-1---npc-incompatibility)
  * [Additional note 2 - Prefix/suffix on pets](#additional-note-2---prefixsuffix-on-pets)
  * [Additional note 3 - Changing name itself](#additional-note-3---changing-name-itself)
  * [Additional note 4 - F1 view](#additional-note-4---f1-view)
  * [Additional note 5 - Transparent players](#additional-note-5---transparent-players)
+  * [Additional note 6 - Vanish hook](#additional-note-6---vanish-hook)
+* ~Troubleshooting~
 * [API](#api)
  * [Changing prefix and suffix](#changing-prefix-and-suffix)
  * [Collision](#collision)
  * [Manipulating visibility](#manipulating-visibility)
  * [Disabling team handling](#disabling-team-handling)
+* [Examples](#examples)
+  * [Example 1 - Taking prefix/suffix from permission plugin](#example-1---taking-prefixsuffix-from-permission-plugin)
+  * [Example 2 - Making nametags invisible on a subserver](#example-2---making-nametags-invisible-on-a-subserver)

 # About
 Nametags are controlled by a feature called scoreboard teams. They offer 6 properties:
@@ -28,13 +36,37 @@ Nametags are controlled by a feature called scoreboard teams. They offer 6 prope
 * Nametag visibility rule
 * Collision rule
 * Team color (1.13+) - used to set name and glow color (check out [How to make TAB compatible with glow plugins](https://github.com/NEZNAMY/TAB/wiki/How-to-make-TAB-compatible-with-glow-plugins)) (on 1.12- it uses last color of prefix).
+* Options - AllowFriendlyFire and CanSeeFriendlyInvisibles

 When enabling this feature, TAB will control all of these. It is not possible to take values from 2 different teams (plugins). Most of the compatibility problems with other plugins can be solved with placeholders. If you want sorting but not nametags, just don't configure any prefix/suffix. If you want another plugin to handle teams, configure sorting in that plugin.

-This feature can be configured in **config.yml** under **scoreboard-teams** section.
-
 # Configuration
-## Groups and users
+This feature is configured in 2 parts based on what you are configuring. Most settings are in the **config.yml**, but prefix/suffix is configured in **groups.yml** and **users.yml**.
+## config.yml
+The first part can be configured in **config.yml** under **scoreboard-teams** section. It controls everything except prefix and suffix.
+
+This is how the default configuration looks (excluding sorting options):
+```
+scoreboard-teams:
+  enabled: true
+  enable-collision: true
+  invisible-nametags: false
+  can-see-friendly-invisibles: false
+  disable-condition: '%world%=disabledworld'
+```
+All of the options are explained in the following table.  
+| Option name                 | Default value         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+|-----------------------------|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| enabled                     | true                  | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| enable-collision            | true                  | Controls collision rule. Available values are: <br />- `true` - Collision will be enabled permanently. <br />- `false` - Collision will be disabled permanently. <br /> - *Conditional expression* - Collision will be enabled if player meets the [short format](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders#short-format) conditional expression (for example `%world%=world` will result in collision only being enabled for players in world `world`). <br /> - *Condition name* - Uses name of a [defined condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for a player to have collision enabled.                                                                                        |
+| invisible-nametags          | false                 | Controls nametags visibility rule. Available values are: <br />- `true` - Nametags will be invisible. <br />- `false` - Nametags will be visible. <br /> - *Conditional expression* - Nametags will be invisible if player meets the [short format](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders#short-format) conditional expression. <br /> - *Condition name* - Uses name of a [defined condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders). <br /> Option to hide nametags was added in Minecraft **1.8**, therefore it will not work on 1.7. |
+| can-see-friendly-invisibles | false                 | Controls value of the team flag. It allows you to see invisible players in the same team as transparent instead of completely invisible. Since TAB places each player into an individual team, this option will only take effect in combination with plugins that spawn a dummy clone of the player (sit or disguise plugins).                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| disable-condition           | %world%=disabledworld | A [condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for disabling the feature for players. Set to empty for not disabling the feature ever.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+
+## groups.yml and users.yml
+This part allows you to configure prefix and suffix. They are called `tagprefix` and `tagsuffix`, where "tag" refers to name tag, to allow separation from tablist settings.
+
+### Global settings
 Properties can be applied in 2 ways: groups and users. Users can be defined by both username and their UUID. Values applied to users take priority over groups.

 **groups.yml**
@@ -42,8 +74,7 @@ Properties can be applied in 2 ways: groups and users. Users can be defined by b
 admin:
  tagprefix: "&4&lAdmin &r"
 ```
-
-This can also be achieved with commands, in this case `/tab group admin tagprefix "&4&lAdmin &r"`.
+Or with an in-game command `/tab group admin tagprefix "&4&lAdmin &r"`.

 **users.yml**
 ```
@@ -54,11 +85,11 @@ _NEZNAMY_:
 237d8b55-3f97-4749-aa60-e9fe97b45062:
  tagprefix: "&6&lTAB &r"
 ```
-This can also be achieved with commands, in this case `/tab player _NEZNAMY_ tagprefix "&4&lAdmin &r"` or `/tab playeruuid _NEZNAMY_ tagprefix "&4&lAdmin &r"`.
+Or with in-game commands `/tab player _NEZNAMY_ tagprefix "&6&lTAB &r"` and `/tab playeruuid _NEZNAMY_ tagprefix "&6&lTAB &r"` (the player must be online for uuid option to work).

 Properties can also be set as "default" for everyone who does not have them defined.
-For that purpose, a group keyword `_DEFAULT_` was made.
-Example:
+For that purpose, a group keyword `_DEFAULT_` was made.  
+Example:  
 **groups.yml**
 ```
 admin:
@@ -67,8 +98,8 @@ _DEFAULT_:
  tagprefix: "&7" # This will be displayed on everyone except admin
 ```

-## Per-world / per-server
-Values can also be applied per-world (and per-server on bungeecord), where they can be defined per group/user. These values take priority over global settings. Example:  
+### Per-world / per-server
+Values can also be applied per-world (and per-server on a proxy), where they can be defined per group/user. These values take priority over global settings. Example:  
 **groups.yml**
 ```
 per-world:
@@ -94,8 +125,8 @@ per-world:
      tagsuffix: "Suffix in all worlds starting with lobby-"
 ```

-## Priority system
-The full list of priorities looks like this:
+### Priorities
+The full list of priorities to choose correct prefix/suffix for a player looks like this:
 1. value set using the [API](#api)
 2. per-world / per-server applied to username
 3. value applied to username
@@ -111,57 +142,65 @@ This list is browsed through until the first match is found. If no match is foun
 Values are taken independently of each other.
 This means you can set per-world tagprefix, but only keep one global tagsuffix, for example.

-You can see the source of a value displayed on player by using `/tab debug <player>` and checking "source"
-part of the value you are looking for.
+You can see the source of a value displayed on player by using `/tab dump <player>`, opening the link and checking "source"
+part of the value you are looking for (tagprefix / tagsuffix).

-## Placeholder support
-All values fully support [TAB's internal placeholders](https://github.com/NEZNAMY/TAB/wiki/Placeholders#internal-placeholders) and [PlaceholderAPI placeholders](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders) including relational placeholders.
-The number of placeholders is not limited, and they can be used in combination with static text as well.
+## Name color
+On versions 1.12.2 and below, name color follows the last color of prefix. This also includes magic codes. On 1.13+, this is no longer the case. Instead, a new field called "team color" was created. This is an enum constant, where we need to pick from 22 options - 16 colors, 5 magic codes and reset. **As you can see, it doesn't allow for RGB colors**. This also means name can no longer have color and magic codes simultaneously.

-## Additional settings
-| Option name                 | Default value         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-|-----------------------------|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| enabled                     | true                  | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| enable-collision            | true                  | Controls collision rule. Available values are: <br />- `true` - Collision will be enabled permanently. <br />- `false` - Collision will be disabled permanently. <br /> - *Conditional expression* - Collision will be enabled if player meets the condition (for example `%world%=world` will result in collision only being enabled for players in world `world`). <br /> - *Condition name* - Uses name of a [defined condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for a player to have collision enabled. |
-| invisible-nametags          | false                 | When enabled, everyone will have invisible nametag all the time. Option to hide nametags was added in minecraft **1.8**, therefore it will not work on 1.7 and lower.                                                                                                                                                                                                                                                                                                                                                                                                     |
-| anti-override               | true                  | While enabled, prevents other plugins from assigning online players into teams and making TAB not work correctly. They should be configured to not use teams, however many users fail to disable features in other plugins that they don't want, making this option required. Some plugins don't even say they use teams to achieve their goals. Did you know even Paper uses teams?                                                                                                                                                                                      |
-| can-see-friendly-invisibles | false                 | Controlling value of the team flag. It allows you to see invisible players in the same team as transparent instead of completely invisible. Since TAB places each player into an individual team, this option will only take effect in combination with plugins that spawn a dummy clone of the player (sit or disguise plugins).                                                                                                                                                                                                                                         |
-| disable-condition           | %world%=disabledworld | A [condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for disabling the feature for players. Set to empty for not disabling the feature ever.                                                                                                                                                                                                                                                                                                                                                                       |
+TAB does not have an option for configuring team color to avoid complexity, such as per-version configuration, or having to configure an additional field.
+For that reason, TAB detects the last used color code and uses that for team color.
+> [!CAUTION]
+> An exception is when using MiniMessage syntax / using RGB codes on server which has MiniMessage library. In this scenario, it is not possible to detect reset (`&r`) as last used "color", because in Minecraft components it is not a color, rather, it resets formatting by setting all magic codes to false / color to null. If you use `&r` (`<reset>`) and notice it not working, replace it with `&f` (`<white>`) (or add it after the reset to be safe). There seems to be no difference between setting color to `WHITE` versus `RESET`.

-# Tips & Tricks
-If you want TAB to only take prefixes/suffixes from the permission plugin,
-delete all groups from **groups.yml** and only keep this:
-```
-_DEFAULT_:
-  tagprefix: "%luckperms-prefix%"
-  tagsuffix: "%luckperms-suffix%"
-```
+# Commands
+| Command                                                            | Permission                                                                                 | Description                                                                                                                                                                                                |
+|--------------------------------------------------------------------|--------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| /tab nametag <show/hide/toggle> \[player\] \[viewer\] \[options\]  | `tab.nametag.visibility` (for yourself) <br /> `tab.nametag.visibility.other` (for others) | Shows / hides / toggles nametag of a specified player. If viewer is specified, view is only affected for the viewer. You can use `-s` as option for silent toggling (no chat message for affected player). |
+| /tab nametag <showview/hideview/toggleview> \[viewer\] \[options\] | `tab.nametag.view` (for yourself) <br /> `tab.nametag.view.other` (for others)             | Shows / hides / toggles nametag VIEW a specified player. You can use `-s` as option for silent toggling (no chat message for affected player)                                                              |
+| /tab setcollision \<player\> \<true\|false\>                       | `tab.setcollision`                                                                         | Forces collision rule for specified player, overriding configuration.                                                                                                                                      |
+
+# Placeholders
+Here are TAB's PlaceholderAPI placeholders you can use when this feature is enabled:
+| Placeholder | Description |
+|-------------|-------------|
+| `%tab_tagprefix%` | Player's current tagprefix with placeholders parsed. |
+| `%tab_tagsuffix%` | Player's current tagprefix with placeholders parsed. |
+| `%tab_tagprefix_raw%` | Player's current raw tagprefix with placeholder identifiers. |
+| `%tab_tagsuffix_raw%` | Player's current raw tagsuffix with placeholder identifiers. |
+| `%tab_nametag_visibility%` | "Enabled" if player can see nametags, "Disabled" if disabled using `/tab nametag toggleview` |

 # Limitations
-* [1.5 - 1.12.2] Prefix/suffix length is limited to 16 characters (including color codes).
-* [1.13+] The name can only have one code. That is either color or magic code (such as &4 or &l), but not both.
-* The name cannot be effectively changed and the plugin doesn't offer it.
-* Name does not support RGB codes. Any used RGB colors will be rounded to the nearest legacy code.
+* [1.12.2-] Prefix/suffix length is limited to 16 characters (including color codes). Any characters beyond that will be cut to prevent players getting disconnected.
+* [1.13+] Name color is controlled by a chat format enum constant. This means:
+  * Name can only have one code. That is either color or magic code (such as &4 or &l), but not both.
+  * Name does not support RGB codes. Any used RGB colors will be rounded to the nearest legacy code.
 * The same value manages name color and glow color, which means they cannot be different.
+* The name cannot be effectively changed and the plugin doesn't offer it.
+
+If you want to avoid these at all costs, the only way is to create entities (armor stands / display) and make them ride the player (or teleport). TAB no longer offers this functionality due to a large amount of unfixable issues (full thread [here](https://gist.github.com/NEZNAMY/f4cabf2fd9251a836b5eb877720dee5c/)). You can, however, check out these 3rd party plugins (**not affiliated with me in any way, use at your own risk**):
+* [UnlimitedNameTags](https://www.spigotmc.org/resources/unlimitednametags.117526/)
+* [DisplayNameTags](https://github.com/Matt-MX/DisplayNameTags)
+* [NotJustNamePlates](https://github.com/YouHaveTrouble/NotJustNameplates)
+* [CustomNameplates](https://polymart.org/product/2543/customnameplates)
+
+# Compatibility with other plugins
+Scoreboard teams is a feature that cannot be handled by multiple plugins at once.
+To make sure no other plugin sends their own teams when not disabled in the plugin's config properly, TAB will block players being added into teams coming from all other plugins (if this feature is enabled and not disabled for a player with a condition).

 # Additional info
 ## Additional note 1 - NPC (in)compatibility
-Teams are bound to player names, not uuids or entity ids.
+Teams are bound to player names, not UUIDs or entity ids.
 Because of that, they will affect all player entities with that name.
 This includes NPCs with the same names as online players, and prefixes/suffixes will be displayed on those as well.
 To avoid it, make their names not match any online player and use holograms to display them instead
 (Citizens plugin has an option for this).

 ## Additional note 2 - Prefix/suffix on pets
-Since 1.9 teams affect tamed animals as well, displaying prefix/suffix on them as well and if nametags are set to be invisible, they will be completely invisible as well. If you want to avoid it, install [this plugin](https://www.spigotmc.org/resources/109466/).
+Since Minecraft 1.9, teams affect tamed animals as well, displaying prefix/suffix on them as well and if nametags are set to be invisible, they will be completely invisible as well. If you want to avoid it, install [this plugin](https://www.spigotmc.org/resources/109466/).

 ## Additional note 3 - Changing name itself
-Teams do not allow to change the nametag name itself.
-Changing name is a complicated process which is slightly out of scope of the plugin as well,
-this is what nick plugins are about.
-On top of that, it's a pain
-requiring a ton of different packets which change their structure every version and with how many versions the plugin supports,
-it doesn't sound like fun doing.
+Teams do not allow to change the nametag name itself and TAB does not offer this functionality in any (other) way. For more information, see [How to display name from nickname plugins - Nametag](https://github.com/NEZNAMY/TAB/wiki/How-to-display-name-from-nickname-plugins#nametag).

 ## Additional note 4 - F1 view
 Using teams causes player nametags to remain visible when using F1 view.
@@ -183,6 +222,14 @@ scoreboard-teams:
 ```
 In config.yml. Keep in mind, you'll not be able to use any team features if you do so.

+## Additional note 6 - Vanish hook
+When a player is [vanished](https://github.com/NEZNAMY/TAB/wiki/Additional-information#vanish-detection), their team is unregistered for all other players who do **not** have `tab.seevanished` permission.
+
+The purpose of this is to avoid players figuring out a staff member is still online but just vanished by "checking" registered teams and their members.
+An example of "exploiting" this is to have a 3rd party client spawn a player entity with name of a chosen player (staff member) and seeing if their name is formatted (= team is registered = player is online) or not (offline).
+
+For this reason, make sure you give all of your staff members who can see vanished players the `tab.seevanished` permission, otherwise the vanished player will appear on top of the tablist (players without team are above players with team) and their nametag will not be formatted.
+
 # API
 *To get started with the API, see [Developer API](https://github.com/NEZNAMY/TAB/wiki/Developer-API) page.*

@@ -192,15 +239,18 @@ To access this feature, you'll need to obtain `NameTagManager` instance. Get it
 To set the values for the respective formatting, use the following:
 * `NameTagManager#setPrefix(TabPlayer, String)`
 * `NameTagManager#setSuffix(TabPlayer, String)`
-  To reset them, set values to `null`.
+
+To reset them, set values to `null`.

 To get custom values previously set using the API (they will return `null` if no custom value is set):
 * `NameTagManager#getCustomPrefix(TabPlayer)`
 * `NameTagManager#getCustomSuffix(TabPlayer)`

 To get the original value set by the plugin based on configuration:
-* `NameTagManager#getOriginalPrefix(TabPlayer)`
-* `NameTagManager#getOriginalSuffix(TabPlayer)`
+* `NameTagManager#getOriginalRawPrefix(TabPlayer)` - Prefix with raw placeholder identifiers
+* `NameTagManager#getOriginalRawSuffix(TabPlayer)` - Suffix with raw placeholder identifiers
+* `NameTagManager#getOriginalReplacedPrefix(TabPlayer)` - Prefix with all placeholders parsed
+* `NameTagManager#getOriginalReplacedSuffix(TabPlayer)` - Suffix with all placeholders parsed

 > [!NOTE]
 > These values are only temporary,
@@ -209,8 +259,8 @@ To get the original value set by the plugin based on configuration:
 > use [commands](https://github.com/NEZNAMY/TAB/wiki/Commands-&-Permissions#tab-playergroupplayeruuid-name-property-value-options).

 ## Collision
-* `NameTagManager#getCollisionRule(TabPlayer)` - Returns forced collision rule using the API, `null` if no value was forced and player follows the configuration.
 * `NameTagManager#setCollisionRule(TabPlayer, Boolean)` - Forces collision rule to the player. Use `null` to reset value and make it follow configuration again.
+* `NameTagManager#getCollisionRule(TabPlayer)` - Returns forced collision rule using the API, `null` if no value was forced and player follows the configuration.

 ## Manipulating visibility
 * `NameTagManager#hideNametag(TabPlayer)` - Hides player's nametag from all players
@@ -223,4 +273,34 @@ To get the original value set by the plugin based on configuration:
 ## Disabling team handling
 * `NameTagManager#pauseTeamHandling(TabPlayer)` - Pauses team handling for a specific player. This will unregister the player's team and disable anti-override for teams.
 * `NameTagManager#resumeTeamHandling(TabPlayer)` - Resumes team handling for a specific player. This will register the player's team and enable anti-override for teams.
-* `NameTagManager#hasTeamHandlingPaused(TabPlayer)` - Returns `true` if handling is disabled using methods above, `false` if not.
+* `NameTagManager#hasTeamHandlingPaused(TabPlayer)` - Returns `true` if handling is disabled using methods above, `false` if not.
+
+# Examples
+## Example 1 - Taking prefix/suffix from permission plugin
+If you want TAB to only take prefixes/suffixes from the permission plugin,
+delete all groups from **groups.yml** and only keep this:
+```
+_DEFAULT_:
+  tagprefix: "%luckperms-prefix%"
+  tagsuffix: "%luckperms-suffix%"
+```
+Or a PlaceholderAPI placeholder from your permission plugin if you use a different one.
+
+> [!NOTE]
+> When doing this, make sure you don't delete something you didn't mean to delete, for example ta**b**prefix and ta**b**suffix from tablist name formatting feature.
+
+## Example 2 - Making nametags invisible on a subserver
+The config option `invisible-nametags` takes either a [condition or a conditional expression](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders).  
+We can use short format `%server%=<server name>`. If the server name is `server1`, it will look like this:
+```
+  invisible-nametags: "%server%=server1"
+```
+If we want to disable it in 2 servers, we separate them with `|` (OR). Result:
+```
+  invisible-nametags: "%server%=server1|%server%=server2"
+```
+
+> [!NOTE]
+> This is just an example, the plugin is not limited to making nametags invisible only based on server.
+> If you want to disable them in a world, use %world% with world name(s).
+> This works for any placeholder offered by TAB or by PlaceholderAPI.
@@ -2,11 +2,20 @@
 * [About](#about)
 * [Configuration](#configuration)
  * [Grouping playerlist from multiple worlds](#grouping-playerlist-from-multiple-worlds)
+    * [Pattern Matching](#pattern-matching)
+* ~Commands~
+* ~Placeholders~
+* ~Limitations~
+* ~Compatibility with other plugins~
+* ~Additional Info~
+* ~Troubleshooting~
+* ~API~
+* ~Examples~

 # About
 This feature allows you to limit players you see in tablist to only players in your world, or in a group of worlds.  
 This feature can be configured in **config.yml** under **per-world-playerlist** section.  
-To use it, you need TAB installed on bukkit server. This feature is not available on BungeeCord.
+To use it, you need TAB installed on Bukkit server. This feature is not available on any other platform.

 # Configuration
 | Option name                    | Default value | Description                                                                                                 |
@@ -32,4 +41,34 @@ Contains 2 groups, each of them consisting of 2 worlds.
 World group name can be anything (in our case, they're called "lobby" and "minigames").
 Under group name, list the actual world names.

-With this setup, "lobby1" and "lobby2" will share playerlist, as well as "paintball" with "bedwars". All other worlds will have playerlist not shared with any other worlds. Creating a group for 1 world only is completely useless.  
+With this setup, "lobby1" and "lobby2" will share playerlist, as well as "paintball" with "bedwars". All other worlds will have playerlist not shared with any other worlds. Creating a group for 1 world only is completely useless.
+
+### Pattern Matching
+World names in groups support multiple pattern types for flexible configuration:
+
+**Exact Match** - Matches server name exactly:
+```yaml
+  shared-playerlist-world-groups:
+    worlds:
+      - world1
+      - world2
+```
+
+**Wildcard Patterns** - Use `*` for prefix or suffix matching:
+```yaml
+  shared-playerlist-world-groups:
+    worlds:
+      - "World-*"      # Matches: World-1, World-2, World-Hub, etc.
+      - "*-world"      # Matches: eu-world, us-world, etc.
+```
+
+**Regex Patterns** - Use `regex:` prefix for advanced pattern matching:
+```yaml
+  shared-playerlist-world-groups:
+    worlds:
+      - regex:World-[0-9]+        # Matches: World-1, World-23, but not World-Hub
+    smp:
+      - regex:SMP-(EU|US)-[0-9]+  # Matches: SMP-EU-1, SMP-US-2, etc.
+```
+
+Note: Wildcard patterns are case-insensitive, while regex patterns are case-sensitive by default (use `(?i)` flag for case-insensitive regex).
@@ -11,6 +11,7 @@
    * [Example 1 - Adding brackets to placeholder output if it returns non-empty value](#example-1---adding-brackets-to-placeholder-output-if-it-returns-non-empty-value)
    * [Example 2 - Replicating PlaceholderAPI's %player_colored_ping%](#example-2---replicating-placeholderapis-player_colored_ping)
    * [Example 3 - Using both original and replaced output](#example-3---using-both-original-and-replaced-output)
+    * [Example 4 - Replacing identifier with custom text](#example-4---replacing-identifier-with-custom-text)

 # About
 Most placeholders don't have fully configurable output, making you unable to customize it as you'd like.
@@ -51,8 +52,8 @@ placeholder-output-replacements:
 > [!NOTE]
 > The text must match exactly, including color codes.
 > To check the color codes a placeholder returns use
-> [`/tab parse <player> <placeholder>`](https://github.com/NEZNAMY/TAB/wiki/Commands-&-Permissions#tab-parse-text)
-> and check "Without colors" part.
+> [`/tab parse <player> <placeholder>`](https://github.com/NEZNAMY/TAB/wiki/Commands-&-Permissions#tab-parse-player-text)
+> and check "Raw colors" part.

 ### Pattern 2: Number intervals
 Output will be replaced if it's numeric and belongs in a configured interval.
@@ -168,7 +169,7 @@ and you'll need
 to use [Conditional placeholders](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) instead
 to achieve colored ping.

-# Example 3 - Using both original and replaced output
+## Example 3 - Using both original and replaced output
 Once configured, replacements are applied as the placeholder output everywhere. It is not directly possible to use original output in one place and replaced in another.

 If you need this, you should consider [conditional placeholders](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) instead.  
@@ -193,4 +194,16 @@ placeholder-output-replacements:
 ```
 Now, you can use `%ping%` for original output and `%animation:ping%` for replaced.

-</details>
+</details>
+
+## Example 4 - Replacing identifier with custom text
+Sometimes a placeholder doesn't parse and instead returns the identifier itself (such as on proxy installation before Bridge responds back with placeholder values), but you want to display some default value to avoid issues (ugly text, warnings in console if used in sorting or conditions).
+
+This can be achieved in the following way:
+
+```
+placeholder-output-replacements:
+  "%my_placeholder%":
+    "%my_placeholder%": "Loading..."
+```
+If the placeholder is used in numeric sorting for example, you can make it default to `0` or anything else you need at the time.
@@ -1,12 +1,21 @@
 # Content
 * [About](#about)
 * [Configuration](#configuration)
+* ~Commands~
+* ~Placeholders~
 * [Limitations](#limitations)
+* [Compatibility with other plugins](#compatibility-with-other-plugins)
 * [Additional info](#additional-info)
  * [Additional note 1 - Spectator gamemode](#additional-note-1---spectator-gamemode)
+* [Troubleshooting](#troubleshooting)
+* ~API~
+* [Examples](#examples)
+  * [Example 1 - Per-world values](#example-1---per-world-values)
+  * [Example 2 - Displaying hearts](#example-2---displaying-hearts)

 # About
-The scoreboard objective with PLAYER_LIST display slot. On 1.20.2- it supports 2 display types:
+This features gives you control over Minecraft's scoreboard objective feature with PLAYER_LIST slot.
+On 1.20.2- it supports 2 display types:
 * yellow number  
  ![](https://images-ext-1.discordapp.net/external/ioDTFWFe9qUGg8ZgNFCPIoXN6B-EnbqHb0WXE9200a8/https/image.prntscr.com/image/w8sjR4y9QhuaEcnU5tGTmw.png)
 * hearts  
@@ -15,20 +24,111 @@ The scoreboard objective with PLAYER_LIST display slot. On 1.20.2- it supports 2
 Since 1.20.3, it can display any text.  
 ![image](https://github.com/NEZNAMY/TAB/assets/6338394/2300b73e-d0cb-4eec-8ff1-e16be60bba49)

-This feature can be configured in **config.yml** under **playerlist-objective** section.
-
 # Configuration
-| Option name       | Default value         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
-|-------------------|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| enabled           | true                  | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| value             | "%ping%"              | [1.20.2-] Defines value displayed. You can set this to any placeholder that outputs a number. Setting value to `%health%`, `%player_health%` or `%player_health_rounded%` will result in the display type being changed to hearts instead of number. If you want to display health but as a number and not hearts, set value to `0%health%` for example. Only visible on 1.20.2 and lower. <br/> **Note**: Even if you only support 1.20.3+, you still need to configure this value to properly evaluate to a number, because the value is still sent to the client (just not displayed). You can set it to `0` for simplicity. |
-| fancy-value       | "&7Ping: %ping%"      | [1.20.3+] Value to display for 1.20.3+ clients. Supports any text.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| disable-condition | %world%=disabledworld | A [condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for disabling the feature for players. Set to empty for not disabling the feature ever.                                                                                                                                                                                                                                                                                                                                                                                                                             |
+The feature can be configured in **config.yml** under **playerlist-objective** section.  
+This is how the default configuration looks:
+```
+playerlist-objective:
+  enabled: true
+  value: "%ping%"
+  fancy-value: "&7Ping: %ping%"
+  title: "TAB" # Only visible on Bedrock Edition
+  render-type: INTEGER
+  disable-condition: '%world%=disabledworld'
+```
+All of the options are explained in the following table.
+| Option name       | Default value         | Description                                                                                                                                                                                                                                                                                                                                                          |
+|-------------------|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| enabled           | true                  | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                       |
+| value             | "%ping%"              | [1.20.2-] An integer from -2147483648 to 2147483647, doesn't support decimal values. The number is always yellow. Supports placeholders with player-specific output, such as player health. Only visible on 1.20.2 and lower (unless you set `render-type` to `HEARTS`). <br/> **Note**: Even if you only support 1.20.3+, you still need to configure this value to properly evaluate to a number, because the value is still sent to the client (just not displayed). You can set it to `0` for simplicity. |
+| fancy-value       | "&7Ping: %ping%"      | [1.20.3+] Any text, supports placeholders with per-player output. Only visible on 1.20.3+, where it completely replaces `value`, or if `render-type` is set to `HEARTS`.                                                                                                                                                                                                                                                                                                   |
+| title             | "TAB"                 | Title to send. Only visible on Bedrock Edition.                                                                                                                                                                                                                                                                                                                      |
+| render-type       | INTEGER               | Render type of the value. Supported values are `INTEGER` and `HEARTS`. <br />When set to `HEARTS`, the `value` is used displayed even on 1.20.3+, where `fancy-value` is ignored.                                                                                                                                                                                                                                                                                                 |
+| disable-condition | %world%=disabledworld | A [condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) (either name of a condition or a conditional expression) that must be met for disabling the feature for players. Set to empty for not disabling the feature ever. <br/> **Note**: Disabling the feature for a player means sending objective unregister packet to them, which results in player not seeing the feature on anyone anymore. It doesn't work the other way around - you cannot disable this feature on target players, only for viewers.                                                                                                                                                                  |

 # Limitations
-* [1.5 - 1.20.2] Only 2 display types are supported - yellow number and hearts.
-* [1.5 - 1.20.2] A yellow 0 will appear on all tablist entries that aren't actual players (such as NPCs and [layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) entries) and it cannot be removed.
+* [1.20.2-] Only 2 display types are supported - yellow number and hearts.
+* [1.20.2-] A yellow 0 will appear on all tablist entries that aren't actual players (such as NPCs and [layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) entries) and it cannot be removed.
+
+# Compatibility with other plugins
+TAB does not contain any sort of compatibility functionality for this feature.
+It will not try to prevent other plugins from applying the feature and neither will it detect it to re-add back once the other plugin removes it.
+Therefore, if another plugin also sends playerlist objective, TAB's may not show anymore (depending on who sends it first).
+Make sure you do not have any other plugin sending it to ensure the feature works properly.
+
+You can check the list of objectives registered by either commands or plugins using Bukkit API using `/scoreboard objectives list`.  
+If it contains one that could be the cause, you can unregister it by running `/scoreboard objectives remove <name>`. After doing so, reload TAB, so it resends its objectives again.  
+Note that if this was automatically generated by a plugin, it will probably be added back again.

 # Additional info
 ## Additional note 1 - Spectator gamemode
-The feature will not be visible on players with spectator gamemode. To resolve this, check out [Spectator fix](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Spectator-fix) feature.  
+The feature will not be visible on players with spectator gamemode. To resolve this, check out [Spectator fix](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Spectator-fix) feature.
+
+# Troubleshooting
+This is a collection of tips to help you figure out why the feature isn't working as you expect.  
+To get started, run `/tab dump <any player>` (this feature doesn't contain per-player content in dump output) and open the generated link. Scroll down to `features` -> `PlayerlistObjective` and check the content:
+* If it says `PlayerlistObjective: Feature is disabled`, it means you disabled the feature. Enable it by setting
+  ```
+  playerlist-objective:
+    enabled: true
+  ```
+* Check the `configuration` section and compare it with your config file. If it's different, you either forgot to reload TAB, or uploaded the config to the wrong server (or did not upload it at all).
+* If a player cannot see playerlist objective on anyone, check the table of players and make sure it's not because `Disabled with condition` is `true`.
+* Check the table of players for `value`, `fancy-value` and `title` and make sure they match your expectations. Don't forget `value` only supports numbers.
+* If you want to see `fancy-value` instead of just `value`'s number:
+  * Make sure your client is on 1.20.3+.
+  * Make sure your server is on 1.20.3+ (using TAB on proxy counts as being latest).
+  * Make sure you are not using a 3rd party client that removed this feature from 1.20.3+, such as Lunar or Feather.
+* If you have TAB on Velocity, install [VelocityScoreboardAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/releases) (and make sure it is not outdated).
+
+# Examples
+## Example 1 - Per-world values
+This feature doesn't directly support per-world values or similar.
+However, this can be achieved with conditions.
+Let's make `fancy-value` conditional based on player's world.
+Let's make an example with 3 worlds.
+Check if player is in world `world1`, then show one text.
+If not, check if player is in world `world2`, then show another text.
+If not, show the final text.
+This can be achieved by chaining 2 conditions:
+```
+conditions:
+  playerlist1:
+    conditions:
+    - "%world%=world1"
+    true: "Text to display in world world1" # Player is in world world1, display the text
+    false: "%condition:playerlist2%" # Player is not in world world1, check another condition
+  playerlist2:
+    conditions:
+    - "%world%=world2"
+    true: "Text to display in world world2" # Player is in world world2, display the text
+    false: "Text to display in other worlds" # Player is not in any of the 2 worlds
+```
+> [!WARNING]
+> DO NOT JUST RANDOMLY PASTE THIS ENTIRE "CONDITIONS" SECTION INTO YOUR CONFIG!
+> INSTEAD, EDIT YOUR EXISTING CONDITIONS SECTION TO PREVENT HAVING THE SECTION TWICE,
+> HAVING SECOND ONE COMPLETELY OVERRIDE THE FIRST ONE!
+
+Finally, use this condition as value in `fancy-value`:
+```
+playerlist-objective:
+  fancy-value: "%condition:playerlist1%"
+```
+
+> [!NOTE]
+> This is just an example, the plugin is not limited to displaying different values only per world.
+> If you want per server values on proxy, use %server% with server names.
+> This works for any placeholder offered by TAB or by PlaceholderAPI.
+
+## Example 2 - Displaying hearts
+In order to display the value as hearts, set `render-type` to `HEARTS`.  
+Then, set `value` to a placeholder that returns player's health. If you have TAB on a backend server, use `%health%`. If you have TAB on a proxy, use PlaceholderAPI's `%player_health_rounded%`.  
+Example configuration:
+
+```
+  value: "%health%"
+  render-type: HEARTS
+```
+When using `HEARTS` render type, `fancy-value` is not displayed by the client, so it doesn't matter what it is set to.  
+Final result:  
+![](https://images-ext-2.discordapp.net/external/RxWu_5hBSLUWqS7vCvSPY9PnNxkYfAMQQXwkbi6GEyU/https/image.prntscr.com/image/edpM4XpOT1q3SsQ5vYNjzQ.png)
@@ -1,17 +1,19 @@
 # Content
 * [About](#about)
-* [Creating a scoreboard](#creating-a-scoreboard)
-  * [title](#title)
-  * [lines](#lines)
-    * [Alignment](#alignment)
-    * [Empty placeholder output](#empty-placeholder-output)
-  * [display-condition](#display-condition)
-* [Chaining scoreboards](#chaining-scoreboards)
-* [Announce command](#announce-command)
-* [Additional settings](#additional-settings)
+* [Configuration](#configuration)
+  * [Scoreboard](#scoreboard)
+    * [Line syntax](#line-syntax)
+    * [Hiding a line](#hiding-a-line)
+    * [Longer lines](#longer-lines)
+  * [Chaining scoreboards](#chaining-scoreboards)
+* [Commands](#commands)
+* [Placeholders](#placeholders)
 * [Limitations](#limitations)
-* [Longer lines](#longer-lines)
 * [Compatibility with other plugins](#compatibility-with-other-plugins)
+* [Additional info](#additional-info)
+  * [Additional note 1 - Text alignment](#additional-note-1---text-alignment)
+  * [Additional note 2 - Geyser / Bedrock issues](#additional-note-2---geyser--bedrock-issues)
+* ~Troubleshooting~
 * [API](#api)
  * [Creating custom scoreboards](#creating-custom-scoreboards)
  * [Showing custom scoreboards](#showing-custom-scoreboards)
@@ -21,109 +23,142 @@
  * [Example 1 - Per-world scoreboards](#example-1---per-world-scoreboards)
  * [Example 2 - Periodical scoreboard switching](#example-2---periodical-scoreboard-switching)
  * [Example 3 - Per-version scoreboards](#example-3---per-version-scoreboards)
+  * [Example 4 - Conditional lines](#example-4---conditional-lines)

 # About
-Scoreboard objective with SIDEBAR display slot.
+This features gives you control over Minecraft's scoreboard objective feature with SIDEBAR slot.

-This feature can be configured in **config.yml** under **scoreboard** section.
-
-# Creating a scoreboard
-Scoreboards can be created in `scoreboards` section. You can define as many scoreboards as you want. Each scoreboard can have a condition requirement, which must be met to display the scoreboard. If it's not met, the next defined scoreboard is checked and so on. If the last defined scoreboard has a condition requirement which isn't met, player won't see anything.
-
-Each scoreboard defines up to 3 parameters:
-
-## title
-Title of the scoreboard.
-Limited to 32 characters on MineCraft versions below 1.13 (including color codes).
-It is automatically centered by the client.
-
-## lines
-Up to 15 lines of text. You can define more, but the client won't display them.
-
-Since 1.20.3, you can also configure the value on the right side, which no longer has to be a red number. To set it, use `||` sequence and put right-side text after it. Example:
-```
-      lines:
-      - "Left side text 1||Right side text 1"
-      - "Left side text 2....||Right side text 2...."
-      - "Left side text 3.......||Right side text 3......."
-```
-Will give you the following:  
-![image](https://github.com/NEZNAMY/TAB/assets/6338394/785e4e66-935c-4233-8a16-f3e34386cfd0)
-
-The right side text will not be visible at 1.20.2 and lower, and numbers will be displayed instead.
-To properly see the right side, not only the client has to be 1.20.3+, but the server as well,
-since the plugin cannot send a packet that does not exist (on older versions).
-Proxies always include new content and therefore count as the latest version.
-This can be used to send new content to new players while having an outdated server version.
-
-### Alignment
-The left side of the text is automatically aligned to the left,
-while the right side is automatically aligned to the right.
-This is done by the client and is out of plugin's control.
-If you want to center a line, you'll need to do it manually.
-If dynamic placeholder output length is preventing your from doing it,
-you can try to bypass it by adding spaces before and after it to artificially increase and force the scoreboard width,
-such as
-`- "          Centered text          "` (or more spaces if needed).
-
-### Empty placeholder output
-When a line consists only of a placeholder that returned empty output, the line will be hidden completely. This is intentional to allow dynamic scoreboard size based on placeholder output. This is not the case if empty line is configured (`""`), to allow empty lines in configuration.
-
-## display-condition
-A [condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met to display this scoreboard. If it isn't met for the player, the next scoreboard's condition is checked.
-
-# Chaining scoreboards
-When defining more than 1 scoreboard in config, the plugin will display the correct scoreboard based on conditions.
-The plugin goes through all defined scoreboards, starting with the scoreboard on top.
-If the scoreboard's condition is met or not set, it is displayed.
-If not, the next defined scoreboard is checked and so on.
-If no suitable scoreboard is found (the last one has a condition requirement which wasn't met), none is displayed.
-Example:
+# Configuration
+The feature can be configured in **config.yml** under **scoreboard** section.  
+This is how the default configuration looks:
 ```
+scoreboard:
+  enabled: false
+  toggle-command: /sb
+  remember-toggle-choice: false
+  hidden-by-default: false
+  delay-on-join-milliseconds: 0
  scoreboards:
-    scoreboard1:
-      display-condition: "permission:tab.scoreboard.admin"
-      title: "Title 1"
+    scoreboard-1.20.3+:
+      title: "<#E0B11E>MyServer</#FF0000>"
+      display-condition: "%player-version-id%>=765;%bedrock%=false" # Only display it to players using 1.20.3+ AND NOT bedrock edition
      lines:
-        - "Scoreboard for admins"
-    scoreboard2:
-      display-condition: "%world%=myWorld"
-      title: "Title 2"
+        - "&7%date%"
+        - "%animation:MyAnimation1%"
+        - "&6Online:"
+        - "* &eOnline&7:||%online%"
+        - "* &eCurrent World&7:||%worldonline%"
+        - "* &eStaff&7:||%staffonline%"
+        - ""
+        - "&6Personal Info:"
+        - "* &bRank&7:||%group%"
+        - "* &bPing&7:||%ping%&8ms"
+        - "* &bWorld&7:||%world%"
+        - "%animation:MyAnimation1%"
+    scoreboard:
+      title: "<#E0B11E>MyServer</#FF0000>"
      lines:
-        - "Scoreboard in world myWorld"
-    scoreboard3:
-      title: "Title 3"
-      lines:
-        - "Line 1"
+        - "&7%date%"
+        - "%animation:MyAnimation1%"
+        - "&6Online:"
+        - "* &eOnline&7: &f%online%"
+        - "* &eCurrent World&7: &f%worldonline%"
+        - "* &eStaff&7: &f%staffonline%"
+        - ""
+        - "&6Personal Info:"
+        - "* &bRank&7: &f%group%"
+        - "* &bPing&7: &f%ping%&8ms"
+        - "* &bWorld&7: &f%world%"
+        - "%animation:MyAnimation1%"
 ```
-Scoreboard `scoreboard1` is checked first. If condition is not met, `scoreboard2` is checked. If that condition is not met, `scoreboard3` is displayed.  
-If a player meets both conditions (has defined permission and is in defined world), `scoreboard1` will be displayed, because it is defined first and therefore has the highest priority. You can switch scoreboards based on your priority needs.
-
-# Announce command
-This takes priority over the current scoreboard.
-Once the announcement is over, the previous scoreboard is restored.  
-`/tab announce scoreboard <name> <time>`  
-name - name of scoreboard to be displayed  
-time - number of seconds to display the scoreboard for
-
-# Additional settings
+All of the options are explained in the following table.  
 | Option name                | Default value | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 |----------------------------|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | enabled                    | false         | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| toggle-command             | /sb           | Command that can be used to toggle scoreboard for the player running the command. Players need `tab.scoreboard.toggle` permission to use it. <br />**Note:** This command will not appear in command auto-complete, because it's not a real registered command. Registered commands must be defined in plugin jar directly and cannot be dynamic. If you want to solve this, you can try getting a dummy private plugin made which registers that command. |
+| toggle-command             | /sb           | Command that can be used to toggle scoreboard for the player running the command. Players need `tab.scoreboard.toggle` permission to use it. <br />**Note:** Commands are not supposed to be registered / unregistered dynamically at runtime. As such, you may run into small issues when changing the toggle command and reloading. After you modify the command to your liking, reconnect to properly see it in tabcomplete. If you don't use TAB on a proxy, consider restarting the server as well for the old command to actually be unregistered. |
 | remember-toggle-choice     | false         | When enabled, toggling decision is saved into a file to remember it even after reloads/restarts/reconnects                                                                                                                                                                                                                                                                                                                                                 |
 | hidden-by-default          | false         | If enabled, scoreboard will automatically be hidden on join until toggle command is used to show it.                                                                                                                                                                                                                                                                                                                                                       |
-| use-numbers                | false         | If enabled, numbers 1-15 will be used in the scoreboard. If disabled, `static-number` is shown everywhere.                                                                                                                                                                                                                                                                                                                                                 |
-| static-number              | 0             | If `use-numbers` is disabled, this is number to be in all lines.                                                                                                                                                                                                                                                                                                                                                                                           |
 | delay-on-join-milliseconds | 0             | Delay in milliseconds to send scoreboard after joining.                                                                                                                                                                                                                                                                                                                                                                                                    |
+| scoreboards                | *Map*         | Scoreboards to display based on conditions (see below for more info). |

-# Limitations
-* [1.5 - 1.12.2] The title is limited to 32 characters (including color codes).
-* [1.5 - 1.12.2] Line length is limited to 28 characters (including color codes) (68 on lines with static text / [Longer lines](#longer-lines)).
-* [1.5 - 1.20.2] The red numbers on the right really cannot be removed from the plugin side (a client modification / resource pack is necessary).
-* The client only displays up to 15 lines. If a plugin sends more, only the top 15 scores will be displayed. Changing this would require a client modification.
+## Scoreboard
+A scoreboard consists of the following options:
+
+| Option name                    | Description                                                                                                                                                                                                                                                                                                                                                                                                      |
+|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `display-condition` (optional) | [Condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) (either condition name or a conditional expression) <br /> that must be met for the design to be displayed. <br />If not defined, design will be displayed without any required condition. <br />If player does not meet condition, another design may be displayed <br /> based on chaining (see below for more info). |
+| `title `                       | Title of the scoreboard. Limited to 32 characters (including color codes) on Minecraft versions below 1.13. It is automatically centered by the client.                                                                                                                                                                                                                                                          |
+| `lines`                        | List of lines to display. The client will only display up to 15 lines. See below for more information about syntax.                                                                                                                                                                                                                                                                                              |
+
+**Example**:
+```
+  scoreboards:
+    MyScoreboard:
+      display-condition: "%world%=world" # Only display it in world "world"
+      title: "Scoreboard for world %world%"
+      lines:
+        - "Line1||Right side 1"
+        - "Line2||Right side 2"
+        - "Line3||Right side 3"
+```
+
+### Line syntax
+The lines are specified as a list of strings.
+
+Since 1.20.3, you can also configure the value on the right side, which no longer has to be a red number.  
+On <1.20.3, you can configure red numbers with either a static number, or a placeholder that evaluates to a number.
+
+The final syntax is `<text>||<number format>||<score>`, where:
+* `<text>` is the main text displayed on the left side
+* `<number format>` is the new 1.20.3+ feature that replaces `score` with any text, not just a number
+* `<score>` is the value (red number), only visible on <1.20.3 and must be a number (or a placeholder evaluating to one)
+
+The second and third part are optional. Example syntaxes that configure a line are:
+* `<text>`
+* `<text>||<number format>`
+* `<text>||<number format>||<score>`
+* `<text>||||<score>`
+
+For example:
+```
+      lines:
+      - "Left 1---"
+      - "||---Right 1"
+      - "Left 2------"
+      - "||------Right 2"
+      - "Left 3---------"
+      - "||---------Right 3"
+      - "Left 4------------"
+      - "||------------Right 4"
+      - "Left 5---------------"
+      - "||---------------Right 5"
+      - "Left 6------------------"
+      - "||------------------Right 6"
+```
+Will give you the following:  
+<img width="305" height="239" alt="image" src="https://github.com/user-attachments/assets/a712b5fb-21ea-4ee4-83ec-d962bd431a07" />
+
+Additionally, the following configuration:
+```
+      lines:
+      - "Left 1---||---Right 1"
+      - "Left 2------||------Right 2"
+      - "Left 3---------||---------Right 3"
+      - "Left 4------------||------------Right 4"
+      - "Left 5---------------||---------------Right 5"
+      - "Left 6------------------||------------------Right 6"
+```
+Will give you  
+<img width="583" height="131" alt="image" src="https://github.com/user-attachments/assets/15e809c6-4ecd-4234-a30e-744c2d413335" />
+
+The `number format` will not be visible at 1.20.2 and lower, and `score` will be displayed instead.
+
+### Hiding a line
+When a line consists only of a placeholder that returned empty output, the line will be hidden completely. This is intentional to allow dynamic scoreboard size based on placeholder output. This is not the case if empty line is configured (`""`), to allow empty lines in configuration.
+
+### Longer lines
+*Since 1.13 the line length is unlimited, so you don't need to worry about this if you use 1.13+.*

-# Longer lines
 To make sure the scoreboard never flickers, it's only using prefix/suffix components to display text.
 These can easily be changed without any visual issues.
 The player name part, however, cannot be changed.
@@ -146,50 +181,75 @@ This bypass is automatically enabled for all lines that only use static text
 (since there's nothing to refresh and cause flickering),
 therefore doing it for such lines (like in the example above) has no effect.

+## Chaining scoreboards
+When defining more than 1 scoreboard in config, the plugin will display the correct scoreboard based on conditions.
+The plugin goes through all defined scoreboards, starting with the scoreboard on top.
+If the scoreboard's condition is met or not set, it is displayed.
+If not, the next defined scoreboard is checked and so on.
+If no suitable scoreboard is found (the last one has a condition requirement which wasn't met), none is displayed.  
+**Example**:
+```
+  scoreboards:
+    scoreboard1:
+      display-condition: "permission:tab.scoreboard.admin"
+      title: "Title 1"
+      lines:
+        - "Scoreboard for admins"
+    scoreboard2:
+      display-condition: "%world%=myWorld"
+      title: "Title 2"
+      lines:
+        - "Scoreboard in world myWorld"
+    scoreboard3:
+      title: "Title 3"
+      lines:
+        - "Line 1"
+```
+Scoreboard `scoreboard1` is checked first. If condition is not met, `scoreboard2` is checked. If that condition is not met, `scoreboard3` is displayed.  
+If a player meets both conditions (has defined permission and is in defined world), `scoreboard1` will be displayed, because it is defined first and therefore has the highest priority. You can switch scoreboards based on your priority needs.
+
+# Commands
+| Command                                              | Permission                                                                               | Description                                                                                                                                                                                      |
+|------------------------------------------------------|------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `/tab scoreboard show <name> [player]`               | `tab.scoreboard.show` (for yourself) <br /> `tab.scoreboard.show.other` (for others)     | Shows the scoreboard with the given `name`, either to yourself if no `player` was given, or to the given `player`.                                                                               |
+| `/tab scoreboard [on/off/toggle] [player] [options]` | `tab.scoreboard.toggle` (for yourself) <br /> `tab.scoreboard.toggle.other` (for others) | Shows / hides / toggles scoreboard of specified player. If no player was given, command affects the sender. You can use `-s` as option for silent toggling (no chat message for affected player) |
+| `/tab scoreboard announce <name> <duration>`         | `tab.announce.scoreboard`                                                                | Shows the scoreboard with the given `name` to every player on the server for the given `duration`, in seconds.                                                                                   |
+
+# Placeholders
+Here are TAB's PlaceholderAPI placeholders you can use when this feature is enabled:
+| Placeholder | Description |
+|-------------|-------------|
+| `%tab_scoreboard_name%` | Returns name of player's currently displayed scoreboard or empty string if none is displayed due to no display condition being met. |
+| `%tab_scoreboard_visible%` | "Enabled" if visible, "Disabled" if not (toggled with a command) |
+
+# Limitations
+* [1.12.2-] The title is limited to 32 characters (including color codes).
+* [1.12.2-] Line length is limited to 28 characters (including color codes) (64 on lines with static text / [Longer lines](#longer-lines)).
+* [1.20.2-] The red numbers on the right really cannot be removed from the plugin side (a client modification / resource pack is necessary).
+* [Bedrock] Scoreboard lines may be cut off and show `...`, this can be bypassed by using [GeyserOptionalPack](https://github.com/GeyserMC/GeyserOptionalPack)
+* The client only displays up to 15 lines. If a plugin sends more, only the top 15 scores will be displayed. Changing this would require a client modification (on versions below 1.8 the scoreboard won't appear at all if more than 15 lines are sent).
+
 # Compatibility with other plugins
 TAB automatically detects scoreboard coming from other plugins, and when one is sent, TAB hides its own scoreboard.
 Later, when the other plugin hides its scoreboard, TAB will send its scoreboard back to the player.

-This detection must be available on your platform.
-For that,
-see the Scoreboard section on [compatibility page](https://github.com/NEZNAMY/TAB/wiki/Compatibility#supported-features-per-platform).
-If it says ✔, the detection is available.
-If it says ❗, it means this detection is not available on your platform.
-As a result, when the other plugin hides its scoreboard, TAB will not be able to resend its own.
+# Additional info
+## Additional note 1 - Text alignment
+**Title**:  
+The title is always centered by the client. You cannot disable this. You can only pad it with spaces to move it towards your desired direction.

-If you want this detection,
-and it's not supported by your platform,
-you can achieve it
-using an alternate solution with conditions that will make TAB display no scoreboard if the condition is not met.
-For this, you'll need to have more information about when exactly do plugins send scoreboards and how to detect it.
+**Lines**:  
+The left side of the text is automatically aligned to the left,
+while the right side is automatically aligned to the right.
+This is done by the client and is out of plugin's control.
+If you want to center a line, you'll need to do it manually.
+If dynamic placeholder output length is preventing your from doing it,
+you can try to bypass it by adding spaces before and after it to artificially increase and force the scoreboard width,
+such as
+`- "          Centered text          "`.

-<details>
-  <summary>Example using PremiumVanish</summary>
-
-When you are vanished using PremiumVanish plugin, placeholder `%premiumvanish_isvanished%` will return `Yes` instead of the usual `No`. You can put this as a display condition to all defined scoreboards.  
-An original
-```
-  scoreboards:
-    scoreboard1:
-      title: Default
-      lines:
-      - 'Line of text'
-```
-would turn into
-```
-  scoreboards:
-    scoreboard1:
-      display-condition: "%premiumvanish_isvanished%=No"
-      title: Default
-      lines:
-      - 'Line of text'
-```
-Remember to add this condition to all of your scoreboards if you have more than 1
-(for those with an existing condition merge them using `;`).  
-Keep in mind [placeholder output replacements](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Placeholder-output-replacements) apply to placeholders here as well,
-so if you configured a fancy output for that placeholder, you'll need to use it in the display condition as well.
-To see what exactly has placeholder returned, use `/tab parse <player> <placeholder>`.
-</details>
+## Additional note 2 - Geyser / Bedrock issues
+Currently, there is a great suspicion that there is a geyser bug causing scoreboard to not appear for Bedrock players ([Geyser #5304](https://github.com/GeyserMC/Geyser/issues/5304) and more). This affects other scoreboard plugins as well, not just TAB. If you are experiencing this issue, make sure it is not caused by TAB configuration (for example using %bedrock%=false as display condition). If that wasn't the case, consider making a high quality bug report on Geyser with steps to reproduce.

 # API
 *To get started with the API, see [Developer API](https://github.com/NEZNAMY/TAB/wiki/Developer-API) page.*
@@ -209,10 +269,10 @@ To change whether a player can see scoreboards, use `ScoreboardManager#setScoreb
 To toggle whether a player can see scoreboards, use `ScoreboardManager#toggleScoreboard(TabPlayer, boolean)`. This will either make scoreboards visible if they are not already, or make them hidden if they are currently visible.

 ## Announcing a scoreboard
-To announce a scoreboard to all players on the server for a given number of ticks,
+To announce a scoreboard to all players on the server for a given number of milliseconds,
 use `ScoreboardManager#announceScoreboard(String, int)`,
 which will look up a scoreboard with the given `String` name,
-and if one is found, send it to all players for the given `int` ticks.
+and if one is found, send it to all players for the given `int` milliseconds.

 # Examples
 ## Example 1 - Per-world scoreboards
@@ -249,8 +309,7 @@ If none of the conditions are met, display the default scoreboard.
 > [!NOTE]
 > This is just an example, the plugin is not limited to displaying scoreboard only per world.
 > If you want per server scoreboards on proxy, use %server% with server names.
-> If you want worldguard regions, use %worldguard_region_name% with region names.
-> This works for any placeholder offered by the plugin or by PlaceholderAPI.
+> This works for any placeholder offered by TAB or by PlaceholderAPI.

 ## Example 2 - Periodical scoreboard switching
 We can use [animations](https://github.com/NEZNAMY/TAB/wiki/Animations) to make the plugin switch between scoreboards using display condition. Let's say we want to switch between 2 scoreboards. First, we create an animation:  
@@ -285,7 +344,7 @@ We don't need to define display condition for the second scoreboard,
 since if animation is not on the first frame, it has to be on the second one.
 If using more than 2, you will need to define display condition for all of them (except the last one).

-# Example 3 - Per-version scoreboards
+## Example 3 - Per-version scoreboards
 1.20.3 has added new features to scoreboards, which are not visible to older clients. If you want to use new features for new players while still displaying things properly for older players, you'll need to create 2 different scoreboards.  
 You'll find 2 placeholders useful for this:
 * `%player-version-id%` - Returns network ID of player's protocol version. Unlike with version names, you can perform numerical comparisons with these. You can find all version IDs [here](https://github.com/NEZNAMY/TAB/blob/master/shared/src/main/java/me/neznamy/tab/shared/ProtocolVersion.java). For example, 1.20.3 is 765.
@@ -315,4 +374,29 @@ Let's go ahead and set it up (with proper spacing):
        - "* &bRank&7: &f%group%"
        - "* &bPing&7: &f%ping%&8ms"
        - "* &bWorld&7: &f%world%"
-```
+```
+
+## Example 4 - Conditional lines
+Sometimes you may want a dynamic line that only shows sometimes. TAB is already made to hide lines if they only consist of a placeholder that returned empty value. However, you may want to add more text around it, such as
+```
+- "Faction: %factionsuuid_faction_name%"
+```
+Now, even if the placeholder returns empty string, text `Faction: ` will remain, and as such, the line will stay. In order to avoid this, create a [conditional placeholder](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders). If the placeholder returned empty value, show empty value. Otherwise, show result of the placeholder with the static text:
+```
+conditions:
+  faction:
+    conditions:
+    - '%factionsuuid_faction_name%='
+    true: "" # No faction, return empty string to hide the line
+    false: "Faction: %factionsuuid_faction_name%" # Player has a faction, show the static text before it as well
+```
+> [!WARNING]
+> DO NOT JUST RANDOMLY PASTE THIS ENTIRE "CONDITIONS" SECTION INTO YOUR CONFIG!
+> INSTEAD, EDIT YOUR EXISTING CONDITIONS SECTION TO PREVENT HAVING THE SECTION TWICE,
+> HAVING SECOND ONE COMPLETELY OVERRIDE THE FIRST ONE!
+
+Now, configure your scoreboard line as:
+```
+- "%condition:faction%"
+```
+and it will only display if the placeholder returned non-empty value.
@@ -1,4 +1,5 @@
 # Content
+* ~About~
 * [Enabling](#enabling)
 * [Methods of sorting](#methods-of-sorting)
  * [GROUPS](#groups)
@@ -11,19 +12,21 @@
 * [Multiple elements with the same priority](#multiple-elements-with-the-same-priority)
 * [Combining multiple sorting types](#combining-multiple-sorting-types)
 * [Additional settings](#additional-settings)
+* ~Commands~
+* ~Placeholders~
+* ~Limitations~
+* ~Compatibility with other plugins~
 * [Additional info](#additional-info)
  * [Additional note 1 - Limitations](#additional-note-1---limitations)
  * [Additional note 2 - per-world sorting](#additional-note-2---per-world-sorting)
  * [Additional note 3 - Compatibility issues with other plugins](#additional-note-3---compatibility-issues-with-other-plugins)
-* [Common mistakes](#common-mistakes)
+* [Troubleshooting](#troubleshooting)
 * [API](#api)
+* ~Examples~

 # Enabling
 To enable sorting, you must have either [Nametags](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Nametags) or [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) (or both) enabled.

-> [!TIP]
-> To verify you enabled sorting, run `/tab debug`. It will say `Sorting type:` followed by anything except `DISABLED`.
-
 # Methods of sorting
 Below are all the different methods that you can use to sort players.

@@ -33,10 +36,6 @@ This is the default and recommended method. Players will be sorted by their prim
 First, put your players into groups in your permission plugin.
 All the ways to do it can be found
 at [How to assign players into groups](https://github.com/NEZNAMY/TAB/wiki/How-to-assign-players-into-groups).
-> [!TIP]
-> Verify player's group using `/tab debug <player>`.
-It should say `Primary permission group:` followed by group you configured.
-If not, you did not assign players into groups correctly.

 Second, place all of your groups in to a comma separated list **in order of priority** into `sorting-types`. Example:
 ```yaml
@@ -44,15 +43,6 @@ scoreboard-teams:
  sorting-types:
    - "GROUPS:owner,admin,mod,default"
 ```
-> [!TIP]
-> Verify configured sorting priority of players using `/tab debug <player>`.
-
-It should show a message like this:  
-![image](https://github.com/NEZNAMY/TAB/assets/6338394/095d8523-e8c0-4eff-8935-b0b8e6e0d5ff)
-
-If a group is not in the list, you will get the following:  
-![image](https://github.com/NEZNAMY/TAB/assets/6338394/9c530873-87c9-4db7-8916-a6121dbeed37)  
-If that's the case, you forgot to add that group into the list.

 ## PERMISSIONS
 > [!CAUTION]
@@ -71,8 +61,6 @@ scoreboard-teams:
  sorting-types:
    - "PERMISSIONS:my.permission.1,my.permission.2,my.permission.3"
 ```
-> [!TIP]  
-> Verify sorting permissions of a player using `/tab debug <player>`

 ## PLACEHOLDER
 This method sorts players using the output of a placeholder and comparing that to pre-defined values.  
@@ -205,15 +193,12 @@ In other words, only one plugin can handle teams at a time.
 Having multiple plugins handling teams is supposed to end in a disaster.

 Fortunately, TAB contains a function that prevents other plugins from assigning players into teams.
-This can be enabled/disabled by toggling `anti-override` setting under `scoreboard-teams`.
-This is, however, highly recommended to keep enabled, unless all of your plugins are configured correctly.
 When a plugin tries to override TAB's teams, this action is logged into `anti-override.log` file.
-If your file is empty / does not exist, it means you have no conflicting plugins / settings and can disable this option,
-slightly boosting performance.
+If your file is empty / does not exist, it means you have no conflicting plugins / settings.
 If the file exists, most of the time you can guess where the teams come from by their name.  
 Here are a few common teams and their sources (`xxxx` means any, usually random character sequence):
 * `collideRule_xxxx` - this comes from Paper. Not going to explain why as that would be quite long, but the way you can avoid is by setting `enable-player-collisions: true` in paper config and `enable-collision: false` in TAB config (yes, collisions will be disabled).
-* `CMINPxx` - CMI, set `DisableTeamManagement: true` in `plugins/CMI/config.yml`.
+* `CMINPxx` - CMI, set `DisableTeamManagement: true` in `plugins/CMI/config.yml` (though CMI won't allow you to change glow color if you do, so keep that in mind).
 * `CIT-xxxxxxxxxxxx` - Citizens NPC with the same name as some online player. Make NPC names not match real players and use holograms to display your desired text (/npc name or something).
 * `PVP-xxxxxxxxxxxx` - Team coming from [PvPManager](https://www.spigotmc.org/resources/pvpmanager-lite.845/) plugin.

@@ -223,22 +208,24 @@ To identify such an issue, check if /tab reload fixes your sorting issue.
 If it does, it's a compatibility issue of some sort.
 If not, it is most likely a misconfiguration issue.

-# Common mistakes
-Every possible mistake could be called "not reading this wiki page", but that would make this section pointless.
-For that reason, let's call it list of mistakes made when following this page.
+# Troubleshooting
+There are many possible reasons why sorting may not work as desired, let's name them all.  
+To get started, run `/tab dump <some player>` and open the generated link. Scroll down to `features` -> `Sorting`.  
+If it says `Sorting: Feature is disabled`, it means you disabled sorting. See [Enabling](#enabling).  
+Check the table of players in the `Sorting` section. The players are listed in the order they should appear in the tablist. Does it match the in-game result?  
+**Option 1 - Players are listed in the same order they appear in game** - This means you did not configure sorting correctly. Check the table of all values for all players and see what is different than you expected:
+* Your group is wrong (shown in the table as well as on top of the dump):
+  * You did not configure weights in LuckPerms.
+  * You accidentally enabled `use-bukkit-permission-manager` option when on a proxy without knowing what it does.
+  * You installed TAB on a proxy without having any permission plugin on the proxy.
+  * You enabled `assign-groups-by-permissions` without giving those permissions (or the opposite - giving away OP to users, resulting in the highest group being taken).
+* You mistook `primary-group-finding-list` for the sorting list and did not configure the actual group sorting list.
+* You combined multiple sorting types, but listed them in the wrong order. See [Combining multiple sorting types](#combining-multiple-sorting-types) (sorting element priorities go from top to bottom, in the table they appear from left to right).

-The most common mistakes include:
-* Disabling both teams and layout, not realizing it disables sorting as well.
-* Disabling anti-override without disabling teams in other plugins.
-* Mistaking `primary-group-finding-list` for the sorting list, despite that list having nothing to do with sorting and by default even having a comment above it saying it has nothing to do with sorting.
-* Not configuring primary groups correctly. This can have multiple reasons, such as
-  * Not configuring group weights in LuckPerms.
-  * Accidentally enabling `use-bukkit-permission-manager` option when on BungeeCord without knowing what it does.
-  * Installing TAB on BungeeCord without having any permission plugin on BungeeCord.
-  * Enabling `assign-groups-by-permissions` without giving those permissions (or the opposite - giving away OP to users, resulting in the highest group being taken).
-
-  [Debug command](https://github.com/NEZNAMY/TAB/wiki/Commands-&-Permissions#tab-debug-player) will help you identify if this is your case.
-* Using a plugin that causes TAB to fail to apply teams (such as Tablisknu). This includes installing TAB plugin on both bukkit and bungeecord, causing the installations to conflict.
+**Option 2 - Players are listed in a different order than in-game** - This means teams were not applied properly. Possible reasons include:
+* Teams are disabled for the player (`disable-condition` was met or teams were disabled via API).
+* You have TAB on Velocity and forgot to install [VelocityScoreboardAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/releases) (or it's outdated and doesn't support your Velocity / game version).
+* You are using a plugin that causes TAB to fail to apply teams (such as Tablisknu). This includes installing TAB plugin on both backend and proxy, causing the installations to conflict (typically proxy taking over and backend not working).

 # API
 *To get started with the API, see [Developer API](https://github.com/NEZNAMY/TAB/wiki/Developer-API) page.*
@@ -8,7 +8,7 @@
 # About
 With the introduction of spectator gamemode in 1.8,
 players having it automatically appear on the bottom of tablist with transparent name and missing [Playerlist Objective](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Playerlist-Objective).
-This feature cancels gamemode change packets to spectator gamemode, cancelling this minecraft feature.
+This feature cancels gamemode change packets to spectator gamemode, cancelling this Minecraft feature.

 # Enabling
 To enable this feature, open **config.yml** and set
@@ -1,18 +1,25 @@
 # Content
 * [About](#about)
 * [Configuration](#configuration)
-  * [Introduction](#introduction)
-  * [Groups and users](#groups-and-users)
-  * [Per-world / per-server](#per-world--per-server)
-  * [Priority system](#priority-system)
-  * [Placeholder support](#placeholder-support)
-  * [Additional settings](#additional-settings)
-* [Tips & Tricks](#tips--tricks)
+  * [config.yml](#configyml)
+  * [groups.yml and users.yml](#groupsyml-and-usersyml)
+    * [Format structure](#format-structure)
+    * [Global settings](#global-settings)
+    * [Per-world / per-server](#per-world--per-server)
+    * [Priorities](#priorities)
+* ~Commands~
+* [Placeholders](#placeholders)
+* ~Limitations~
+* [Compatibility with other plugins](#compatibility-with-other-plugins)
+* ~Additional info~
+* ~Troubleshooting~
 * [API](#api)
+* [Examples](#examples)
+  * [Example 1 - Taking prefix/suffix from permission plugin](#example-1---taking-prefixsuffix-from-permission-plugin)

 # About
 This feature allows you to configure player name formats in the tablist.
-It was added to minecraft in version 1.8.
+It was added to Minecraft in version 1.8.
 Versions 1.7 and lower only allow up to 16 characters including name,
 which is too limiting and not supported by this plugin.
 If you wish to have prefix/suffix for 1.7 and lower,
@@ -20,10 +27,25 @@ take advantage of [this client-sided mechanic](https://github.com/NEZNAMY/TAB/wi
 which will appear in the tablist.  
 ![image](https://user-images.githubusercontent.com/6338394/205877929-4df82c78-9773-4614-b4a3-93e1673d6046.png)

-Settings of this feature can be configured in **config.yml** under **tablist-name-formatting** section.
-
 # Configuration
-## Introduction
+This feature is configured in 2 parts based on what you are configuring. Some settings are in the **config.yml**, but prefix/suffix is configured in **groups.yml** and **users.yml**.
+## config.yml
+The first part can be configured in **config.yml** under **tablist-name-formatting** section. It controls everything except prefix and suffix.
+
+This is how the default configuration looks:
+```
+tablist-name-formatting:
+  enabled: true
+  disable-condition: '%world%=disabledworld'
+```
+All of the options are explained in the following table.  
+| Option name                 | Default value         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+|-----------------------------|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| enabled                     | true                  | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| disable-condition           | %world%=disabledworld | A [condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for disabling the feature for players. Set to empty for not disabling the feature ever.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+
+## groups.yml and users.yml
+### Format structure
 The display name is split into 3 parts for convenience:  
 `tabprefix` - first part of the text, this is where prefix is usually configured  
 `customtabname` - second part of the text, it will be used as player name. If customtabname is not defined at all (not just setting empty value!), player's original name will be used instead  
@@ -33,22 +55,20 @@ These values are then merged and displayed in the tablist.
 ![image](https://user-images.githubusercontent.com/6338394/205877510-e40f93ce-80df-46f2-84f0-c113e0e813e8.png)

 You are free to use the 3 properties in any way you want since they are only split for convenience.
-However, it is still a good idea to use them for their designed purpose to not get lost a poor configuration.
+However, it is still a good idea to use them for their designed purpose to not get lost in a poor configuration.
 This means that the text which should appear before player's name should be put into `tabprefix`,
 any placeholder that is supposed to display player's name (such as from a nickname plugin)
 should go into `customtabname` and any text that should appear after player's name should be put into `tabsuffix`.

-## Groups and users
-Properties can be applied in 2 ways: groups and users.
-Users can be defined by both username and their UUID.
-Values applied to users take priority over groups.
-Example:  
+### Global settings
+Properties can be applied in 2 ways: groups and users. Users can be defined by both username and their UUID. Values applied to users take priority over groups.
+
 **groups.yml**
 ```
 admin:
  tabprefix: "&4&lAdmin &r"
 ```
-This can also be achieved with commands, in this case `/tab group admin tabprefix "&4&lAdmin &r"`.
+Or with an in-game command `/tab group admin tabprefix "&4&lAdmin &r"`.

 **users.yml**
 ```
@@ -59,11 +79,11 @@ _NEZNAMY_:
 237d8b55-3f97-4749-aa60-e9fe97b45062:
  tabprefix: "&6&lTAB &r"
 ```
-This can also be achieved with commands, in this case `/tab player _NEZNAMY_ tabprefix "&6&lTAB &r"` or `/tab playeruuid _NEZNAMY_ tabprefix "&6&lTAB &r"`.
+Or with in-game commands `/tab player _NEZNAMY_ tabprefix "&6&lTAB &r"` and `/tab playeruuid _NEZNAMY_ tabprefix "&6&lTAB &r"` (the player must be online for uuid option to work).

 Properties can also be set as "default" for everyone who does not have them defined.
-For that purpose, a group keyword `_DEFAULT_` was made.
-Example:   
+For that purpose, a group keyword `_DEFAULT_` was made.  
+Example:  
 **groups.yml**
 ```
 admin:
@@ -72,8 +92,8 @@ _DEFAULT_:
  tabprefix: "&7" # This will be displayed on everyone except admin
 ```

-## Per-world / per-server
-Values can also be applied per-world (and per-server on bungeecord), where they can be defined per group/user. These values take priority over global settings. Example:  
+### Per-world / per-server
+Values can also be applied per-world (and per-server on a proxy), where they can be defined per group/user. These values take priority over global settings. Example:  
 **groups.yml**
 ```
 per-world:
@@ -85,21 +105,22 @@ per-server:
    _DEFAULT_:
      tabprefix: "&a" # Everyone in server "server1" will have this prefix
 ```
-For multiple worlds/servers to share the same settings, separate them with `;`.  
-For worlds/servers starting with a specified text, use `*` after shared part. For ending with a shared part, use `*` at the beginning.  
+
+For multiple worlds/servers to share the same settings, separate them with a`;`.  
+For worlds/server starting with a specified text, use `*` after shared part. For ending with a shared part, use `*` at the beginning.  
 Example:
 ```
 per-world:
  world1;world2:
    _DEFAULT_:
-      tabsuffix: "Shared tabsuffix in worlds world1 and world2"
+      tabsuffix: "Shared tagsuffix in worlds world1 and world2"
  lobby-*:
    _DEFAULT_:
      tabsuffix: "Suffix in all worlds starting with lobby-"
 ```

-## Priority system
-The full list of priorities looks like this:
+### Priorities
+The full list of priorities to choose correct prefix/name/suffix for a player looks like this:
 1. value set using the [API](#api)
 2. per-world / per-server applied to username
 3. value applied to username
@@ -110,33 +131,28 @@ The full list of priorities looks like this:
 8. value applied to player's group
 9. value applied to group `_DEFAULT_`

-This list is browsed through until the first match is found. If no match is found, empty value is used (except `customtabname`, which defaults to player's name).
+This list is browsed through until the first match is found. If no match is found, empty value is used.

 Values are taken independently of each other.
 This means you can set per-world tabprefix, but only keep one global tabsuffix, for example.

-You can see the source of a value displayed on player by using `/tab debug <player>` and checking "source"
-part of the value you are looking for.
+You can see the source of a value displayed on player by using `/tab dump <player>`, opening the link and checking "source"
+part of the value you are looking for (tabprefix / customtabname / tabsuffix).

-## Placeholder support
-All values fully support [TAB's internal placeholders](https://github.com/NEZNAMY/TAB/wiki/Placeholders#internal-placeholders) and [PlaceholderAPI placeholders](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders) including relational placeholders.
-The number of placeholders is not limited, and they can be used in combination with static text as well.
+# Placeholders
+Here are TAB's PlaceholderAPI placeholders you can use when this feature is enabled:
+| Placeholder | Description |
+|-------------|-------------|
+| `%tab_tabprefix%` | Player's current tabprefix with placeholders parsed. |
+| `%tab_customtabname%` | Player's current customtabname with placeholders parsed. |
+| `%tab_tabsuffix%` | Player's current tabprefix with placeholders parsed. |
+| `%tab_tabprefix_raw%` | Player's current raw tabprefix with placeholder identifiers. |
+| `%tab_customtabname_raw%` | Player's current raw customtabname with placeholder identifiers. |
+| `%tab_tabsuffix_raw%` | Player's current raw tabsuffix with placeholder identifiers. |

-## Additional settings
-| Option name       | Default value         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-|-------------------|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| enabled           | true                  | Enables / Disables the feature                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| anti-override     | true                  | When enabled, prevents other plugins from overriding TAB. This results in slightly higher CPU usage, but will make sure the function works as expected. <br />Unlike with teams, attempts to override TAB are not logged into anti-override.log file. This is due to high amount of false positives from TAB's own features, as well as bungeecord server switch, higher CPU usage and more. Whether you need this or not depends on how properly your plugins are configured. Some of them attempt to format tablist even if you'd not expect it from such plugin. Keep this enabled to stay safe. |
-| disable-condition | %world%=disabledworld | A [condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for disabling the feature for players. Set to empty for not disabling the feature ever.                                                                                                                                                                                                                                                                                                                                                                                                 |
-
-# Tips & Tricks
-If you want TAB to only take prefixes/suffixes from your permission plugin,
-delete all groups from **groups.yml** and only keep this:
-```
-_DEFAULT_:
-  tabprefix: "%luckperms-prefix%"
-  tabsuffix: "%luckperms-suffix%"
-```
+# Compatibility with other plugins
+Tablist formatting is a feature that cannot be effectively handled by multiple plugins at once.
+To make sure no other plugin sets tablist display names when not disabled in the plugin's config properly, TAB will block attempts to modify tablist display names coming from all other plugins (if this feature is enabled and not disabled for a player with a condition).

 # API
 *To get started with the API, see [Developer API](https://github.com/NEZNAMY/TAB/wiki/Developer-API) page.*
@@ -156,8 +172,25 @@ To get custom values previously set using the API (they will return `null` if no
 * `TabListFormatManager#getCustomSuffix(TabPlayer)`

 To get the original value set by the plugin based on configuration:
-* `TabListFormatManager#getOriginalPrefix(TabPlayer)`
-* `TabListFormatManager#getOriginalName(TabPlayer)`
-* `TabListFormatManager#getOriginalSuffix(TabPlayer)`
+* `TabListFormatManager#getOriginalRawPrefix(TabPlayer)` - Prefix with raw placeholder identifiers
+* `TabListFormatManager#getOriginalRawName(TabPlayer)` - Name with raw placeholder identifiers
+* `TabListFormatManager#getOriginalRawSuffix(TabPlayer)` - Suffix with raw placeholder identifiers
+* `TabListFormatManager#getOriginalReplacedPrefix(TabPlayer)` - Prefix with all placeholders parsed
+* `TabListFormatManager#getOriginalReplacedName(TabPlayer)` - Name with all placeholders parsed
+* `TabListFormatManager#getOriginalReplacedSuffix(TabPlayer)` - Suffix with all placeholders parsed

-**Note**: These values are only temporary, meaning they won't get saved anywhere and will get reset on player quit or plugin reload. If you wish to save these values into file, use [commands](https://github.com/NEZNAMY/TAB/wiki/Commands-&-Permissions#tab-playergroupplayeruuid-name-property-value-options).  
+**Note**: These values are only temporary, meaning they won't get saved anywhere and will get reset on player quit or plugin reload. If you wish to save these values into file, use [commands](https://github.com/NEZNAMY/TAB/wiki/Commands-&-Permissions#tab-playergroupplayeruuid-name-property-value-options).
+
+# Examples
+## Example 1 - Taking prefix/suffix from permission plugin
+If you want TAB to only take prefixes/suffixes from the permission plugin,
+delete all groups from **groups.yml** and only keep this:
+```
+_DEFAULT_:
+  tabprefix: "%luckperms-prefix%"
+  tabsuffix: "%luckperms-suffix%"
+```
+Or a PlaceholderAPI placeholder from your permission plugin if you use a different one.
+
+> [!NOTE]
+> When doing this, make sure you don't delete something you didn't mean to delete, for example ta**g**prefix and ta**g**suffix from nametag feature.
@@ -1,13 +0,0 @@
-When a plugin for linking proxies is detected, TAB automatically enables its hook to add support for it.
-No configuration is necessary.  
-Supported redis plugins:
-* [RedisBungee](https://github.com/ProxioDev/RedisBungee)
-
-Supported features:
-* [Belowname](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Belowname)
-* [Global playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist)
-* [Nametags](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Nametags) & [Sorting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Sorting-players-in-tablist)
-* [Tablist name formatting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Tablist-name-formatting)
-* [Playerlist Objective](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Playerlist-Objective)
-
-The hook does not and will never support [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout), which would require drastic changes to the feature itself and wouldn't be worth it, since the amount of visible players is usually even lower due to fixed slots and RedisBungee is used on networks with many players, so there will be enough players to work with anyway.
@@ -0,0 +1,4 @@
+# About
+A collection of things people have requested that I might look into implementing when I get extremely bored sometime next decade.
+* Relational placeholder support in sorting
+* 1.21.2+ sorting support
@@ -5,18 +5,20 @@
 * [#4 - Why is player sorting not working?](#4---why-is-player-sorting-not-working)
 * [#5 - How to add players to %staffonline% placeholder?](#5---how-to-add-players-to-the-staffonline-placeholder)
 * [#6 - How to make player heads visible in tablist?](#6---how-to-make-player-heads-visible-in-tablist)
-* [#7 - Where can i find current default config files?](#7---where-can-i-find-current-default-config-files)
+* [#7 - Where can I find current default config files?](#7---where-can-i-find-current-default-config-files)
 * [#8 - How can I split players into multiple columns?](#8---how-can-i-split-players-into-multiple-columns)
 * [#9 - How to use space in prefix/suffix command?](#9---how-to-use-spaces-in-prefixsuffix-command)
 * [#10 - Can I change/remove the green connection bar in tablist?](#10---can-i-changeremove-the-green-connection-bar-in-tablist)
 * [#11 - Placeholder is not working](#11---placeholder-is-not-working)
-* [#12 - How can I display ItemsAdder images?](#12---how-can-i-display-itemsadder-images)
+* [#12 - How can I display images from resource pack plugin?](#12---how-can-i-display-images-from-resource-pack-plugin)
 * [#13 - How can I use UTF characters in configuration?](#13---how-can-i-use-utf-characters-in-configuration)
 * [#14 - Is there a way to remove all players from tablist?](#14---is-there-a-way-to-remove-all-players-from-tablist)
 * [#15 - How to add images to tablist?](#15---how-to-add-images-to-tablist)
 * [#16 - Is MiniMessage supported?](#16---is-minimessage-supported)
 * [#17 - Is it possible to show the number of players in a specific group, similar to staffonline placeholder?](#17---is-it-possible-to-show-the-number-of-players-in-a-specific-group-similar-to-staffonline-placeholder)
 * [#18 - Why is the plugin flagged as a virus by Windows defender?](#18---why-is-the-plugin-flagged-as-a-virus-by-windows-defender)
+* [#19 - How can I show amount of online players on the entire network?](#19---how-can-i-show-amount-of-online-players-on-the-entire-network)
+* [#20 - Why is LuckPerms prefix/suffix not updating on a network?](#20---why-is-luckperms-prefixsuffix-not-updating-on-a-network)

 ## #1 - Why are NPCs showing up in the tablist?
 See [Citizens FAQ](https://wiki.citizensnpcs.co/Frequently_Asked_Questions#Why_are_NPCs_showing_up_in_the_tablist.3F).
@@ -24,7 +26,7 @@ See [Citizens FAQ](https://wiki.citizensnpcs.co/Frequently_Asked_Questions#Why_a
 ## #2 - How to make TAB work with LuckPerms?
 * If you want to take prefixes/suffixes, check [this guide](https://github.com/NEZNAMY/TAB/wiki/Mini-guides-collection#taking-prefixessuffixes-from-permission-plugin) and use `%luckperms-prefix%` & `%luckperms-suffix%`.
 * Sorting:
-  First, [Configure weights correctly in LuckPerms](https://github.com/NEZNAMY/TAB/wiki/How-to-setup-weights-priorities#luckperms). Then, you have 2 options:
+  First, configure weights correctly in LuckPerms. Then, you have 2 options:
  * Configure [sorting by groups](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Sorting-players-in-tablist#groups) (recommended).
  * Sorting by weights directly: `PLACEHOLDER_HIGH_TO_LOW:%luckperms_highest_group_weight%`.

@@ -50,7 +52,9 @@ Most commonly used plugins for this are [FastLogin](https://www.spigotmc.org/res
 which change connections of premium players who enabled it to online connections.  
 The same goes for disabling heads - you cannot disable them if you have online mode enabled.

-## #7 - Where can i find current default config files?
+Minecraft 1.21.9 has added [object components](https://github.com/NEZNAMY/TAB/wiki/How-to-use-Minecraft-components#object-components-1219), which allow you to display player heads. You can put for example `<head:%player%>` at the beginning of tabprefix to simulate this (you will need a plugin like SkinsRestorer for the players to properly be able to recognize skins by player name).
+
+## #7 - Where can I find current default config files?
 You can do any of the following:
 * Check the [source code](https://github.com/NEZNAMY/TAB/tree/master/shared/src/main/resources/config).
 * Delete or rename a file, and the plugin will regenerate it.
@@ -68,25 +72,40 @@ Use "", for example `/tab group owner tabprefix "&2&lOwner&r "`

 ## #10 - Can I change/remove the green connection bar in tablist?
 The connection bar is client sided and cannot be re-textured or removed by TAB.
-You will need a custom minecraft client or a resource pack.
+You will need a custom Minecraft client or a resource pack.

 ## #11 - Placeholder is not working
 Most common reasons for a placeholder to not work include:
 * Using % symbol by itself, which breaks placeholder starts and ends and therefore breaks all placeholders after it (use %% to display the symbol)
 * Trying to use a PlaceholderAPI placeholder without downloading its expansion or not having PlaceholderAPI installed at all
-* Trying to use [TAB's internal bukkit-only placeholders](https://github.com/NEZNAMY/TAB/wiki/Placeholders#bukkit-only) on BungeeCord
-* Trying to use [PlaceholderAPI placeholders on BungeeCord](https://github.com/NEZNAMY/TAB/wiki/How-to-set-up-PlaceholderAPI-support-on-bungeecord) without installing [bridge plugin](https://www.mc-market.org/resources/20631/)
+* Trying to use [TAB's internal backend-only placeholders](https://github.com/NEZNAMY/TAB/wiki/Placeholders#backend-only) on a proxy
+* Trying to use PlaceholderAPI placeholders on proxy without installing [bridge plugin](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge)

 The full list of reasons can be found on the [Placeholders](https://github.com/NEZNAMY/TAB/wiki/Placeholders#placeholder-is-not-working) page.

-## #12 - How can I display ItemsAdder images?
-ItemsAdder offers placeholders, which return the respective symbol to which your desired image is bound to. You can get them using ItemsAdder's PlaceholderAPI expansion using their `%img_<name>%` placeholder. ItemsAdder's internal placeholders (`:something:`) will not work in TAB.
+## #12 - How can I display images from resource pack plugin?
+Images work by mapping a chosen character to an image in a resource pack.
+When the game receives this character, it displays the image instead of the character.
+What you need to do is send this character to the client.  
+Although resource pack plugins are not all the same, they all have things in common.
+The first main functionality is offering placeholders.
+You can use their PlaceholderAPI placeholders in TAB, and they will return the symbol, which then the client displays as an image.
+The second main functionality is creating internal placeholders, which are different per plugin.
+The plugin then listens to outgoing packets and replaces the internal placeholder with the symbol.
+This can, however, fail.
+Here are possible reasons why:
+* You have TAB on proxy, so backend plugin cannot modify packets sent by the proxy
+* TAB also listens to packets and modifies them to make sure no other plugin is overriding it. This mostly applies to [Tablist name formatting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Tablist-name-formatting). TAB then ends up having the last shot, overriding the resource pack plugin.
+
+In order to make sure images display properly, use PlaceholderAPI placeholders instead of internal placeholders of your resource pack plugins.
+Here is some extra information for each resource pack plugin you might find useful:
+* ItemsAdder:
+  * The PlaceholderAPI placeholders are formatted as `%img_<name>%`, internal placeholders (`:something:`) may not always work (see above).
+  * If you are unable to change the placeholder references from internal placeholders to PlaceholderAPI placeholders (for example, because they are defined in permission plugin and used elsewhere as well, where PlaceholderAPI isn't supported), you can use [PlaceholderAPI](https://github.com/NEZNAMY/TAB/wiki/Quick-PlaceholderAPI-startup-guide)'s `imgfix` expansion that replaces format of given placeholders into the correct format.  
+    Example: `%luckperms_prefix%` -> `%imgfix_{luckperms_prefix}%`
+* Nexo:
+  * Here is a collection of tips from Nexo discord: <br /><img width="476" height="238" alt="image" src="https://github.com/user-attachments/assets/0eca8e9b-a73f-4e66-9c76-11a230e823b4" />

-If you are unable to change the references
-(for example, because they are defined in permission plugin and used elsewhere as well),
-you can use [PlaceholderAPI](https://github.com/NEZNAMY/TAB/wiki/Quick-PlaceholderAPI-startup-guide)'s `imgfix` expansion
-that replaces format of given placeholders into the correct format.  
-Example: `%luckperms_prefix%` -> `%imgfix_{luckperms_prefix}%`

 ## #13 - How can I use UTF characters in configuration?
 **Option 1**: [Save the file in UTF-8 encoding](https://github.com/NEZNAMY/TAB/wiki/How-to-save-the-config-in-UTF8-encoding) and use your desired symbol directly.
@@ -99,25 +118,21 @@ Using `''` will result in the text being display literally, not as a code.
 **Note:** Minecraft does not support every single UTF symbol and displays unsupported symbols as a box. You can try sending your symbol into chat and see if it works or not. If not, it's not supported by MC.

 ## #14 - Is there a way to remove all players from tablist?
-For a player to be visible in game, they must be in the tablist as well.
-Remember the NPC in tablist issue?
-If you don't mind players not appearing in the game, get a plugin that hides all players.
-If you want to see them in the game, however, your only choice is to put a lot of empty lines into header,
-which will push all players out of the screen.
+Here are various ways to achieve this goal:
+
+* **Option 1: Hide players entirely** - In Minecraft, for a player to be visible in-game, they also need to added into the tablist. If you don't mind hiding players from game as well, there are plugins that offer this (TAB is, however, not one of them).  
+  In 1.19.3, the player info packet received a new field that allows us to explicitly hide players from tablist while all the necessary data is still sent to players.
+
+* **Option 2: Layout with 0 slots** - Since Minecraft 1.19.3, the limitation explained above has been lifted — it's now possible to have entities in the game without showing them in the tablist. TAB does not have an explicit feature for doing this. However, since 1.19.3, the [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) feature uses this mechanic to allow less than 80 slots. This feature can be "abused" by enabling the feature, removing fixed-slots and adding `slot-count: 0` to the displayed layout. The final effect will be a playerless tablist.
+
+* **Option 3: Pushing players out of the screen with header** - You can add a ton of empty lines into the header. As a result, players will be pushed down out of the screen and effectively not visible.

 ## #15 - How to add images to tablist?
-You can check out [this reddit post](https://www.reddit.com/r/admincraft/comments/llrgty/comment/gnswdcz/?utm_source=share&utm_medium=web2x&context=3).
+You can check out [this Reddit post](https://www.reddit.com/r/admincraft/comments/llrgty/comment/gnswdcz/?utm_source=share&utm_medium=web2x&context=3).
 When using the symbol in configuration using \u format, remember to use `""` in config instead of `''`.

 ## #16 - Is MiniMessage supported?
-Kind of.
-MiniMessage support **is** included; however, this doesn't mean it is guaranteed to work.
-MiniMessage library must be included in your server software.
-TAB does not include this library.
-* It **is** included in **Paper 1.18.2** and higher, **Velocity** and **Sponge 8**.
-* It **is not** included in **Spigot**, any server software for 1.18.1 and lower, **BungeeCord**, **Sponge 7** and **Fabric**.
-
-If you believe MiniMessage should be supported on your server but doesn't work, open a bug report.
+Yes, however, it must be included in your server software (it is only in Paper / Velocity). Read more about MiniMessage hook [here](https://github.com/NEZNAMY/TAB/wiki/How-to-use-Minecraft-components#minimessage).

 ## #17 - Is it possible to show the number of players in a specific group, similar to staffonline placeholder?
 The plugin's internal placeholders are limited, and this kind of functionality is not included.
@@ -136,4 +151,15 @@ where plugin authors can see how many servers use their plugins (if they don't d
 It also checks for CPU and OS types, which could be the reason for the false positive.
 [Here](https://bstats.org/plugin/bukkit/TAB%20Reborn/5304) is one of TAB's pages as an example.

-Windows defender could be flagging it for the same reason.
+Windows defender could be flagging it for the same reason.
+
+## #19 - How can I show amount of online players on the entire network?
+If you have TAB installed on the proxy, use `%online%` placeholder.  
+If you have TAB installed on the backend servers, use `%bungee_total%` from [PlaceholderAPI](https://github.com/NEZNAMY/TAB/wiki/Quick-PlaceholderAPI-startup-guide). This placeholder has an internal cooldown, which can be configured in `plugins/PlaceholderAPI/config.yml` under `expansions` -> `bungee` -> `check_interval`, default value is 30 (seconds).
+
+## #20 - Why is LuckPerms prefix/suffix not updating on a network?
+In order for LuckPerms instances to pick up the changes to player data in real time, it needs to communicate the changes between proxy ↔ backend.  
+If you notice changes not taking effect in TAB, try running `/lpb user <player> info` (or `/lpv` on velocity). If running the command updates it in TAB, that's the problem - LuckPerms instances not communicating in real time.
+
+This is controlled by a LuckPerms setting called [messaging-service](https://luckperms.net/wiki/Syncing-data-between-servers#messaging-services). Set it to `pluginmsg` to make changes update immediately.  
+Additionally, make sure `auto-push-updates` is still `true` (it is by default already).
@@ -1,5 +1,5 @@
 # About the wiki
-The wiki explains the functionality of the plugin as of version **5.0.5**.
+The wiki explains the functionality of the plugin as of version **6.2.1**.
 If your config looks different or is missing some features, you are using an old version of the plugin.
 To get the latest version, check [releases](https://github.com/NEZNAMY/TAB/releases/).  
 Wiki for older plugin versions is not available.
@@ -10,8 +10,16 @@ This will give you knowledge to do things you had no idea were possible, giving

 A lot of examples on the wiki use PlaceholderAPI placeholders without explaining its installation step by step. If you are going to use the examples and aren't familiar with the plugin, check out [Quick PlaceholderAPI startup guide](https://github.com/NEZNAMY/TAB/wiki/Quick-PlaceholderAPI-startup-guide).

+# Terminology
+On order to not have to explain something every time it is mentioned, it will be explained here once.
+| Name           | Description           |
+|----------------|-----------------------|
+| proxy server   | Server running BungeeCord or Velocity software, which are used to connect multiple servers, allowing easy transfer between them. |
+| modded server  | Fabric, Forge and NeoForge. |
+| backend server | Minecraft server that is actually being played on, not a proxy. This includes Bukkit (and its forks) and modded servers |
+
 # Limitations of plugins
-TAB is a plugin.
+TAB is a plugin (even on modded platforms, it is only a server-sided mod).
 It only modifies the server behavior to your liking.
 It does not add anything into the game.
 Because of that, you'll need
@@ -22,7 +22,7 @@ There are 2 simple steps to this:
 > (for luckperms /lp group \<group\> setweight \<number\>).

 > [!TIP]
-> Verify player's group using `/tab debug <player>`. It should say `Primary permission group: <your group>`.
+> Verify player's group using `/tab dump <player>`, opening the link and check "permissionGroup" in player info.

 ## Option 2: Permission nodes
 Instead of taking whole groups, TAB will check for permission nodes and assign groups based on the highest permission.
@@ -46,7 +46,7 @@ Instead of taking whole groups, TAB will check for permission nodes and assign g
 By default, TAB takes groups from the permission plugin installed on the same server instance.
 In the case of proxy installation, groups are by default taken from the proxy.
 To see how is your proxy permission plugin configured, use its respective command
-(for LuckPerms it's `/lpb user <player> info` instead of `/lp`).
+(for LuckPerms it's `/lpb user <player> info` on BungeeCord and `/lpv user <player> info` on Velocity).

 If you don't have your permission plugin synced using MySQL for sharing groups and don't wish to, and want groups to be taken from backend servers instead, enable the config option:
 ```
@@ -1,6 +1,7 @@
 # Content
 * [Tablist](#tablist)
 * [Nametag](#nametag)
+* [Proper compatibility with plugins that change profile name](#proper-compatibility-with-plugins-that-change-profile-name)
 * [Tips & Tricks](#tips--tricks)
  * [Tip 1 - Nickname prefix](#tip-1---nickname-prefix)
  * [Tip 2 - Sorting nicked players with the lowest priority](#tip-2---sorting-nicked-players-with-the-lowest-priority)
@@ -28,12 +29,22 @@ This example uses `%essentials_nickname%` placeholder from Essentials. Giving it
 > Put the nickname placeholder into customtabname instead.

 # Nametag
-Nametags are more complicated because they consist of player's username, team prefix and team suffix.
-There is no intended way to do this.
-The only way is changing it using a nickname plugin.
-Some nickname plugins actually change name in game profile, which also changes it in nametag.
-You will need to find one that offers this and then use it.
-This is a complicated process with lots of side effects, so TAB does not offer it.
+**TLDR: TAB does not offer this functionality**.
+
+With that out of the way, let's learn more about this issue.  
+Unlike with tablist name formatting, which is a single component containing everything (and therefore fully customizable), nametags are different.
+They consist of prefix and suffix components (coming from scoreboard teams) and name itself.
+This name is contained in player info packet (coincidentally the same one that controls tablist format), along with player's skin and other things.
+This name is limited to 16 characters (since Minecraft doesn't allow longer names) and since it's not a component, naturally it does not support RGB colors.
+Strangely enough, legacy codes using `§` work, but they further limit the length of the rest of the name.
+
+There are really only 2 ways to achieve this solution:
+* **Change the profile name** - This requires sending player info packet that removes the old player and adds a new one with the same name. Then respawn the player. Additionally, it requires a lot of packets to be sent to the affected player, since you cannot just remove & add self, as well as a lot of other packets to restore previously sent data. These packets have been changing a lot with various MC versions. A lot of them cannot even be sent from a proxy server. As such, TAB does not offer this functionality, since it would be very limited anyway (see above) and require a lot of adapting for proper functionality.  
+  If you decide to use a plugin with this functionality, keep in mind it breaks all name-bound features, such as scoreboard teams, belowname or playerlist objective. See below for compatibility information.  
+  Example third party plugins that offer this: None?
+* **Use an armor stand / text display to show any text** - TAB no longer offers this functionality ([here's why](https://gist.github.com/NEZNAMY/f4cabf2fd9251a836b5eb877720dee5c)), so you will need to look into other plugins.  
+  If you decide to use a plugin with this functionality, just remember to make the vanilla nametag invisible, so you don't see both vanilla nametag and the entity (`invisible-nametags: true`).  
+  Example third party plugins that offer this: [UnlimitedNameTags](https://www.spigotmc.org/resources/unlimitednametags.117526/), [DisplayNameTags](https://github.com/Matt-MX/DisplayNameTags), [NotJustNamePlates](https://github.com/YouHaveTrouble/NotJustNameplates), [CustomNameplates](https://polymart.org/product/2543/customnameplates)

 # Proper compatibility with plugins that change profile name
 If using a nickname plugin that changes player's profile name to change it in the name tag,
@@ -41,8 +52,12 @@ this has lots of side effects.
 Most notably, it breaks all name-bound features,
 especially [nametags](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Nametags) and [sorting](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Sorting-players-in-tablist).
 For that reason, TAB must detect name change.
-This is done automatically on Bukkit, BungeeCord and Fabric.
-This detection is not available on Sponge and Velocity.
+
+> [!WARNING]
+> If you have TAB installed on backend server and a proxy plugin changes nickname, TAB is not able to detect this change, since the modified packets never actually go through the backend server where TAB is installed.
+
+> [!TIP]
+> If automatic detection is not working for you (you use proxy plugin for changing names while TAB is on backend), you can use [this API method](https://github.com/NEZNAMY/TAB/blob/master/api/src/main/java/me/neznamy/tab/api/TabPlayer.java#L88) to let TAB know player's name changed.

 In order for TAB to properly detect name change, player UUID must remain the same,
 otherwise it's a random entry with a random uuid and random name, which TAB isn't able to match with actual players.
@@ -62,12 +77,12 @@ conditions:
  nick:
    conditions:
    - '%essentials_nickname%=%player%'
-    yes: "%player%"              # If nickname = player name -> player is not nicked
-    no: "~%essentials_nickname%" # If nickname != player name -> player is nicked
+    true: "%player%"              # If nickname = player name -> player is not nicked
+    false: "~%essentials_nickname%" # If nickname != player name -> player is nicked
 ```
 Then, use `%condition:nick%` in your `customtabname` instead of the placeholder directly.

-# Tip 2 - Sorting nicked players with the lowest priority
+## Tip 2 - Sorting nicked players with the lowest priority
 Let's say your sorting list looks like this:
 ```
  sorting-types:
@@ -80,8 +95,8 @@ conditions:
  group:
    conditions:
    - '%haonick_isNicked%=true'
-    yes: "default"
-    no: "%group%"
+    true: "default"
+    false: "%group%"
 ```
 When the condition is met, meaning player is nicked, it will return the group we want nicked players to be sorted as, in this case `default`. Otherwise, return player's actual group.  
 The condition check may differ with different nickname plugins. You will need to check documentation of your nickname plugin to see what kind of placeholders it offers and what they return (you can also use `/tab parse` to see what exactly did a placeholder return).  
@@ -3,6 +3,7 @@
 * [Notepad++](#notepad-1)
 * [Sublime Text 3](#sublime-text-3)
 * [WinSCP](#winscp)
+* [VSCode](#vscode)
 ***

 # Notepad
@@ -25,4 +26,9 @@ Open the file > Click encoding > Click UTF-8 (if that didn't work, use Convert t
 # WinSCP
 Open the file in WinSCP and check if it is in UTF-8 encoding already (1). If it is not, click on ENCODING at the top (2), select UTF-8 (3) and then save the file. You can now edit the file as you like and paste in characters.
 ![](https://i.ibb.co/nRxDmHk/Win-SCP-Xlxw-Qfft-Cb.png)
-![](https://i.ibb.co/dP77yzp/Win-SCP-UXWc4-Xdp2-N.png)
+![](https://i.ibb.co/dP77yzp/Win-SCP-UXWc4-Xdp2-N.png)
+
+# VSCode
+At the bottom right of VSCode, you can change the current file's encoding. It'll open a pop-up where you can select UTF-8
+![](https://github.com/user-attachments/assets/3ca885ee-24fb-47a5-863b-46b69df42e3a)
+![](https://github.com/user-attachments/assets/ceab40b0-d875-4292-9d75-414557c7d4f8)
@@ -0,0 +1,195 @@
+# Content
+* [About](#about)
+* [RGB Colors (1.16+)](#rgb-colors-116)
+  * [Usage](#usage)
+  * [Magic codes](#magic-codes)
+  * [Invalid code handling](#invalid-code-handling)
+  * [Compatibility with <1.16](#compatibility-with-116)
+* [Fonts (1.16+)](#fonts-116)
+  * [Usage](#usage-1)
+  * [Compatibility with RGB and gradients](#compatibility-with-rgb-and-gradients)
+* [Shadow color (1.21.4+)](#shadow-color-1214)
+* [Object components (1.21.9+)](#object-components-1219)
+  * [Atlas sprite](#atlas-sprite)
+  * [Player sprite](#player-sprite)
+  * [Compatibility with <1.21.9](#compatibility-with-1219)
+* [MiniMessage](#minimessage)
+* [Config options](#config-options)
+* [Tips & Tricks](#tips--tricks)
+  * [Tip 1 - Manually defining legacy color](#tip-1---manually-defining-legacy-color)
+
+# About
+In Minecraft 1.7, new feature called components was introduced. This is an upgrade from using legacy colors (using § symbol) into creating a JSON object where text, color, and magic codes (boolean values) are separated.  
+Additionally, it received new features called hover event and click event. The only place this affects is chat, which TAB does not handle, so these functions are not implemented by TAB at all.
+
+Components have been receiving a lot of new functions since then, which are explained below.
+
+There are also a few config options for components. You can find them in your **config.yml** under `components` section. They are explained [below](#config-options).
+
+# RGB colors (1.16+)
+As of 1.16, mojang introduced RGB color support.
+This allows us to use 16,777,216 different colors instead of the original 16 ones.
+This is not supported on <1.16 in any way.
+
+## Usage
+Supported RGB formats:
+* `#RRGGBB`
+* `&#RRGGBB`
+* `{#RRGGBB}`
+* `#<RRGGBB>`
+* `&x&R&R&G&G&B&B`
+
+Gradients:
+* `<#RRGGBB>Text</#RRGGBB>`
+* `{#RRGGBB>}Text{#RRGGBB<}`
+* `<$#RRGGBB>Text<$#RRGGBB>`
+
+TAB uses the first by default, but is able to accept the other types as well without leaving any characters (such as `{}`) behind.  
+**Gradients only support 2 colors, using more will result in an invalid syntax and won't work.**
+> [!CAUTION]
+> Remember to replace `RRGGBB` with actual hexadecimal numbers (0-9, a-f)!
+
+You can use a tool like [this one](https://htmlcolorcodes.com/) to easily find suitable colors.
+
+## Magic codes
+Just like with legacy colors, use color first, then magic codes (in any order). For example with **bold**: `#00FFFF&lText`.
+
+For gradients, put the magic codes inside the text. Example: `<#00FF00>&lBold gradient text</#FF00FF>`.
+
+## Invalid code handling
+In case you accidentally use invalid hex color code, the plugin will simply ignore it and keep it in raw format.
+
+## Compatibility with <1.16
+Since <1.16 clients do not understand these color codes, something else must be displayed instead.
+TAB, server software or viaversion (depending on your setup)
+will find the closest legacy color to the desired RGB combination and will use that color instead.
+
+# Fonts (1.16+)
+The plugin offers usage of the font feature introduced in Minecraft 1.16.
+> [!IMPORTANT]
+> This does NOT refer to different character sets!
+> This refers to different fonts defined in resource packs or MC itself.
+
+## Usage
+The syntax is `<font:FONT_NAME>Text</font>` where `FONT_NAME` is name of your desired font.
+
+**Example**  
+`<font:minecraft:alt>This is a text written in minecraft enchantment table language which no one understands</font>`
+
+**Result**  
+![image](https://github.com/NEZNAMY/TAB/assets/6338394/9a19cb1b-2761-4500-b058-2e7a7cd68d14)
+
+
+## Compatibility with RGB and gradients
+When trying to use both font and RGB or gradients, font must be outside and RGB/gradients inside.
+
+**Example**  
+`<font:minecraft:alt><#00FF00>This is a colorful text written in minecraft enchantment table language which no one understands, but it looks pretty</#FF0000></font>`
+
+**Result**  
+![image](https://github.com/NEZNAMY/TAB/assets/6338394/81da5bc4-1920-4dad-bcf5-002b5de741f8)
+
+# Shadow color (1.21.4+)
+TAB (currently?) does not have any built-in way to convert text input into shadow color field. However, you can use [MiniMessage](#minimessage) for that. TAB will properly read this value from adventure components and convert it further into Minecraft components.
+
+# Object components (1.21.9+)
+A new component of "object" type was added into the game in 1.21.9. It currently has 2 implementations described below.
+
+## Atlas sprite
+This type allows you to display any item or block. The syntax is
+```
+<sprite:ATLAS:SPRITE>
+```
+where `ATLAS` is the atlas and `SPRITE` is the sprite. Note that atlas can contain the `:` symbol. In order to make TAB recognize it properly, wrap at least the first value into quotes.  
+Example:
+```
+  header:
+    - '&bDiamond helmet: <sprite:"minecraft:items":"minecraft:item/diamond_helmet">'
+    - 'Diamond chestplate: <sprite:"minecraft:items":"minecraft:item/diamond_chestplate">'
+    - 'Diamond leggings: <sprite:"minecraft:items":"minecraft:item/diamond_leggings">'
+    - 'Diamond boots: <sprite:"minecraft:items":"minecraft:item/diamond_boots">'
+```
+<img width="386" height="101" alt="image" src="https://github.com/user-attachments/assets/e9a66305-2ae4-44f4-9d8e-a227fb7591e4" />  
+
+
+> [!IMPORTANT]
+> These values change over MC versions (for example items were in `minecraft:blocks` atlas in 1.21.9 - 1.21.10, but got moved to `minecraft:items` in 1.21.11), so make sure you are using the correct values for your MC version. For proxy installations, you may need to use conditional placeholders and check for player's version. On backend, ViaVersion may or may not automatically translate these.
+
+> [!TIP]
+> For full list of available sprites you can check out https://www.gamergeeks.net/apps/minecraft/list-of-atlas-sprites. However, it doesn't contain any information regarding different Minecraft versions.
+
+
+
+## Player sprite
+
+This type allows you to display Minecraft heads. There are 3 ways to define a head:
+| Type                     | Functionality                                                             |
+|--------------------------|---------------------------------------------------------------------------|
+| Player name              | The client checks recently received profiles (players on current server) and shows skin of player with that name. If no such player was found, connects to Mojang and gets skin of player with specified name. <br />**Note**: This means using a plugin for changing skins will result in the skin being changed here too (the client has a cache, so it won't be visible immediately (restarting the client resets the cache)). If using offline mode and no skin plugin, head won't display correct skin even if such player is registered at Mojang. |
+| Player UUID              | The client checks recently received profiles (players on current server) and shows skin of player with that UUID. If no such player was found, connects to Mojang and gets skin of player with specified UUID. <br />**Note**: This means using a plugin for changing skins will result in the skin being changed here too (the client has a cache, so it won't be visible immediately (restarting the client resets the cache)). |
+| Skin value and signature | The client displays skin from given value and signature |
+
+Here are all the ways you can display player skins using TAB and their implementation (using `ALL CAPS` for "placeholder" text instead of `<>` to avoid confusion as `<>` is actual part of the syntax):
+| Syntax | Explanation | Implementation |
+|-----|-------------|------------|
+| `<head:NAME>` | Shows head defined by player name | name |
+| `<head:UUID>` | Shows head defined by player UUID | uuid |
+| `<mineskin:ID>` | Connects to Mineskin and retrieves value and signature of specified upload ID | value and signature |
+| `<head_texture:TEXTURE>` | Gets the texture from `http://textures.minecraft.net/texture/TEXTURE` | value and signature |
+
+All these syntaxes are identical to MiniMessage syntax for convenience. MiniMessage only supports the first two types by default, but TAB adds tag resolvers for `mineskin` and `head_texture` as well.
+
+Here is an example for all types:
+```
+      footer:
+      - 'Head by id: <head:%uuid%>'  # This will obviously not work in offline mode
+      - 'Head by name: <head:%player%>'  # May or may not work in offline mode (see above for full explanation)
+      - 'Head by mineskin: <mineskin:37e93c8e12cd426cb28fce31969e0674>'
+      - 'Head by texture: <head_texture:ff9bb9e56125c8227b94bbda9f6e0f862931c229255ba8f1205d13c44c1bb561>'
+```
+
+<img width="331" height="111" alt="image" src="https://github.com/user-attachments/assets/5912975a-a892-42c3-b9ab-7eab33ee42b6" />
+
+## Compatibility with <1.21.9
+You may be wondering what happens when you try to use these and the client is below 1.21.9.  
+See table below for behavior based on your setup.
+
+| Setup           | Legacy text decider | Displayed text for <1.21.9 players                                    |
+|-----------------|---------------------|-----------------------------------------------------------------------|
+| Backend <1.21.9 | TAB                 | `<Object components were added in 1.21.9>` (even for 1.21.9+ players) |
+| Backend 1.21.9+ | ViaVersion          | (empty text)                                                          |
+| BungeeCord      | TAB                 | `<Object components were added in 1.21.9>`                            |
+| Velocity        | (no one)            | Client disconnects with a packet decoding error                       |
+
+# MiniMessage
+TAB has [MiniMessage](https://docs.advntr.dev/minimessage/format.html) hook, however, it does not include this library on its own. Including it would cause conflicts, so it has to be included in the server software.
+* It **is** included in **Paper 1.18.2+** and **Velocity**.
+* It **is not** included in **Spigot**, any server software for **1.18.1-**, **BungeeCord**, **Fabric**, **Forge** and **NeoForge**. However, you can install [adventure-platform-mod](https://modrinth.com/mod/adventure-platform-mod) on Fabric / NeoForge.
+
+When MiniMessage is detected on your server, it is automatically used unless support is disabled. All codes are translated to MiniMessage syntax and then parsed by MiniMessage.
+
+TAB creates a modified MiniMessage parser that also accepts `<head_texture:TEXTURE>` and `<mineskin:ID>` head syntaxes just like TAB's own component parser.
+
+# Config options
+| Option name              | Default value | Description                                                                                                                                |
+|--------------------------|---------------|--------------------------------------------------------------------------------------------------------------------------------------------|
+| minimessage-support      | true          | Enables / Disables MiniMessage support (if it's available).                                                                                |
+| disable-shadow-for-heads | true          | Automatically disables shadows for head object components (1.21.9+) to match the appearance of online-mode heads, which don't use shadows. |
+
+# Tips & Tricks
+## Tip 1 - Manually defining legacy color
+For features that don't depend on any other players (header/footer, bossbar, scoreboard), you can easily specify legacy color instead of automatic rounding for <1.16 players. This can be done using [conditional placeholders](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders).
+
+Check for `%player-version-id%`, which returns network protocol id of the version, which can be easily compared to. 1.16's version is `735`. Final condition may look like this:
+
+```
+conditions:
+  rgb:
+    conditions:
+    - '%player-version-id%>=735'
+    true: "#00FF00 RGB text"
+    false: "&a Legacy text"
+```
+Then, use this condition with `%condition:rgb%`.
+
+This will not work in nametags and tablist formatting, because this would parse the condition for target player, not the viewer. To achieve this, you'll need a custom-made [relational placeholder](https://github.com/NEZNAMY/TAB/wiki/Placeholders#relational-placeholders) that checks for viewer's version.
@@ -1,72 +0,0 @@
-# Content
-* [Introduction](#introduction)
-* [Usage](#usage)
-  * [Magic codes](#magic-codes)
-* [Invalid code handling](#invalid-code-handling)
-* [Compatibility with <1.16](#compatibility-with-116)
-* [Fonts](#fonts)
-  * [Usage](#usage-1)
-  * [Compatibility with RGB and gradients](#compatibility-with-rgb-and-gradients)
-
-# Introduction
-As of 1.16, mojang introduced RGB color support.
-This allows us to use 256^3 different colors instead of the original 16 ones.
-This is not supported on <1.16 in any way.
-
-# Usage
-Supported RGB formats:
-* `#RRGGBB`
-* `&#RRGGBB`
-* `{#RRGGBB}`
-* `#<RRGGBB>`
-* `&x&R&R&G&G&B&B`
-
-Gradients:
-* `<#RRGGBB>Text</#RRGGBB>`
-* `{#RRGGBB>}Text{#RRGGBB<}`
-* `<$#RRGGBB>Text<$#RRGGBB>`
-
-TAB uses the first by default, but is able to accept the other types as well without leaving any characters (such as `{}`) behind.  
-**Gradients only support 2 colors, using more will result in an invalid syntax and won't work.**
-> [!CAUTION]
-> Remember to replace `RRGGBB` with actual hexadecimal numbers (0-9, a-f)!
-
-You can use a tool like [this one](https://htmlcolorcodes.com/) to easily find suitable colors.
-
-## Magic codes
-Just like with legacy colors, use color first, then magic codes (in any order). For example with **bold**: `#00FFFF&lText`.
-
-For gradients, put the magic codes at the beginning of text. For example `<#00FF00>&lBold gradient text</#FF00FF>`.
-
-# Invalid code handling
-In case you accidentally use invalid hex color code, the plugin will simply ignore it and keep it in raw format.
-
-# Compatibility with <1.16
-Since <1.16 clients do not understand these color codes, something else must be displayed instead.
-TAB, server software or viaversion (depending on your setup)
-will find the closest legacy color to the desired RGB combination and will use that color instead.
-
-# Fonts
-The plugin offers usage of the font feature introduced in Minecraft 1.16.
-> [!IMPORTANT]
-> This does NOT refer to different character sets!
-> This refers to different fonts defined in resource packs or MC itself.
-
-## Usage
-The syntax is `<font:FONT_NAME>Text</font>` where `FONT_NAME` is name of your desired font.
-
-**Example**  
-`<font:minecraft:alt>This is a text written in minecraft enchantment table language which no one understands</font>`
-
-**Result**  
-![image](https://github.com/NEZNAMY/TAB/assets/6338394/9a19cb1b-2761-4500-b058-2e7a7cd68d14)
-
-
-## Compatibility with RGB and gradients
-When trying to use both font and RGB or gradients, font must be outside and RGB/gradients inside.
-
-**Example**  
-`<font:minecraft:alt><#00FF00>This is a colorful text written in minecraft enchantment table language which no one understands, but it looks pretty</#FF0000></font>`
-
-**Result**  
-![image](https://github.com/NEZNAMY/TAB/assets/6338394/81da5bc4-1920-4dad-bcf5-002b5de741f8)
@@ -1,18 +1,16 @@
 # Content
 * [Backend](#backend)
-* [BungeeCord / Velocity](#bungeecord--velocity)
+* [Proxy](#proxy)
  * [Proxy installation](#proxy-installation)
  * [Backend installation](#backend-installation)
  * [Mixed installation](#mixed-installation)
 * [Updating the plugin](#updating-the-plugin)

 # Backend
-Installation on Bukkit / Fabric / Sponge is as simple as it can be.
-Put the plugin into the plugins folder and restart the server.  
-Dynamic (re)loads at runtime such as `/plugman load tab` to load the plugin are fully supported.
-However, plugins hooking into TAB may break when you use such ways to (re)load it.
+Installation on backend servers is as simple as it can be.
+Put the plugin into the plugins folder and restart the server.

-# BungeeCord / Velocity
+# Proxy
 When running a network, you have 3 options:
 * Installing TAB only on the proxy (recommended)
 * Installing TAB on all backend servers instead
@@ -29,14 +27,15 @@ Install [TAB-Bridge](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge) on your **b
 If you are using **Velocity**,
 install [VelocityScoreboardAPI](https://github.com/NEZNAMY/VelocityScoreboardAPI/) plugin **on the proxy** for scoreboard-related features to work.

-> [!NOTE]  
+> [!NOTE]
 > With proxy installation, use **/btab** command instead of **/tab**.

 Advantages of proxy installation compared to installing on all backend servers instead:
-* Can use the [Global player list](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist) and [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) can work with all players connected to the proxy
-* Can use new content for new clients even if a backend server version is old (1.16+ RGB codes, 1.20.3+ scoreboard features)
+* Can use the [Global player list](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist) without requiring Redis set up
+* [Layout](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Layout) can work with all players connected to the proxy
 * Avoid [header/footer](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Header-&-Footer#additional-note-1---not-resetting-on-server-switch) and [bossbar](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Bossbar#additional-note-2---not-hiding-on-server-switch) not disappearing on server switch
 * Configuration files in a single place for easier editing / no need to use MySQL for syncing data
+* Can use new features for new players even if backend is using an older version (RGB, 1.20.3+ NumberFormat and more).


 Disadvantages compared to installing on all backend servers instead:
@@ -46,11 +45,12 @@ Disadvantages compared to installing on all backend servers instead:
 Just like when not running a network, install the plugin on all servers where you want the plugin. However, this setup is not as good (see advantages of proxy installation).

 ## Mixed installation
-Mixed installation is absolutely not recommended and should be avoided.
-It requires you to disable features to make only 1 instance handle a single feature at a time,
-which most people fail miserably to do,
-resulting in issues such as header/footer flashing between proxy and backend configuration.
-With bridge, you are able to achieve almost anything with proxy installation.
+Mixed installation is absolutely not supported and should be avoided.
+
+There is no sort of communication between backend and proxy TAB installations (this is only done by TAB-Bridge, which doesn't do anything on its own). Having TAB on both proxy and backend is effectively installing 2 plugins to do the same thing, which will naturally cause issues (although TAB's anti-override for key features should help with this).
+
+If you really wish to proceed (for example having feature X handled by proxy and feature Y on backend), make sure to properly disable features (`enabled: false`) to avoid problems. However, the only case where this makes any sense is per world playerlist feature, which is not available on proxies. Everything else can be done from proxy side.
+

 # Updating the plugin
 Updating the plugin is always as simple as replacing old jar with the new one.
@@ -61,5 +61,5 @@ TAB will automatically convert your existing configuration files to the latest f
 (most notably 2.9.2 → 3.0.0, but any other changes as well).

 Downgrading is completely unsupported, as an old plugin version cannot know what the future config format is / will be.
-Just like Minecraft itself.
-There is no reason for downgrading anyway, as every version is superior to older versions released before it.  
+Just like Minecraft itself, although TAB won't fail with an error message like Minecraft does, but you will get warnings and / or features not working correctly.  
+There is no reason for downgrading anyway, since in general, every version is typically superior to older versions released before it.  
@@ -1,5 +1,5 @@
 # About
-This is collection if minecraft issues/bugs you may experience when using TAB, which are not TAB bugs and cannot be fixed with a plugin.
+This is collection if Minecraft issues/bugs you may experience when using TAB, which are not TAB bugs and cannot be fixed with a plugin.

 # 1.5.x - 1.12.x - Unwanted space
 You may see unwanted space at the end of a line of text even if you didn't configure any.
@@ -9,6 +9,7 @@ Combine the knowledge gathered by reading the wiki to get interesting results, m
 * [Showing combined online player count from multiple servers](#showing-combined-online-player-count-from-multiple-servers)
  * [Option 1 - Using global playerlist](#option-1---using-global-playerlist)
  * [Option 2 - Using PlaceholderAPI](#option-2---using-placeholderapi)
+* [Showing head components only to 1.21.9+ players](#showing-head-components-only-to-1219-players)

 # Displaying kill / death counter in tablist
 This example uses PlaceholderAPI placeholders.  
@@ -37,7 +38,7 @@ _DEFAULT_:
 ```
 This requires Vault and a permission plugin to work.  
 If you have luckperms installed on the same server instance, you can use TAB's internal `%luckperms-prefix%` (and suffix) placeholders instead.  
-**Note:** If TAB is on bungeecord, and you want prefixes to be taken from backend servers, use `%vault_prefix%` (or `%luckperms_prefix%`) with [PlaceholderAPI support on bungeecord](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge).
+**Note:** If TAB is on a proxy, and you want prefixes to be taken from backend servers, use `%vault_prefix%` (or `%luckperms_prefix%`) with [PlaceholderAPI support on proxy](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge).

 # Showing player's version in tablist
 Run `/tab group _DEFAULT_ tabsuffix " &8[&3%player-version%&8]"` or any other color combination you want. You can also include other placeholders with it. You can also modify it directly in **groups.yml** file instead. With the provided example command, you'll get the following result:  
@@ -63,13 +64,13 @@ conditions:
  tps:
    conditions:
      - "%tps%>=19"
-    yes: "<#55FF55>%tps%</#00AA00>"
-    no: "%condition:tps2%"
+    true: "<#55FF55>%tps%</#00AA00>"
+    false: "%condition:tps2%"
  tps2:
    conditions:
      - "%tps%>=15"
-    yes: "<#FFFF55>%tps%</#FFAA00>"
-    no: "<#FF5555>%tps%</#AA0000>"
+    true: "<#FFFF55>%tps%</#FFAA00>"
+    false: "<#FF5555>%tps%</#AA0000>"
 ```
 To use this, we will use `%condition:tps%`.  
 Now, repeat for mspt and ping. For mspt, purpur's intervals are <40, <50, 50+. For ping, it's <100, <200, 200+.
@@ -80,23 +81,23 @@ conditions:
  mspt:
    conditions:
      - "%mspt%<40"
-    yes: "<#55FF55>%mspt%</#00AA00>"
-    no: "%condition:mspt2%"
+    true: "<#55FF55>%mspt%</#00AA00>"
+    false: "%condition:mspt2%"
  mspt2:
    conditions:
      - "%mspt%<50"
-    yes: "<#FFFF55>%mspt%</#FFAA00>"
-    no: "<#FF5555>%mspt%</#AA0000>"
+    true: "<#FFFF55>%mspt%</#FFAA00>"
+    false: "<#FF5555>%mspt%</#AA0000>"
  ping:
    conditions:
      - "%ping%<100"
-    yes: "<#55FF55>%ping%</#00AA00>"
-    no: "%condition:ping2%"
+    true: "<#55FF55>%ping%</#00AA00>"
+    false: "%condition:ping2%"
  ping2:
    conditions:
      - "%ping%<200"
-    yes: "<#FFFF55>%ping%</#FFAA00>"
-    no: "<#FF5555>%ping%</#AA0000>"
+    true: "<#FFFF55>%ping%</#FFAA00>"
+    false: "<#FF5555>%ping%</#AA0000>"
 ```
 To use them, we will use `%condition:mspt%` and `%condition:ping%`. Purpur's TPSBar is using mspt as bossbar progress with range from 0 to 50. This can be achieved with PlaceholderAPI's math expansion: `%math_0_{tab_placeholder_mspt}*2%`. It always uses `GREEN` color and `NOTCHED_20` style. Let's put all of this together:
 ```
@@ -137,8 +138,8 @@ conditions:
  rankOrTeam:
    conditions:
      - "%bw1058_player_team%="
-    yes: "%luckperms-prefix%"
-    no: "%bw1058_player_team%"
+    true: "%luckperms-prefix%"
+    false: "%bw1058_player_team%"
 ```
 And then do `/tab group _DEFAULT_ tabprefix %condition:rankOrTeam%` and `/tab group _DEFAULT_ tagprefix %condition:rankOrTeam%` so it shows in your nametag and in your tablist name.

@@ -203,4 +204,31 @@ Unlike the first option, this one offers much more freedom, but also requires an
 First, you need placeholders for online count on specific servers. Bungee expansion does exactly that. The format is `%bungee_<server>%`. To merge the online counts, use math expansion. The syntax will be `%math_0_<expression>%`, where `expression` uses online counts from specific servers from bungee expansion. Finally, you'll end up with a placeholder like `%math_0_{bungee_lobby1}+{bungee_lobby2}%`. This placeholder will merge online counts from `lobby1` and `lobby2`.  
 Please note that by default, bungee expansion updates values only every 30 seconds. This can be changed in PlaceholderAPI's config. If the numbers still don't show correct value, check if the placeholder works correctly using `/papi parse me <placeholder>`. If not, this is not a TAB issue.

-Advantage of this is no requirement for a specific TAB feature to be enabled, which also includes no need to have TAB installed on the proxy. The downside is relying on 3rd party software. If TAB is on proxy, you'll also need [bridge plugin](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge).  
+Advantage of this is no requirement for a specific TAB feature to be enabled, which also includes no need to have TAB installed on the proxy. The downside is relying on 3rd party software. If TAB is on proxy, you'll also need [bridge plugin](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge).
+
+# Showing head components only to 1.21.9+ players
+Object components were added in 1.21.9, which means they cannot be shown to 1.21.8- players. [If you try to do so, you'll either get an ugly text (BungeeCord / backend), or disconnect with a packet decode error (on Velocity)](https://github.com/NEZNAMY/TAB/wiki/How-to-use-Minecraft-components#compatibility-with--1219).
+
+To achieve this goal, we will use [relational conditions](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders#relational-conditions) and check if viewer is 1.21.9+:
+```
+conditions:
+  head:
+    conditions:
+      - "%viewer:player-version-id%>=773"
+    true: "<head:name:%player%> "
+    false: ""  # Show nothing
+```
+The `773` is the protocol version of 1.21.9, so we can use a simple math operation instead of comparing strings. You can check [TAB's source code](https://github.com/NEZNAMY/TAB/blob/master/shared/src/main/java/me/neznamy/tab/shared/ProtocolVersion.java) for the full list. This condition will return head component of the **target** player if the **viewer** is 1.21.9+, empty value otherwise.  
+[If you want to use this head syntax, you'll need to disable MiniMessage support](https://github.com/NEZNAMY/TAB/wiki/How-to-use-Minecraft-components#player-sprite), or use a syntax supported by MiniMessage (which is currently extremely limited).  
+Use this condition with `%rel_condition:head%`. The rel is important, so TAB knows the placeholder is a relational placeholder. If you forget to, the condition will return a warning message instead of configured value.  
+To showcase it, I have this in **groups.yml** (to show player versions as well):
+```
+_DEFAULT_:
+  tabprefix: "%rel_condition:head%"
+  tabsuffix: " %player-version% (%player-version-id%)"
+```
+1.21.11 player's view:  
+<img width="634" height="103" alt="image" src="https://github.com/user-attachments/assets/4c762fae-3166-4247-865f-c87d1916afd7" />
+
+1.21.8 player's view:  
+<img width="581" height="106" alt="image" src="https://github.com/user-attachments/assets/cb7ab93d-0db5-4968-bcfe-60004125ddf1" />
@@ -1,5 +1,4 @@
 * [About](#about)
-* [Availability](#availability)
 * [Enabling](#enabling)
 * [Configuration changes](#configuration-changes)
 * [Data conversion](#data-conversion)
@@ -17,19 +16,6 @@ It may be added in the future.

 All tables from TAB are prefixed with `tab_`, currently `tab_groups` for groups and `tab_users` for users.

-# Availability
-Before attempting to use the function, make sure your server software has an integrated MySQL driver.
-TAB does not contain it by itself.
-See the compatibility table below for current information about compatibility:
-
-| Platform   | Available |
-|------------|-----------|
-| Bukkit     | ✔         |
-| BungeeCord | ✔         |
-| Fabric     | ❌         |
-| Sponge     | ❌         |
-| Velocity   | ❌         |
-
 # Enabling
 Find this section in **config.yml**:
 ```
@@ -1,82 +1,46 @@
+# Content
+* [About](#about)
+* [Ways of optimizing](#ways-of-optimizing)
+  * [#1 - [All platforms] Static text instead of placeholders](#1---all-platforms-static-text-instead-of-placeholders)
+  * [#2 - [All platforms] Placeholder refresh intervals](#2---all-platforms-placeholder-refresh-intervals)
+  * [#3 - [All platforms] Don't use RGB](#3---all-platforms-dont-use-rgb)
+  * [#4 - [All platforms] Don't use animations](#4---all-platforms-dont-use-animations)
+  * [#5 - [All platforms] Disable tablist name formatting](#5---all-platforms-disable-tablist-name-formatting)
+  * [#6 - [All platforms] Increase permission refresh interval](#6---all-platforms-increase-permission-refresh-interval)
+  * [#7 - [Proxies] Disable TAB expansion](#7---proxies-disable-tab-expansion)
+  * [#8 - [Proxies] Disable update-latency option in global playerlist](#8---proxies-disable-update-latency-option-in-global-playerlist)
+* [Netty false positive in spark reports](#netty-false-positive-in-spark-reports)
+  * [Why there is a false positive](#why-there-is-a-false-positive)
+  * [How to read the real value](#how-to-read-the-real-value)
+    * [Packet listening usage](#packet-listening-usage)
+    * [Sending packets](#sending-packets)
+
+# About
 This guide will explain all primary ways you can reduce plugin's CPU usage besides the obvious things like "don't spam animations" or "disable features you don't want".  
 The usage can be checked at any time using [**/tab cpu**](https://github.com/NEZNAMY/TAB/wiki/Commands-&-Permissions#tab-cpu) command. If the numbers appear to be higher than they should be, check this guide for various ways to optimize the plugin. Most of these apply for all platforms, but some of them are only specific for some platforms.

-# Content
-* [#1 - [All platforms] Static text instead of placeholders](#1---all-platforms-static-text-instead-of-placeholders)
-* [#2 - [All platforms] Placeholder refresh intervals](#2---all-platforms-placeholder-refresh-intervals)
-* [#3 - [All platforms] Don't use RGB](#3---all-platforms-dont-use-rgb)
-* [#4 - [All platforms] Don't use animations](#4---all-platforms-dont-use-animations)
-* [#5 - [All platforms] Disable anti-override](#5---all-platforms-disable-anti-override)
-* [#6 - [All platforms] Disable tablist name formatting](#6---all-platforms-disable-tablist-name-formatting)
-* [#7 - [All platforms] Increase permission refresh interval](#7---all-platforms-increase-permission-refresh-interval)
-* [#8 - [BungeeCord / Velocity] Disable TAB expansion](#8---bungeecord--velocity-disable-tab-expansion)
-* [#9 - [BungeeCord / Velocity] Disable update-latency option in global playerlist](#9---bungeecord--velocity-disable-update-latency-option-in-global-playerlist)
-* [#10 - [BungeeCord] Disable ByteBuf deserialization](#10---bungeecord-disable-bytebuf-deserialization)
-
-# #1 - [All platforms] Static text instead of placeholders
+# Ways of optimizing
+## #1 - [All platforms] Static text instead of placeholders
 Static text doesn't need to be refreshed periodically, resulting in better performance.
 Some placeholders can be replaced with static text, such as placeholder for max player counts,
 since that value doesn't change at runtime.
 Another option is to configure prefixes per-group in config
 instead of using placeholders to take those values from your permission plugin.

-# #2 - [All platforms] Placeholder refresh intervals
-Some placeholders take a long time to process and result in high cpu usage. However, this can be optimized by configuring refresh interval of placeholders.
+## #2 - [All platforms] Placeholder refresh intervals
+Some placeholders take a long time to process and result in high cpu usage. However, this can be optimized by configuring refresh interval of placeholders.  
+See [Placeholders - Refreshing](https://github.com/NEZNAMY/TAB/wiki/Placeholders#refreshing) for information about modifying refresh intervals of placeholders.

-This only works for PlaceholderAPI placeholders. Internal ones have an interval hardcoded already with values I found the most appropriate.
-
-To begin, find this part in your config
-```yml
-placeholderapi-refresh-intervals:
-  default-refresh-interval: 500
-  "%server_uptime%": 1000
-  "%server_tps_1_colored%": 1000
-  "%player_health%": 200
-  "%player_ping%": 1000
-  "%vault_prefix%": 1000
-  "%rel_factionsuuid_relation_color%": 500
-```
-Refresh interval is in milliseconds. It must be divisible by 50.
-
-`default-refresh-interval` is refresh interval for all unlisted PlaceholderAPI placeholders.
-
-Keep in mind that CPU measurement is reset every 10 seconds.
-This means that if you configure a higher refresh interval than 10000,
-there will be intervals when placeholder didn't refresh at all,
-making it look like the CPU is perfect, while on the next refresh it may be high.
-For this reason, if you want to cleanly track usage, keep the interval at 10000 at most.
-Using a higher interval will help if needed, but may lead to misleading info in cpu output.
-
-# #3 - [All platforms] Don't use RGB
+## #3 - [All platforms] Don't use RGB
 Though RGB colors look good, they require the text to be split into several components with `color` field used instead of the whole text pasted into the `text` field. This is a complicated process that takes quite some time. Sticking to legacy colors results in better performance.

-# #4 - [All platforms] Don't use animations
+## #4 - [All platforms] Don't use animations
 While animations look cool, they also have a high resource usage.
 This is because they work by spamming updates every time an animation switches to a new frame.
 When animations are not used, no updates need to be sent (unless another placeholder changes value),
 not causing extra CPU usage.

-# #5 - [All platforms] Disable anti-override
-By default, TAB prevents other plugins from overriding it.
-This is because many server owners are not competent enough to configure their plugins correctly,
-such as disabling CMI collision handling which breaks nametags or even disabling team handling in paper.
-This obviously causes higher CPU usage.
-TAB logs all override attempts of teams into [anti-override.log](https://github.com/NEZNAMY/TAB/wiki/Action-logging#anti-overridelog) file.
-If you didn't get the file, it looks like you configured your plugins correctly.
-In that case, you can disable anti-override for teams in TAB.
-```
-scoreboard-teams:
-  anti-override: false
-```
-Tablist formatting is trickier, as override attempts are not logged because it would have a lot of false positives.
-You will need to try and see.
-
-```
-tablist-name-formatting:
-  anti-override: false
-```
-
-# #6 - [All platforms] Disable tablist name formatting
+## #5 - [All platforms] Disable tablist name formatting
 As we already know from [Client-sided mechanics](https://github.com/NEZNAMY/TAB/wiki/Client%E2%80%90sided-mechanics#nametag-format-in-tablist) page,
 the nametag format appears in tablist if tablist name is not defined.
 You can take advantage of this to effectively disable one entire feature and its cpu usage,
@@ -87,12 +51,11 @@ However, you can only do this if:

 Whether you have another plugin attempting to handle them or not may not be easy to identify with a lot of plugins and not enough time spent configuring them. In that case, your best choice is to try it and see. If tablist names break, it means you have another plugin and cannot take advantage of this optimization option.

-# #7 - [All platforms] Increase permission refresh interval
+## #6 - [All platforms] Increase permission refresh interval
 Plugin needs to constantly check permissions for:
 * Permission checks in conditions
 * Permission checks if sorting by permissions
 * Group retrieving from permission plugin (for sorting / per-group properties)
-* Prefix/suffix placeholders taking data from your permission plugin

 default value
 ```
@@ -102,7 +65,7 @@ Refreshes them every second.
 If you don't need any permission/group changes to take effect within a second,
 you can increase this value for better performance.

-# #8 - [BungeeCord / Velocity] Disable TAB expansion
+## #7 - [Proxies] Disable TAB expansion
 To maximize the performance of TAB's response to PlaceholderAPI request,
 values are tracked in advance and then quickly returned.
 This process takes resources and is especially heavy on proxy installation,
@@ -113,24 +76,57 @@ Disabling TAB's PlaceholderAPI expansion if you don't use it improves performanc
 placeholders:
  register-tab-expansion: false
 ```
-# #9 - [BungeeCord / Velocity] Disable update-latency option in global playerlist
+## #8 - [Proxies] Disable update-latency option in global playerlist
 When [Global playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist) is enabled, you can enable / disable [update-latency](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist#:~:text=other%20unlisted%20servers.-,update%2Dlatency,-false) option (open the link for detailed description of the option). Disabling this option massively improves performance.

-# #10 - [BungeeCord] Disable ByteBuf deserialization
-In order for anti-override to work properly, some packets must be manually deserialized due to BungeeCord not doing it. If you don't need it, you can disable those functions, which will also disable the deserialization completely. To do so, you must disable 2 functions (only having 1 disabled is not enough):  
-#1 - Anti-override for teams
-```
-scoreboard-teams:
-  anti-override: false
-```
-Whether you need anti-override or not depends on the configuration of your plugins.
-The easiest way is to have it enabled and see if you get `anti-override.log` file in TAB folder.
-If you don't, you don't need it.
-If you do, you'll need to do some configuring.
-[Here](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Sorting-players-in-tablist#additional-note-3---compatibility-issues-with-other-plugins)
-are a few examples of software and their team names, which you may find helpful.
+# Netty false positive in spark reports
+When taking a spark report with all threads monitored instead of just the server thread using `--thread *` argument (or on a proxy where this is enabled by default since there is no main thread to monitor by default), you may notice high usage (both CPU and RAM) in netty thread when grouping threads by plugin. **Vast majority of that usage is false positive.** Let's go over why this is the case and how to read the real value.

-#2 - Scoreboard detection of other plugins
-TAB checks for packets sent by other plugins, and if another plugin sends a scoreboard,
-TAB hides its own and resends it after the other plugin removes it.
-This check cannot be disabled if the scoreboard is enabled.
+## Why there is a false positive
+When listening to an event, the server fires the events in a loop, where each event is the end point. As such, measuring every event handler individually is accurate. Here is how the hierarchy looks with example numbers:
+```
+Event processing in loop (6ms total)
+↳ Plugin 1 (1ms)
+↳ Plugin 2 (2ms)
+↳ Plugin 3 (3ms)
+End of loop
+```
+As such, the measured values are accurate and spark is able to separate each event handler based on plugin. Command executions and repeating tasks are even simpler.
+
+The issue is with netty injection. The purpose is to listen to outgoing packets, react to them and possibly modify them. Unlike with events, these are not processed in parallel, but every handler forwards the packet to the next one (or doesn't if it should be cancelled). As such, the hierarchy looks like this (simplified version):
+```
+Beginning (12ms total)
+↳ Plugin 1 (1ms self, 12ms total)
+  ↳ Plugin 2 (1ms self, 11ms total)
+    ↳ Plugin 3 (1ms self, 10ms total)
+      ↳ Minecraft encoder (10ms self)
+```
+As such, spark will show 12ms total for Plugin 1, even though its own usage is only 1ms. This is due to a limitation of the design of Spark in combination with how netty handlers work. This is only the case for plugins with their own netty injection, it does not apply to plugins that use ProtocolLib, because that one offers event-like functionality explained above. In this case, the usage shown in spark report is 100% accurate.
+
+## How to read the real value
+An actual usage of the netty threads can be split into 2 parts:
+* Listening to outgoing packets
+* Sending packets, which causes it to go though the pipeline and then encode
+
+### Packet listening usage
+This one is simple and accurate. Take the shown number, expand the call stack and subtract `io.netty.channel.ChannelDuplexHandler.write()` usage, which is forwarding the packet to the next handler and would be there even if that plugin wasn't injected.  
+Let's take a look at a practical example:
+<img width="1091" height="266" alt="image" src="https://github.com/user-attachments/assets/6d9e8c25-8375-413b-ab9b-31b52ff9262c" />
+
+Here, spark reports `31.71%` usage by TAB. However, `30.87%` of it is forwarding it to the next handler (`io.netty.channel.ChannelDuplexHandler.write()`), which forwards it to the next one, until eventually the server encodes the packet. Therefore, TAB's real usage by listening to outgoing packets in this report is `31.71%` - `30.87%` = `0.84%`. Much less than what you originally see.
+
+### Sending packets
+Sadly, this one is impossible to calculate directly. When a packet is scheduled for sending, it is only added to a queue, then consumed by a netty thread, not the caller thread. At that point we are losing information about where a packet comes from.  
+There is some good news though.
+
+First, vast majority of plugins barely send any packets. For example PlaceholderAPI is just an interface between plugins, chat plugins only modify chat message packets that would be sent anyway, ViaVersion same thing, and so on...
+
+
+Second, plugins that send a lot of packets usually send the kind that the server either doesn't send at all, or not much. Expanding the data from the previously shown report gives us this:
+<img width="1083" height="496" alt="image" src="https://github.com/user-attachments/assets/c6157e78-ef6a-4d9c-b4b7-7c7b32dd14f8" />
+
+Here we can see that encoding team packets took 0.99%. Since TAB is the only team plugin you need for managing players, it is safe to assume most, if not all of it comes from TAB.  
+Same here - 0.13% from header and footer.
+<img width="1085" height="93" alt="image" src="https://github.com/user-attachments/assets/559dce56-83d3-49b2-9f4b-29b6124f944c" />
+
+Sadly there are other operations needed than just encoding packets, such as allocating buffers and other, so this part is not that simple anymore.
@@ -3,8 +3,9 @@
 * [Internal placeholders](#internal-placeholders)
  * [Universal](#universal)
  * [Backend only](#backend-only)
-  * [BungeeCord only](#bungeecord-only)
+  * [Proxy only](#proxy-only)
 * [PlaceholderAPI](#placeholderapi)
+* [MiniPlaceholders](#miniplaceholders)
 * [Relational placeholders](#relational-placeholders)
  * [About](#about-1)
  * [Usage](#usage)
@@ -28,55 +29,61 @@ Basic placeholders provided by the plugin. Most of these placeholders were added

 Placeholders must be refreshed.
 All internal placeholders have a manually defined refresh interval,
-which I found the most optimal and cannot be changed.
+which I found the most optimal. You can [override the refresh intervals](https://github.com/NEZNAMY/TAB/wiki/Optimizing-the-plugin#2---all-platforms-placeholder-refresh-intervals) if you want to.
 Time is in milliseconds.
-It is used for placeholders which are in fact constants (such as %player%),
+`-1` is used for placeholders which are in fact constants (such as %player%),
 or fire an event each time they change, which can be listened to (such as %world%) and value updated.
 Refresh interval for conditions is set to be equal to the fastest refreshing placeholder used inside each condition.

 ## Universal
 These placeholders are available on all platforms.

-| Identifier          | Refresh interval | Description                                                                                                                                                                                                                                                                                                                                          |
-|---------------------|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| %online%            | 1000             | Total online player count on server where plugin is installed (excluding [vanished players](https://github.com/NEZNAMY/TAB/wiki/Additional-information#vanish-detection)). If the plugin is installed on a proxy, it will show total player count on the whole network.                                                                              |
-| %world%             | -1               | Name of world where player is                                                                                                                                                                                                                                                                                                                        |
-| %worldonline%       | 1000             | Amount of players in the same world (excluding [vanished players](https://github.com/NEZNAMY/TAB/wiki/Additional-information#vanish-detection)) as the player                                                                                                                                                                                        |
-| %ping%              | 500              | Player's ping to the server where TAB is installed. <br />**Note**: This value is measured by the server and TAB is only retrieving that value. If it's wrong, it's not a TAB issue.                                                                                                                                                                 |
-| %player%            | -1               | Player's name                                                                                                                                                                                                                                                                                                                                        |
-| %time%              | 500              | Current real time, output is configurable in **config.yml** in `time-format` option                                                                                                                                                                                                                                                                  |
-| %date%              | 60000            | Current date, output is configurable in **config.yml** in `date-format` option                                                                                                                                                                                                                                                                       |
-| %staffonline%       | 2000             | Amount of online players with `tab.staff` permission                                                                                                                                                                                                                                                                                                 |
-| %nonstaffonline%    | 2000             | Amount of online players without `tab.staff` permission                                                                                                                                                                                                                                                                                              |
-| %memory-used%       | 200              | Used RAM of server in MB                                                                                                                                                                                                                                                                                                                             |
-| %memory-max%        | -1               | Total RAM of server in MB                                                                                                                                                                                                                                                                                                                            |
-| %memory-used-gb%    | 200              | Used RAM of server in GB                                                                                                                                                                                                                                                                                                                             |
-| %memory-max-gb%     | -1               | Total RAM of server in GB                                                                                                                                                                                                                                                                                                                            |
-| %player-version%    | -1               | User-friendly version of player, such as `1.14.4`. For versions that share the same protocol version number, the higher one is returned (for example 1.20 & 1.20.1 -> 1.20.1 is returned)                                                                                                                                                            |
-| %player-version-id% | -1               | Network ID of player's version. You can see the full version map on [fan wiki](https://wiki.vg/Protocol_version_numbers) for all versions or [TAB's source code](https://github.com/NEZNAMY/TAB/blob/master/shared/src/main/java/me/neznamy/tab/shared/ProtocolVersion.java) for releases only. Useful for conditions to create per-version results. |
-| %luckperms-prefix%  | 1000             | Prefix from LuckPerms from the server where TAB is installed                                                                                                                                                                                                                                                                                         |
-| %luckperms-suffix%  | 1000             | Suffix from LuckPerms from the server where TAB is installed                                                                                                                                                                                                                                                                                         |
-| %displayname%       | 500              | Display name variable set by permission plugin, typically prefix + name + suffix                                                                                                                                                                                                                                                                     |
-| %group%             | 1000             | Returns player's primary group name. Created for internal functionality, but can be used as a display placeholder as well.                                                                                                                                                                                                                           |
-| %vanished%          | 1000             | Returns `true`/`false` based on player's vanish status. Created for internal functionality, but can be used as a display placeholder as well.                                                                                                                                                                                                        |
-| %bedrock%           | -1               | Returns `true`/`false` based on whether player is using Bedrock edition or not (Java)                                                                                                                                                                                                                                                                |
-| %%                  | -1               | Returns the `%` symbol. Useful to display `%` symbol without breaking all placeholders after it                                                                                                                                                                                                                                                      |
+| Identifier                                | Refresh interval | Description                                                                                                                                                                                                                                                                                                                            |
+|-------------------------------------------|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| %online%                                  | 1000             | Total online player count on server where plugin is installed (excluding [vanished players](https://github.com/NEZNAMY/TAB/wiki/Additional-information#vanish-detection)). If the plugin is installed on a proxy, it will show total player count on the whole network.                                                                |
+| %world%                                   | -1               | Name of world where player is                                                                                                                                                                                                                                                                                                          |
+| %worldonline%                             | 1000             | Amount of players in the same world (excluding [vanished players](https://github.com/NEZNAMY/TAB/wiki/Additional-information#vanish-detection)) as the player                                                                                                                                                                          |
+| %ping%                                    | 500              | Player's ping to the server where TAB is installed. <br />**Note**: This value is measured by the server and TAB is only retrieving that value. If it's wrong, it's not a TAB issue.                                                                                                                                                   |
+| %player%                                  | -1               | Player's name                                                                                                                                                                                                                                                                                                                          |
+| %uuid%                                    | -1               | Player's UUID                                                                                                                                                                                                                                                                                                                          |
+| %time%                                    | 500              | Current real time, output is configurable in **config.yml** in `time-format` option                                                                                                                                                                                                                                                    |
+| %date%                                    | 60000            | Current date, output is configurable in **config.yml** in `date-format` option                                                                                                                                                                                                                                                         |
+| %staffonline%                             | 2000             | Amount of online players with `tab.staff` permission                                                                                                                                                                                                                                                                                   |
+| %nonstaffonline%                          | 2000             | Amount of online players without `tab.staff` permission                                                                                                                                                                                                                                                                                |
+| %memory-used%                             | 200              | Used RAM of server in MB                                                                                                                                                                                                                                                                                                               |
+| %memory-max%                              | -1               | Total RAM of server in MB                                                                                                                                                                                                                                                                                                              |
+| %memory-used-gb%                          | 200              | Used RAM of server in GB                                                                                                                                                                                                                                                                                                               |
+| %memory-max-gb%                           | -1               | Total RAM of server in GB                                                                                                                                                                                                                                                                                                              |
+| %player-version%                          | -1               | User-friendly version of player, such as `1.14.4`. For versions that share the same protocol version number, the higher one is returned (for example 1.20 & 1.20.1 -> 1.20.1 is returned)                                                                                                                                              |
+| %player-version-id%                       | -1               | Network ID of player's version. You can see the full version list in [TAB's source code](https://github.com/NEZNAMY/TAB/blob/master/shared/src/main/java/me/neznamy/tab/shared/ProtocolVersion.java). Useful for conditions to create per-version results using numeric operations since version names cannot be effectively compared. |
+| %luckperms-prefix%                        | 1000             | Prefix from LuckPerms from the server where TAB is installed                                                                                                                                                                                                                                                                           |
+| %luckperms-suffix%                        | 1000             | Suffix from LuckPerms from the server where TAB is installed                                                                                                                                                                                                                                                                           |
+| %luckperms-prefixes%                      | 1000             | All prefixes combined from LuckPerms from the server where TAB is installed                                                                                                                                                                                                                                                            |
+| %luckperms-suffixes%                      | 1000             | All suffixes combined from LuckPerms from the server where TAB is installed                                                                                                                                                                                                                                                            |
+| %displayname%                             | 500              | Display name variable set by permission plugin, typically prefix + name + suffix                                                                                                                                                                                                                                                       |
+| %group%                                   | 1000             | Returns player's primary group name. Created for internal functionality, but can be used as a display placeholder as well.                                                                                                                                                                                                             |
+| %vanished%                                | 1000             | Returns `true`/`false` based on player's vanish status. Created for internal functionality, but can be used as a display placeholder as well.                                                                                                                                                                                          |
+| %bedrock%                                 | -1               | Returns `true`/`false` based on whether player is using Bedrock edition or not (Java)                                                                                                                                                                                                                                                  |
+| %bossbar_announce_time_total_\<bossbar\>% | -1               | Total time (inputted value) of an announced bossbar.                                                                                                                                                                                                                                                                                   |
+| %bossbar_announce_time_left_\<bossbar\>%  | 100              | Remaining time of an announced bossbar.                                                                                                                                                                                                                                                                                                |
+| %online_\<server name\>%                  | 1000             | Amount of online players on specified server (excluding vanished players)                                                                                                                                                                                                                                                              |
+| %%                                        | -1               | Returns the `%` symbol. Useful to display `%` symbol without breaking all placeholders after it                                                                                                                                                                                                                                        |

 ## Backend only
-These placeholders only work when TAB is installed on a backend server (Bukkit / Sponge / Fabric), they don't work when TAB is on BungeeCord. If you have TAB installed on BungeeCord and wish to use these, use their [PlaceholderAPI](https://github.com/NEZNAMY/TAB/wiki/Quick-PlaceholderAPI-startup-guide) alternative with [Bridge plugin](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge) installed for PlaceholderAPI support on BungeeCord.
+These placeholders only work when TAB is installed on a backend server, they don't work when TAB is on a proxy. If you have TAB installed on proxy and wish to use these, use their [PlaceholderAPI](https://github.com/NEZNAMY/TAB/wiki/Quick-PlaceholderAPI-startup-guide) alternative with [Bridge plugin](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge) installed for PlaceholderAPI support on proxy.
 | Identifier | Refresh interval | Description | PlaceholderAPI alternative |
-| ------------- | ------------- | ------------- | ------------- |
+|---------------|---------------| ------------- | ------------- |
 | %health% | 100 | Player's health, rounded up to match Minecraft's heart display. | %player_health_rounded% |
 | %displayname% | 500 | Player's display name value set by permission plugin. | %player_displayname% |
-| %tps%               | 1000 | TPS of server from the last minute (measured by server, not available on Fabric as it doesn't measure the value) | %server_tps_1% |
-| %mspt%              | 1000 | Server's current milliseconds per tick (Paper / Sponge 8+ / Fabric only) | - |
+| %tps%               | 1000 | TPS of server from the last minute. Measured by the server. Not directly available on modded platforms - primitive approximation using MSPT (TPS = 1000/MSPT, max 20) is used there. | %server_tps_1% |
+| %mspt%              | 1000 | Server's current milliseconds per tick (not available on Spigot) | - |
+| %deaths%            | 1000 | Player's death count | %statistic_deaths% |

-## BungeeCord only
+## Proxy only
 | Identifier                   | Refresh interval | Description                                                                                                                                                                   |
 |------------------------------|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | %server%                     | -1               | Name of server where player is, defined in proxy's config.                                                                                                                    |
 | %serveronline%               | 1000             | Amount of online players on server where the player is (excluding vanished players)                                                                                           |
-| %online_\<server name\>%     | 1000             | Amount of online players on specified server (excluding vanished players)                                                                                                     |
 | %playerlist-group_\<group\>% | 1000             | Amount of online players in specified [global playerlist](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Global-playerlist) group (therefore the feature must be enabled) |

 # PlaceholderAPI
@@ -94,39 +101,69 @@ placeholders:
  register-tab-expansion: true
 ```
 in **config.yml**.  
-Full list of placeholders:  
-| Identifier  | Description |
-| ------------- | ------------- |
-| %tab_tabprefix% | Current tabprefix with replaced placeholders |
-| %tab_tabsuffix% | Current tabsuffix with replaced placeholders |
-| %tab_tagprefix% | Current tagprefix with replaced placeholders |
-| %tab_tagsuffix% | Current tagsuffix with replaced placeholders |
-| %tab_customtabname% | Current customtabname with replaced placeholders |
-| %tab_tabprefix_raw% | Raw tabprefix containing raw placeholders |
-| %tab_tabsuffix_raw% | Raw tabsuffix containing raw placeholders |
-| %tab_tagprefix_raw% | Raw tagprefix containing raw placeholders |
-| %tab_tagsuffix_raw% | Raw tagsuffix containing raw placeholders |
-| %tab_customtabname_raw% | Raw customtabname containing raw placeholders |
-| %tab_scoreboard_name% | Returns name of player's currently displayed scoreboard or empty string if none is displayed due to no display condition being met |
-| %tab_scoreboard_visible% | "Enabled" if visible, "Disabled" if not |
-| %tab_bossbar_visible% | "Enabled" if visible, "Disabled" if not |
-| %tab_nametag_preview% | "Enabled" if previewing armor stands using /tab nametag preview, "Disabled" if not |
-| %tab_nametag_visibility% | "Enabled" if player can see nametags, "Disabled" if disabled using /tab nametag toggle |
-| %tab_replace_\<placeholder\>% | Applies [Placeholder output replacements](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Placeholder-output-replacements) to a PlaceholderAPI placeholder (for example %tab_replace_essentials_vanished%) |
-| %tab_placeholder_\<placeholder\>% | returns value of tab's internal placeholder (such as %tab_placeholder_animation:name% for %animation:name%) |
+Full list of placeholders (general + feature specific):
+
+**General**:
+
+| Identifier                        | Description                                                                                                                                                                                                                                                                     |
+|-----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `%tab_replace_<placeholder>%`     | Applies [Placeholder output replacements](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Placeholder-output-replacements) to a PlaceholderAPI placeholder (for example `%tab_replace_essentials_vanished%`)                                                                 |
+| `%tab_placeholder_<placeholder>%` | Returns value of tab's internal placeholder (this also applies [Placeholder output replacements](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Placeholder-output-replacements) to them if configured). <br />Example: `%tab_placeholder_animation:name%` for `%animation:name%` |
+| `%rel_tab_replace_<rel_placeholder>%`     | Applies [Placeholder output replacements](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Placeholder-output-replacements) to a **relationnal** PlaceholderAPI placeholder |
+| `%rel_tab_placeholder_<rel_placeholder>%` | Returns value of tab's internal **relational** placeholder (this also applies [Placeholder output replacements](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Placeholder-output-replacements) to them if configured). It may look strange that the `rel` is twice in there, but there's no other way. The first one tells PlaceholderAPI that this is a relational placeholder, the second one is part of the TAB's identifier, which also uses it to mark the placeholder as relational. <br />Example: `%rel_tab_placeholder_rel_condition:name%` for `%rel_condition:name%` |
+
+**BossBar**:
+
+| Identifier              | Description                             |
+|-------------------------|-----------------------------------------|
+| `%tab_bossbar_visible%` | "Enabled" if visible, "Disabled" if not |
+
+**NameTags**:
+
+| Identifier                 | Description                                                                                  |
+|----------------------------|----------------------------------------------------------------------------------------------|
+| `%tab_tagprefix%`          | Player's current tagprefix with placeholders parsed.                                         |
+| `%tab_tagsuffix%`          | Player's current tagprefix with placeholders parsed.                                         |
+| `%tab_tagprefix_raw%`      | Player's current raw tagprefix with placeholder identifiers.                                 |
+| `%tab_tagsuffix_raw%`      | Player's current raw tagsuffix with placeholder identifiers.                                 |
+| `%tab_nametag_visibility%` | "Enabled" if player can see nametags, "Disabled" if disabled using `/tab nametag toggleview` |
+
+**Scoreboard**:
+
+| Identifier                 | Description                                                                                                                         |
+|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------|
+| `%tab_scoreboard_name%`    | Returns name of player's currently displayed scoreboard or empty string if none is displayed due to no display condition being met. |
+| `%tab_scoreboard_visible%` | "Enabled" if visible, "Disabled" if not (toggled with a command)                                                                    |
+
+**Tablist name formatting**:
+
+| Identifier                | Description                                                      |
+|---------------------------|------------------------------------------------------------------|
+| `%tab_tabprefix%`         | Player's current tabprefix with placeholders parsed.             |
+| `%tab_customtabname%`     | Player's current customtabname with placeholders parsed.         |
+| `%tab_tabsuffix%`         | Player's current tabprefix with placeholders parsed.             |
+| `%tab_tabprefix_raw%`     | Player's current raw tabprefix with placeholder identifiers.     |
+| `%tab_customtabname_raw%` | Player's current raw customtabname with placeholder identifiers. |
+| `%tab_tabsuffix_raw%`     | Player's current raw tabsuffix with placeholder identifiers.     |
+
+# MiniPlaceholders
+On **Velocity**, TAB integrates with [MiniPlaceholders](https://github.com/MiniPlaceholders/MiniPlaceholders) when the plugin is installed. TAB automatically detects and resolves MiniPlaceholders placeholders in config text, including global, per-player, and relational ones. Placeholders use angle brackets, with the expansion and name separated by an underscore (for example `<luckperms_prefix>`), and arguments added after a colon (for example `<luckperms_meta:key>`). See the [MiniPlaceholders placeholder list](https://miniplaceholders.github.io/docs/user-guide/Placeholders) for all available placeholders. TAB also registers its own expansion, offering placeholders such as `<tab_tabprefix>` and `<tab_placeholder:name>`. The `%placeholder%` syntax remains reserved for [PlaceholderAPI](https://github.com/PlaceholderAPI/PlaceholderAPI) (via TAB Bridge on Velocity).
+
+> [!WARNING]
+> TAB's gradient syntax (`<#RRGGBB>Text</#RRGGBB>`) is a compatibility layer that TAB rewrites before parsing, it is more fragile than native [MiniMessage](https://docs.advntr.dev/minimessage/format.html) gradients (`<gradient:#RRGGBB:#RRGGBB>Text</gradient>`). On **Velocity**, this is especially problematic because [MiniPlaceholders](https://github.com/MiniPlaceholders/MiniPlaceholders) parses MiniMessage *before* TAB can rewrite its gradient syntax. For example, placeholder output like `<#E0B11E>MyServer</#FF0000>` is interpreted by MiniPlaceholders as a hex color tag (`<#E0B11E>`), but `</#FF0000>` is not recognized as a gradient closing tag, so the formatting breaks. Prefer native MiniMessage syntax in placeholder output (e.g. `<gradient:#E0B11E:#FF0000>MyServer</gradient>`). See [How to use Minecraft components - MiniMessage](https://github.com/NEZNAMY/TAB/wiki/How-to-use-Minecraft-components#minimessage) for more information.

 # Relational placeholders
 ## About
 Unlike classic placeholders which take either 0
 (placeholders with the same output for all players) or 1 (per-player placeholders) players,
 relational placeholders take in 2 players.
-The first usage was to display relation between two players, specifically enemies / allies (red / green) for factions,
+The first ever recorded usage was to display relation between two players, specifically enemies / allies (red / green) for factions,
 allowing players to see faction names of other players colored based on relation.
 While the usage is not limited to this, the name of the 2-player placeholder type has been established as "relational"
-and will be called that everywhere.
+and will be called that everywhere. These placeholders only make sense in functions that allow 2 players to see each other - chat, nametags (+ belowname), tablist formatting (+ objective). Other places, such as scoreboard, bossbar or header/footer don't make sense and don't support these placeholders, as there is no other player to use.

 ## Usage
-TAB does not offer any internal relational placeholders. However, it has full support for PlaceholderAPI placeholders. You can also register your own relational placeholders using the [API](#relational-placeholders-1). In PlaceholderAPI, all relational placeholder identifiers must start with `%rel_`. This rule is adopted and used in TAB as well (including those registered via API).
+TAB offers [relational conditions](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders#relational-conditions) as well as full support for PlaceholderAPI placeholders. You can also register your own relational placeholders using the [API](#relational-placeholders-1). In PlaceholderAPI, all relational placeholder identifiers must start with `%rel_`. This rule is adopted and used in TAB as well (including those registered via API).

 When passing players into the function, first player is the player viewing the text, second player is the one text is being displayed on.  
 Code wise, the PlaceholderAPI request function becomes
@@ -140,7 +177,27 @@ To properly distinguish viewer/target (if needed), your relational placeholder e

 # Refreshing
 ## Refresh intervals
-TAB is refreshing placeholders in intervals. For internal placeholders it's using values I found the most optimal and set directly in the plugin. Refresh intervals for PlaceholderAPI placeholders can be [configured](https://github.com/NEZNAMY/TAB/wiki/Optimizing-the-plugin#2---placeholder-refresh-intervals).
+Internal placeholders use a value hardcoded into the plugin by default. PlaceholderAPI placeholders use `default-refresh-interval` by default.
+
+To begin, find this part in your config
+```yml
+placeholder-refresh-intervals:
+  default-refresh-interval: 500
+  "%server_uptime%": 1000
+  "%server_tps_1_colored%": 1000
+  "%player_health%": 200
+  "%player_ping%": 1000
+  "%vault_prefix%": 1000
+  "%rel_factionsuuid_relation_color%": 500
+```
+Refresh interval is in milliseconds. It must be divisible by 50.
+
+Keep in mind that CPU measurement is reset every 10 seconds.
+This means that if you configure a higher refresh interval than 10000,
+there will be intervals when placeholder didn't refresh at all,
+making it look like the CPU is perfect, while on the next refresh it may be high.
+For this reason, if you want to cleanly track usage, keep the interval at 10000 at most.
+Using a higher interval will help if needed, but may lead to misleading info in cpu output.

 ## Sync refreshing
 By default, all placeholders are refreshed asynchronously,
@@ -162,22 +219,15 @@ When using a placeholder, you should know if it's a [TAB's internal placeholder]
 > **Example:** `Sale 100% OFF! %some_placeholder%` -> `Sale 100%% OFF! %some_placeholder%`.

 ## Internal placeholder is not working
-All TAB's internal placeholders are listed above.
-Some of them are bukkit only (meaning they won't work on bungeecord) and some are bungee only.
-> [!IMPORTANT]
-> Trying to use a bukkit-only placeholder on bungeecord will not work.
-> If you want to use those,
-> [set up PlaceholderAPI support on bungeecord](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge)
-> and find their PlaceholderAPI equivalent.
-> For example, you can use %vault_prefix% instead of %vault-prefix%,
-> %player_health_rounded% instead of %health% and so on.
+Here are few possible reasons:
+* You attempted to use a proxy-only placeholder on backend, or backend-only placeholder on proxy
+* You used the `%` symbol before the placeholder, breaking placeholder starts and ends (see above).

 ## PlaceholderAPI placeholder is not working
-If you have TAB installed on bungeecord, make sure you [set up PlaceholderAPI support on bungeecord](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge) as there is no other way to retrieve data from technically a different server.
-
-> [!TIP]
-> Use `/papi parse me <placeholder>` to check if the placeholder is working.
-> If it does not work, the issue is not on TAB's end.
+Here are few possible reasons:
+* The placeholder is not working in PlaceholderAPI. You can check this using `/papi parse me <placeholder>`. If it isn't working there, it's not a TAB issue. If the placeholder you used is advertised somewhere, make sure you have the adequate expansion downloaded.
+* If you have TAB installed on a proxy, make sure [TAB-Bridge](https://github.com/NEZNAMY/TAB/wiki/TAB-Bridge) is installed on backend servers to forward support to the proxy.
+* You used the `%` symbol before the placeholder, breaking placeholder starts and ends (see above).

 # API
 *To get started with the API, see [Developer API](https://github.com/NEZNAMY/TAB/wiki/Developer-API) page.*
@@ -2,9 +2,9 @@
 This is a quick guide for [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) plugin, which is often referred to on the wiki, and we also get many assistance requests with TAB which turn out to be asking for help with PlaceholderAPI. Whether its documentation is not clear enough, missing information or users just don't read it isn't the topic here to judge, instead, a quick guide with everything needed is provided.

 # Installation
-PlaceholderAPI is a standalone bukkit plugin that can be installed just like any other plugin.
-It does not support BungeeCord.
-If you have TAB on BungeeCord and wish to use PlaceholderAPI placeholders,
+PlaceholderAPI is a standalone Bukkit plugin that can be installed just like any other plugin.
+It does not support proxies.
+If you have TAB on a proxy server and wish to use PlaceholderAPI placeholders,
 you'll need to install [Bridge](https://www.spigotmc.org/resources/83966) plugin on backend servers.
 Alongside other features, it forwards PlaceholderAPI support to the proxy.

@@ -1,33 +1,28 @@
 # About
-When TAB is installed on BungeeCord, the plugin has very limited access to information. It is unable to retrieve internal server data, as well as hook into backend plugins, because it's a different server.  
-Bridge is a backend plugin that sends this data to the proxy, allowing TAB to work better when installed on BungeeCord.  
-You can download it from [GitHub](https://github.com/NEZNAMY/TAB-Bridge/releases) or [Spigot](https://www.spigotmc.org/resources/83966).
+When TAB is installed on a proxy, the plugin has very limited access to information. It is unable to retrieve internal server data, as well as hook into backend plugins, because it's a different server.  
+Bridge is a backend plugin that sends this data to the proxy, allowing TAB to work better when installed on a proxy.  
+You can download it from [GitHub](https://github.com/NEZNAMY/TAB-Bridge/releases), [Spigot](https://www.spigotmc.org/resources/83966) or [Modrinth](https://modrinth.com/plugin/tab-bridge).

 # Installation
 Installation is as simple as it can be.
 Put it into the plugins folder of your backend servers.
-Bridge is NOT a BungeeCord plugin!
+Bridge is NOT a proxy plugin!
 Bridge itself has no config file, as everything is configured in the main plugin.

 # Features
 * Forwarding PlaceholderAPI support to the proxy
 * Allow detection if player is invisible to make their nametag invisible (compensation for 1.8.x client sided bug)
 * Allow detection if a player is disguised to disable collision to prevent endless push
-* Forwarding permission groups of players if no permission plugin is installed on BungeeCord
+* Forwarding permission groups of players if no permission plugin is installed on the proxy
 * Forwarding vanish status for compatibility with global playerlist / layout features
 * Forward player's world for %world% and per-world settings
-* Allow TAB's PlaceholderAPI expansion with TAB on BungeeCord
+* Allow TAB's PlaceholderAPI expansion with TAB on proxy
 * Forward player's gamemode for spectator fix feature to work

 # Compatibility
-Just like with Minecraft, when there is a change in the communication protocol,
+Just like with Minecraft, when there is a change in the communication protocol between TAB ↔ TAB-Bridge,
 older software will not be compatible with the new one.
 You should always be running the latest versions of both TAB and Bridge.

 # Confirming it works
-You have many ways to verify TAB and Bridge are properly connected. Besides checking if the features above work, the easiest one is to run `/btab debug <player>`.  
-If it's properly connected, you'll get a message saying this:  
-![image](https://github.com/NEZNAMY/TAB/assets/6338394/3f8dd978-a8bd-4613-9ea1-a56340194859)  
-If it's not properly connected, you'll get this message:  
-![image](https://github.com/NEZNAMY/TAB/assets/6338394/a90018bc-2c3b-4bf5-b54c-56621178ce80)  
-If this is the case, it means Bridge is either not installed or versions are not compatible. Update both to the latest version.
+You have many ways to verify TAB and Bridge are properly connected. Besides checking if the features above work, the easiest one is to run `/btab dump <player>` and check if bridge connection says connected. If not, it means Bridge is either not installed or versions are not compatible. Update both to the latest version.
@@ -1,147 +0,0 @@
-# ---------------------------------------
-# THIS PAGE IS A WORK IN PROGRESS
-# ---------------------------------------
-
-# About
-This page compares TAB to other plugins offering similar features based on various parameters.
-
-### Open issues
-Number of open issues on GitHub. Keep in mind this number shouldn't be taken 100% seriously, because:
-* People often open issues to ask for help instead of reporting an issue.
-* If nobody is using a plugin, nobody can find bugs. Bug not found doesn't mean it's not there.
-* Some issues may be feature requests, which may not be present elsewhere as those are not accepted.
-
-### Price
-The price to get the jar. Most plugins are free, some are paid.
-
-### Minecraft
-Supported Minecraft versions by the plugin.
-
-### Platforms
-Supported platforms by the plugin. Full tracked list includes:
-* Bukkit ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577)
-* Sponge ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352)
-* Fabric ![image](https://github.com/NEZNAMY/TAB/assets/6338394/ffbf8384-fff5-4a32-8fc5-0768246e91c1)
-* Forge ![image](https://github.com/NEZNAMY/TAB/assets/6338394/268c1571-0087-466b-b502-ec16017ac1d6)
-* BungeeCord ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9)
-* Velocity ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d)
-
-### Async
-Whether the plugin runs in server's main thread (sync) or in a different thread (async). If a plugin is running sync, it may slow down the server's TPS. All of these features can be done async.
-
-# Belowname
-| Attribute                         | [TAB](https://github.com/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **Open issues**                   | ![Issues](https://img.shields.io/github/issues/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| **Price**                         | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                                                                                                                                                                                                                                                                                                     |
-| **Minecraft**                     | 1.5+                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| **Platforms**                     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/ffbf8384-fff5-4a32-8fc5-0768246e91c1) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) |
-| **Async**                         | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| PlaceholderAPI support            | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| Configurable number               | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| Configurable text                 | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| 1.20.3+ NumberFormat support      | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| Conditionally disable the feature | If any specified condition is met                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-
-# Bossbar
-| Attribute         | [TAB](https://github.com/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                                            | [UltraBar](https://github.com/ryandw11/UltraBar)                                             | [AnimaBossBar](https://www.spigotmc.org/resources/bossbar-spigot-free-bossbar-plugin-1-9-1-18-1.59135/) |
-|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|
-| **Open issues**   | ![Issues](https://img.shields.io/github/issues/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                      | ![Issues](https://img.shields.io/github/issues/ryandw11/UltraBar)                            | -                                                                                                       |
-| **Price**         | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                                                                                                                                                                                                                                                                                                     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)            |
-| **Minecraft**     | 1.5+                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1.12+                                                                                        | 1.9 - 1.18.1                                                                                            |
-| **Platforms**     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/ffbf8384-fff5-4a32-8fc5-0768246e91c1) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577)            |
-| **Async**         | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ❌                                                                                            | ❌                                                                                                       |
-| Announcements     | ✔ (defined in config)                                                                                                                                                                                                                                                                                                                                                                                                                                                            | ✔ (defined at runtime)                                                                       | ✔ (defined at runtime)                                                                                  |
-| Toggle command    | ✔ (customizable)                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | ❌                                                                                            | ❌                                                                                                       |
-| Display condition | Anything that has a placeholder                                                                                                                                                                                                                                                                                                                                                                                                                                                  | On join / death / command / in worldguard region                                             | ❌                                                                                                       |
-
-# Global Playerlist
-| Attribute       | [TAB](https://github.com/NEZNAMY/TAB)                                                                                                                                                     | [BungeeTabListPlus](https://github.com/CodeCrafter47/BungeeTabListPlus)                      | [Velocitab](https://github.com/WiIIiam278/Velocitab)                                         |
-|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
-| **Open issues** | ![Issues](https://img.shields.io/github/issues/NEZNAMY/TAB)                                                                                                                               | ![Issues](https://img.shields.io/github/issues/CodeCrafter47/BungeeTabListPlus)              | ![Issues](https://img.shields.io/github/issues/WiIIiam278/Velocitab)                         |
-| **Price**       | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                              | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a) |
-| **Platforms**   | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) |
-
-# Header/Footer
-| Attribute       | [TAB](https://github.com/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                                            | [TabList](https://github.com/montlikadani/TabList)                                                                                                                                                                                                                                     |
-|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **Open issues** | ![Issues](https://img.shields.io/github/issues/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                      | ![Issues](https://img.shields.io/github/issues/montlikadani/TabList)                                                                                                                                                                                                                   |
-| **Price**       | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                                                                                                                                                                                                                                                                                                     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                                                                                                           |
-| **Platforms**   | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/ffbf8384-fff5-4a32-8fc5-0768246e91c1) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) |
-
-# Layout
-| Attribute       | [TAB](https://github.com/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                                            | [BungeeTabListPlus](https://github.com/CodeCrafter47/BungeeTabListPlus)                                                                                                                   |
-|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **Open issues** | ![Issues](https://img.shields.io/github/issues/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                      | ![Issues](https://img.shields.io/github/issues/CodeCrafter47/BungeeTabListPlus)                                                                                                           |
-| **Price**       | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                                                                                                                                                                                                                                                                                                     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                              |
-| **Platforms**   | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/ffbf8384-fff5-4a32-8fc5-0768246e91c1) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) |
-
-# Nametags
-| Attribute                         | [TAB](https://github.com/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                                            | [NametagEdit](https://github.com/sgtcaze/NametagEdit)                                        |
-|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
-| **Open issues**                   | ![Issues](https://img.shields.io/github/issues/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                      | ![Issues](https://img.shields.io/github/issues/sgtcaze/NametagEdit)                          |
-| **Price**                         | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                                                                                                                                                                                                                                                                                                     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a) |
-| **Minecraft**                     | 1.5+                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1.7+                                                                                         |
-| **Platforms**                     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/ffbf8384-fff5-4a32-8fc5-0768246e91c1) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) |
-| **Async**                         | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ❌                                                                                            |
-| Customization                     | Per-group<br />Per-player<br />Per-world<br />Per-server                                                                                                                                                                                                                                                                                                                                                                                                                         | Per-group<br />Per-player                                                                    |
-| PlaceholderAPI support            | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ✔                                                                                            |
-| Configurable collision            | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ✔                                                                                            |
-| Configurable nametag visibility   | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ❌                                                                                            |
-| Conditionally disable the feature | If any specified condition is met                                                                                                                                                                                                                                                                                                                                                                                                                                                | ❌                                                                                            |
-| Bonus                             | - Option to use armor stands to bypass<br />   all limits and support multiple lines<br />- Anti-override to avoid random plugins breaking it                                                                                                                                                                                                                                                                                                                                    | -                                                                                            |
-
-# Per world playerlist
-
-# Playerlist objective
-| Attribute                         | [TAB](https://github.com/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                                            | [TabList](https://github.com/montlikadani/TabList)                                                                                                                                        |
-|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **Open issues**                   | ![Issues](https://img.shields.io/github/issues/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                      | ![Issues](https://img.shields.io/github/issues/montlikadani/TabList)                                                                                                                      |
-| **Price**                         | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                                                                                                                                                                                                                                                                                                     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                              |
-| **Platforms**                     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/ffbf8384-fff5-4a32-8fc5-0768246e91c1) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) |
-| Display any number                | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ✔                                                                                                                                                                                         |
-| Supports hearts display type      | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ✔                                                                                                                                                                                         |
-| 1.20.3+ NumberFormat support      | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ❌                                                                                                                                                                                         |
-| Conditionally disable the feature | When any specified condition is met                                                                                                                                                                                                                                                                                                                                                                                                                                              | Disable in worlds                                                                                                                                                                         |
-
-# Scoreboard
-| Attribute                             | [TAB](https://github.com/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                                            | [RealScoreboard](https://github.com/joserodpt/RealScoreboard)                                    | [AnimatedScoreboard](https://www.spigotmc.org/resources/20848/)                                                                                                                             | [SternalBoard](https://github.com/ShieldCommunity/SternalBoard)                                                                                                                             | [KiteBoard](https://github.com/Niall7459/KiteBoard-Documentation)                                                                                                                           |
-|---------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **Open issues**                       | ![Issues](https://img.shields.io/github/issues/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                      | ![Issues](https://img.shields.io/github/issues/joserodpt/RealScoreboard)                         | -                                                                                                                                                                                           | ![Issues](https://img.shields.io/github/issues/ShieldCommunity/SternalBoard)                                                                                                                | ![Issues](https://img.shields.io/github/issues/Niall7459/KiteBoard-Documentation)                                                                                                           |
-| **Price**                             | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                                                                                                                                                                                                                                                                                                     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/1286a130-6173-4414-b5c6-43d79d75794d)                                                                                                |
-| **Minecraft**                         | 1.5+                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1.13+                                                                                            | 1.8+                                                                                                                                                                                        | 1.7+                                                                                                                                                                                        | 1.8 - 1.20.1                                                                                                                                                                                |
-| **Platforms**                         | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/ffbf8384-fff5-4a32-8fc5-0768246e91c1) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577)     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577)                                                                                                | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577)                                                                                                | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577)                                                                                                |
-| **Async**                             | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ✔                                                                                                | ✔                                                                                                                                                                                           | ✔                                                                                                                                                                                           | ✔                                                                                                                                                                                           |
-| Customizable toggle command           | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ❌                                                                                                | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           |
-| 1.20.3+ NumberFormat support          | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ❌                                                                                                | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           |
-| Max line length limit (<1.13 / 1.13+) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/b770a19b-9f1a-44c1-8164-394c788998b8) / ![image](https://github.com/NEZNAMY/TAB/assets/6338394/3c7c3e31-31e6-4bce-9453-b74b0cadd942)                                                                                                                                                                                                                                                                                      | - / ![image](https://github.com/NEZNAMY/TAB/assets/6338394/3c7c3e31-31e6-4bce-9453-b74b0cadd942) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/98d0f411-5b2c-4ab2-a167-8189d5c32a02) / ![image](https://github.com/NEZNAMY/TAB/assets/6338394/3c7c3e31-31e6-4bce-9453-b74b0cadd942) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/98d0f411-5b2c-4ab2-a167-8189d5c32a02) / ![image](https://github.com/NEZNAMY/TAB/assets/6338394/3c7c3e31-31e6-4bce-9453-b74b0cadd942) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/98d0f411-5b2c-4ab2-a167-8189d5c32a02) / ![image](https://github.com/NEZNAMY/TAB/assets/6338394/3c7c3e31-31e6-4bce-9453-b74b0cadd942) |
-
-| Attribute                             | [FeatherBoard](https://www.spigotmc.org/resources/featherboard.2691/)                                                                                                                                                                                                                    | [UltraScoreboards](https://www.spigotmc.org/resources/ultra-scoreboards.93726/)                                                                                                             | [QuickBoard](https://github.com/tadeas-drab/QuickBoard)                                                                                                                                     | [SimpleScore](https://github.com/r4g3baby/SimpleScore)                                                                                                                                      | [InfiniteScoreboard](https://www.spigotmc.org/resources/infinite-scoreboard.87425/)                                                                                                         |
-|---------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **Open issues**                       | -                                                                                                                                                                                                                                                                                        | -                                                                                                                                                                                           | ![Issues](https://img.shields.io/github/issues/tadeas-drab/QuickBoard)                                                                                                                      | ![Issues](https://img.shields.io/github/issues/r4g3baby/SimpleScore)                                                                                                                        | -                                                                                                                                                                                           |
-| **Price**                             | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/dd25c457-6b4e-4771-a366-3c5ec154f007)                                                                                                                                                                                             | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f2a536e5-4a56-4b5c-9e3d-a86d8761876e)                                                                                                | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                |
-| **Minecraft**                         | 1.7+                                                                                                                                                                                                                                                                                     | 1.8+                                                                                                                                                                                        | 1.8 - 1.16.1                                                                                                                                                                                | 1.8+                                                                                                                                                                                        | 1.8 - 1.19                                                                                                                                                                                  |
-| **Platforms**                         | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577)                                                                                                                                                                                             | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9)   | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577)                                                                                                | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577)                                                                                                | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577)                                                                                                |
-| **Async**                             | ✔                                                                                                                                                                                                                                                                                        | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           | ✔                                                                                                                                                                                           |
-| Customizable toggle command           | ❌                                                                                                                                                                                                                                                                                        | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           |
-| 1.20.3+ NumberFormat support          | ❌                                                                                                                                                                                                                                                                                        | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           | ❌                                                                                                                                                                                           |
-| Max line length limit (<1.13 / 1.13+) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/09e5314f-ac46-40ec-b8c8-3ba54a5bf8fc)-![image](https://github.com/NEZNAMY/TAB/assets/6338394/b770a19b-9f1a-44c1-8164-394c788998b8) / ![image](https://github.com/NEZNAMY/TAB/assets/6338394/3c7c3e31-31e6-4bce-9453-b74b0cadd942) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/ed5c6f89-d700-41a2-b4dd-49ebc846d8c7) / ![image](https://github.com/NEZNAMY/TAB/assets/6338394/3c7c3e31-31e6-4bce-9453-b74b0cadd942) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/98d0f411-5b2c-4ab2-a167-8189d5c32a02) / ![image](https://github.com/NEZNAMY/TAB/assets/6338394/5db3ba81-3956-4b84-950f-6132d5a10c71) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/98d0f411-5b2c-4ab2-a167-8189d5c32a02) / ![image](https://github.com/NEZNAMY/TAB/assets/6338394/5db3ba81-3956-4b84-950f-6132d5a10c71) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/09e5314f-ac46-40ec-b8c8-3ba54a5bf8fc) / ![image](https://github.com/NEZNAMY/TAB/assets/6338394/5db3ba81-3956-4b84-950f-6132d5a10c71) |
-
-# Sorting
-| Attribute       | [TAB](https://github.com/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                                            | [NametagEdit](https://github.com/sgtcaze/NametagEdit)                                        | [TabList](https://github.com/montlikadani/TabList)                                                                                                                                        | [Velocitab](https://github.com/WiIIiam278/Velocitab)                                         |
-|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
-| **Open issues** | ![Issues](https://img.shields.io/github/issues/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                      | ![Issues](https://img.shields.io/github/issues/sgtcaze/NametagEdit)                          | ![Issues](https://img.shields.io/github/issues/montlikadani/TabList)                                                                                                                      | ![Issues](https://img.shields.io/github/issues/WiIIiam278/Velocitab)                         |
-| **Price**       | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                                                                                                                                                                                                                                                                                                     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                              | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a) |
-| **Minecraft**   | 1.8+                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1.8+                                                                                         | 1.8+                                                                                                                                                                                      | 1.8+                                                                                         |
-| **Platforms**   | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/ffbf8384-fff5-4a32-8fc5-0768246e91c1) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) |
-| **Async**       | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ❌                                                                                            | ✔                                                                                                                                                                                         | ✔                                                                                            |
-| Sorting options | Groups<br />Permissions<br />Placeholder alphabetically<br />Placeholder numerically<br />Pre-defined placeholder values                                                                                                                                                                                                                                                                                                                                                         | Groups                                                                                       | Groups                                                                                                                                                                                    | Placeholder alphabetically<br />Placeholder numerically                                      |
-
-# Tablist name formatting
-| Attribute       | [TAB](https://github.com/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                                            | [TabList](https://github.com/montlikadani/TabList)                                                                                                                                                                                                                                     | [BungeeTabListPlus](https://github.com/CodeCrafter47/BungeeTabListPlus)                                                                                                                   | [SimpleTabList](https://github.com/TheYIMIR/SimpleTabList)                                   | [Velocitab](https://github.com/WiIIiam278/Velocitab)                                         |
-|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
-| **Open issues** | ![Issues](https://img.shields.io/github/issues/NEZNAMY/TAB)                                                                                                                                                                                                                                                                                                                                                                                                                      | ![Issues](https://img.shields.io/github/issues/montlikadani/TabList)                                                                                                                                                                                                                   | ![Issues](https://img.shields.io/github/issues/CodeCrafter47/BungeeTabListPlus)                                                                                                           | ![Issues](https://img.shields.io/github/issues/TheYIMIR/SimpleTabList)                       | ![Issues](https://img.shields.io/github/issues/WiIIiam278/Velocitab)                         |
-| **Price**       | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                                                                                                                                                                                                                                                                                                     | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                                                                                                                           | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a)                                                                                              | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/9bfa85bd-771c-4d78-ab15-be76665bd84a) |
-| **Minecraft**   | 1.8+                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1.8+                                                                                                                                                                                                                                                                                   | 1.8+                                                                                                                                                                                      | 1.16+                                                                                        | 1.8+                                                                                         |
-| **Platforms**   | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/ffbf8384-fff5-4a32-8fc5-0768246e91c1) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/f3cc3194-6dfc-4b15-8d46-52144a4a0352) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) ![image](https://github.com/NEZNAMY/TAB/assets/6338394/99ae3191-7b35-4883-91a9-4edbb1e88ac9) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/e39f160b-f2f4-4ccc-84ad-583092741577) | ![image](https://github.com/NEZNAMY/TAB/assets/6338394/53ad76a7-f61c-4b4f-8411-32ad5c473c4d) |
-| **Async**       | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ✔                                                                                                                                                                                                                                                                                      | ✔                                                                                                                                                                                         | ❌                                                                                            | ✔                                                                                            |
@@ -1,6 +1,6 @@
 ## Easy to install
 Support for all possible Minecraft versions containing features the plugin is able to take advantage of.
-Support for multiple platforms (Bukkit, BungeeCord, Velocity, Fabric, Sponge),
+Support for multiple platforms (Bukkit, BungeeCord, Fabric, Forge, NeoForge, Velocity),
 with everything contained in a single jar which you can download directly.
 No need to browse version history, ask what plugin version you need for your server version,
 visit random websites looking for the download button, or anything similar.
@@ -20,9 +20,6 @@ No need to install many plugins, disable features, so they don't conflict with e
 or be forced to run your server on a version that all the plugins support in common.
 All features, all server versions in a single plugin.

-## Beyond the limits
-Mojang decided to put some kind of limitation on almost every feature TAB offers. Other developers simply say "Mojang limit, nothing we can do about it, goodbye". This is not the case here. With every limitation I find, I look for ways to bypass it, and I've found most of them. These bypasses require a ton of work involved, and it's much easier to say "not possible" than actually doing it.
-
 ## Up to date
 The plugin is not abandoned.
 It is constantly getting updated to fix reported bugs,
@@ -36,10 +33,7 @@ There is a [command](https://github.com/NEZNAMY/TAB/wiki/Commands-&-Permissions#
 that shows the entire plugin's CPU usage.
 Here you can see which part of TAB is occupying the most of your CPU.
 There are [many ways to optimize TAB](https://github.com/NEZNAMY/TAB/wiki/Optimizing-the-plugin)
-to get the most out of it,
-the most common being increasing refresh rates for individual placeholders if they're inefficient.
-This is done on a per-placeholder basis,
-instead of slowing down the refresh rate of an entire feature, which may break animations.
+to get the most out of it.
 Performance is also actively monitored on large servers, and observations show that it performs very well,
 meaning it will almost certainly perform even better on smaller servers.

@@ -8,16 +8,16 @@ jobs:
    name: Build
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4 # https://github.com/actions/checkout/releases
+      - uses: actions/checkout@v6 # https://github.com/actions/checkout/releases
        with:
          fetch-depth: 0 # Shallow clones should be disabled for a better relevancy of analysis
-      - name: Set up JDK 21
-        uses: actions/setup-java@v4 # https://github.com/actions/setup-java/releases
+      - name: Set up JDK 25
+        uses: actions/setup-java@v5 # https://github.com/actions/setup-java/releases
        with:
          distribution: 'temurin'
-          java-version: 21
+          java-version: 25
      - name: Cache Gradle
-        uses: actions/cache@v4.2.0 # https://github.com/actions/cache/releases
+        uses: actions/cache@v6 # https://github.com/actions/cache/releases
        with:
          path: |
            ~/.gradle/caches
@@ -31,11 +31,15 @@ jobs:
        run: ./gradlew clean build
      - name: Rename JAR with Build Number
        run: |
-          original_jar=$(find jar/build/libs -type f -name "TAB-*.jar")
-          new_name=$(echo "$original_jar" | sed "s/TAB-\(.*\)\.jar/TAB-\1+${{ github.run_number }}.jar/")
-          mv "$original_jar" "$new_name"
+          find jar/build/libs -type f -name "TAB v*.jar" -print0 | while IFS= read -r -d '' original; do
+            dir=$(dirname "$original")
+            base=$(basename "$original")
+            new_base="${base%.jar}+${{ github.run_number }}.jar"
+            new_path="$dir/$new_base"
+            mv "$original" "$new_path"
+          done
      - name: Upload a Build Artifact
-        uses: actions/upload-artifact@v4.3.3 # https://github.com/actions/upload-artifact/releases
+        uses: actions/upload-artifact@v7 # https://github.com/actions/upload-artifact/releases
        with:
          name: Click here to download
-          path: jar/build/libs/TAB-*+${{ github.run_number }}.jar
+          path: "jar/build/libs/TAB v*+${{ github.run_number }}.jar"
@@ -6,4 +6,7 @@ is in quality of the report (typically providing correct steps to reproduce that
 * Test **experimental builds**, which can be found in [GitHub Actions](https://github.com/NEZNAMY/TAB/actions) for problems of any kind including bugs. 
 This way you will help make the actual releases more stable / help get stable releases sooner.
 * Help improve the wiki by opening a [Wiki change issue](https://github.com/NEZNAMY/TAB/issues/new?assignees=&labels=Wiki&template=wiki_change.yml), 
-where you can improve existing descriptions, add information you found missing, fix typos / grammar mistakes or add more examples.
+where you can improve existing descriptions, add information you found missing, fix typos / grammar mistakes or add more examples.
+* Create spark reports and then send them to me. I will analyze them and try to find optimizations to make the plugin run faster. Commands:
+  * `/spark profiler start --timeout 300 --thread * --interval 0.1`
+  * `/spark profiler start --timeout 300 --thread * --interval 0.1 --alloc`
@@ -6,7 +6,7 @@ More information can be found at [Why TAB?](https://github.com/NEZNAMY/TAB/wiki/
 # Download
 ### Releases
 You can download full releases from [GitHub releases](https://github.com/NEZNAMY/TAB/releases), 
-[SpigotMC](https://www.spigotmc.org/resources/57806/), [Modrinth](https://modrinth.com/plugin/tab-was-taken) or [BuiltByBit](https://builtbybit.com/resources/20631).
+[SpigotMC](https://www.spigotmc.org/resources/57806/), [Modrinth](https://modrinth.com/plugin/tab-was-taken), [BuiltByBit](https://builtbybit.com/resources/20631) or [CurseForge](https://www.curseforge.com/minecraft/mc-mods/tab).

 ### Dev builds
 Plugin's development is continuous and contains lots of small changes/fixes not worthy of being called a full
@@ -15,7 +15,7 @@ If you want to benefit from a recent change in the code before official release,
 from [GitHub actions](https://github.com/NEZNAMY/TAB/actions) (you must be logged into GitHub to be able to download it).  

 # Compiling
-Compilation requires JDK 21 and up.  
+Compilation requires JDK 25 and up.  
 To compile the plugin, run `./gradlew build` from the terminal.  
 Once the plugin compiles, grab the jar from `/jar/build/libs/` folder.  
 The universal jar contains all modules for all supported platforms.
@@ -1,5 +1,5 @@
 dependencies {
-    compileOnlyApi("org.jetbrains:annotations:24.1.0")
+    compileOnlyApi("org.jetbrains:annotations:26.1.0")
 }

 tasks.javadoc {
@@ -4,9 +4,11 @@ import java.util.UUID;

 import lombok.NonNull;
 import lombok.Setter;
+import me.neznamy.tab.api.belowname.BelowNameManager;
 import me.neznamy.tab.api.bossbar.BossBarManager;
 import me.neznamy.tab.api.event.EventBus;
 import me.neznamy.tab.api.placeholder.PlaceholderManager;
+import me.neznamy.tab.api.playerlistobjective.PlayerListObjectiveManager;
 import me.neznamy.tab.api.scoreboard.ScoreboardManager;
 import me.neznamy.tab.api.tablist.SortingManager;
 import me.neznamy.tab.api.tablist.HeaderFooterManager;
@@ -83,6 +85,22 @@ public abstract class TabAPI {
     */
    public abstract @Nullable ScoreboardManager getScoreboardManager();

+    /**
+     * Returns belowname manager instance. Unlike other features, this one is returned even if
+     * it is disabled in config, which allows enabling it for specific players using the API.
+     *
+     * @return  belowname manager
+     */
+    public abstract @Nullable BelowNameManager getBelowNameManager();
+
+    /**
+     * Returns playerlist objective manager instance. Unlike other features, this one is returned
+     * even if it is disabled in config, which allows enabling it for specific players using the API.
+     *
+     * @return  playerlist objective manager
+     */
+    public abstract @Nullable PlayerListObjectiveManager getPlayerListObjectiveManager();
+
    /**
     * Returns team manager instance if the feature is enabled. If not, returns {@code null}.
     *
@@ -77,7 +77,7 @@ public interface TabPlayer {
     * Changes expected profile name of the player. This adapts all name-bound features
     * to use this new profile name if another plugin changed profile name of the player. <p>
     * Automatic profile name change detection is available on Bukkit, BungeeCord and Fabric,
-     * therefore using this is redundant there. This function is only needed on Sponge and Velocity,
+     * therefore using this is redundant there. This function is only needed on Velocity,
     * where the detection is not available. <p>
     * Warning: This function does NOT change player's profile name, it only updates the tracked
     * name inside the plugin.
@@ -96,7 +96,6 @@ public interface TabPlayer {
    @NotNull
    String getExpectedProfileName();

-
    /**
     * Returns name of the server the player is connected to.
     * This requires TAB on proxy.
@@ -0,0 +1,118 @@
+package me.neznamy.tab.api.belowname;
+
+import lombok.NonNull;
+import me.neznamy.tab.api.TabAPI;
+import me.neznamy.tab.api.TabPlayer;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Interface for manipulating the belowname objective of individual players.
+ * <p>
+ * Instance can be obtained using {@link TabAPI#getBelowNameManager()}.
+ * Unlike other features, this one is available even if it is disabled in config,
+ * which allows enabling it for specific players using {@link #setEnabled(TabPlayer, Boolean)}.
+ */
+@SuppressWarnings("unused") // API class
+public interface BelowNameManager {
+
+    /**
+     * Forces the objective to be visible or hidden for specified player, overriding
+     * both the config option and the disable condition. This only affects what the
+     * player sees, not how the player is displayed to others. Use {@code null} to
+     * give the control back to configuration.
+     *
+     * @param   player
+     *          Player to set visibility for
+     * @param   enabled
+     *          Forced visibility or {@code null} to reset back to configuration
+     * @see     #getCustomEnabled(TabPlayer)
+     */
+    void setEnabled(@NonNull TabPlayer player, @Nullable Boolean enabled);
+
+    /**
+     * Returns forced visibility assigned using {@link #setEnabled(TabPlayer, Boolean)}.
+     * If no visibility is forced, returns {@code null}.
+     *
+     * @param   player
+     *          Player to get forced visibility of
+     * @return  Forced visibility or {@code null} if not forced
+     * @see     #setEnabled(TabPlayer, Boolean)
+     */
+    @Nullable Boolean getCustomEnabled(@NonNull TabPlayer player);
+
+    /**
+     * Changes score value of specified player to provided value. Supports placeholders,
+     * however, the value must evaluate to a number. Only 1.20.2 and lower clients display
+     * this value, newer clients display the number format instead. Use {@code null} to
+     * reset value back to the configured one.
+     *
+     * @param   player
+     *          Player to change score value of
+     * @param   value
+     *          New score value or {@code null} to reset back to configuration
+     * @see     #getCustomValue(TabPlayer)
+     * @see     #setFancyValue(TabPlayer, String)
+     */
+    void setValue(@NonNull TabPlayer player, @Nullable String value);
+
+    /**
+     * Returns score value assigned using {@link #setValue(TabPlayer, String)}.
+     * If no value is assigned, returns {@code null}.
+     *
+     * @param   player
+     *          Player to get custom score value of
+     * @return  Custom score value assigned using the API
+     * @see     #setValue(TabPlayer, String)
+     */
+    @Nullable String getCustomValue(@NonNull TabPlayer player);
+
+    /**
+     * Changes number format of specified player to provided value. Supports placeholders,
+     * as well as any supported RGB formats. Only 1.20.3+ clients display the number format,
+     * older clients display the score value instead. If it evaluates to an empty string, the
+     * score is not displayed at all. Use {@code null} to reset value back to the configured one.
+     *
+     * @param   player
+     *          Player to change number format of
+     * @param   fancyValue
+     *          New number format or {@code null} to reset back to configuration
+     * @see     #getCustomFancyValue(TabPlayer)
+     * @see     #setValue(TabPlayer, String)
+     */
+    void setFancyValue(@NonNull TabPlayer player, @Nullable String fancyValue);
+
+    /**
+     * Returns number format assigned using {@link #setFancyValue(TabPlayer, String)}.
+     * If no number format is assigned, returns {@code null}.
+     *
+     * @param   player
+     *          Player to get custom number format of
+     * @return  Custom number format assigned using the API
+     * @see     #setFancyValue(TabPlayer, String)
+     */
+    @Nullable String getCustomFancyValue(@NonNull TabPlayer player);
+
+    /**
+     * Changes objective title of specified player to provided value. Supports placeholders,
+     * as well as any supported RGB formats. Use {@code null} to reset value back to the
+     * configured one.
+     *
+     * @param   player
+     *          Player to change objective title of
+     * @param   title
+     *          New objective title or {@code null} to reset back to configuration
+     * @see     #getCustomTitle(TabPlayer)
+     */
+    void setTitle(@NonNull TabPlayer player, @Nullable String title);
+
+    /**
+     * Returns objective title assigned using {@link #setTitle(TabPlayer, String)}.
+     * If no title is assigned, returns {@code null}.
+     *
+     * @param   player
+     *          Player to get custom objective title of
+     * @return  Custom objective title assigned using the API
+     * @see     #setTitle(TabPlayer, String)
+     */
+    @Nullable String getCustomTitle(@NonNull TabPlayer player);
+}
@@ -1,14 +1,14 @@
 package me.neznamy.tab.api.bossbar;

-import java.util.List;
-import java.util.Map;
-
 import lombok.NonNull;
 import me.neznamy.tab.api.TabAPI;
 import me.neznamy.tab.api.TabPlayer;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

+import java.util.List;
+import java.util.Map;
+
 /**
 * An interface allowing work with BossBars such as creating, sending
 * and toggling.
@@ -78,6 +78,28 @@ public interface BossBarManager {
     */
    @NotNull Map<String, BossBar> getRegisteredBossBars();

+    /**
+     * Removes BossBar with specified name from the manager, making it no longer available.
+     * If BossBar was displayed to any players, it is removed.
+     *
+     * @param   name
+     *          Name of registered BossBar to remove
+     * @throws  IllegalArgumentException
+     *          if no BossBar with specified name exists
+     */
+    void removeBossBar(@NonNull String name);
+
+    /**
+     * Removes BossBar from the manager, making it no longer available.
+     * If BossBar was displayed to any players, it is removed.
+     *
+     * @param   bossBar
+     *          BossBar to remove
+     * @throws  IllegalArgumentException
+     *          if specified BossBar is not registered
+     */
+    void removeBossBar(@NonNull BossBar bossBar);
+
    /**
     * Toggles BossBar for this player and sends toggle message if {@code sendToggleMessage} is true.
     * 
@@ -1,48 +0,0 @@
-package me.neznamy.tab.api.event.plugin;
-
-import lombok.NonNull;
-import me.neznamy.tab.api.TabPlayer;
-import me.neznamy.tab.api.event.TabEvent;
-import org.jetbrains.annotations.NotNull;
-
-import java.util.function.BiFunction;
-import java.util.function.Function;
-import java.util.function.Supplier;
-
-/**
- * Called when an unknown placeholder is about to be registered.
- * It defaults to a PlaceholderAPI implementation, but can be overridden.
- */
-public interface PlaceholderRegisterEvent extends TabEvent {
-
-    /**
-     * Returns placeholder identifier starting and ending with {@code %}
-     *
-     * @return  placeholder identifier starting and ending with {@code %}
-     */
-    @NotNull String getIdentifier();
-
-    /**
-     * Sets placeholder to specified server placeholder implementation.
-     *
-     * @param   supplier
-     *          Placeholder replacer
-     */
-    void setServerPlaceholder(@NonNull Supplier<String> supplier);
-
-    /**
-     * Sets placeholder to specified player placeholder implementation.
-     *
-     * @param   function
-     *          Placeholder replacer
-     */
-    void setPlayerPlaceholder(@NonNull Function<TabPlayer, String> function);
-
-    /**
-     * Sets placeholder to specified relational placeholder implementation.
-     *
-     * @param   function
-     *          Placeholder replacer
-     */
-    void setRelationalPlaceholder(@NonNull BiFunction<TabPlayer, TabPlayer, String> function);
-}
@@ -134,7 +134,7 @@ public interface NameTagManager {
     * @param   prefix
     *          new prefix value
     * @see     #getCustomPrefix(TabPlayer)
-     * @see     #getOriginalPrefix(TabPlayer)
+     * @see     #getOriginalRawPrefix(TabPlayer)
     */
    void setPrefix(@NonNull TabPlayer player, @Nullable String prefix);

@@ -148,7 +148,7 @@ public interface NameTagManager {
     * @param   suffix
     *          new suffix value
     * @see     #getCustomSuffix(TabPlayer)
-     * @see     #getOriginalSuffix(TabPlayer)
+     * @see     #getOriginalRawSuffix(TabPlayer)
     */
    void setSuffix(@NonNull TabPlayer player, @Nullable String suffix);

@@ -160,7 +160,7 @@ public interface NameTagManager {
     *          Player to get custom prefix of
     * @return  Custom prefix assigned using the API.
     * @see     #setPrefix(TabPlayer, String)
-     * @see     #getOriginalPrefix(TabPlayer)
+     * @see     #getOriginalRawPrefix(TabPlayer)
     */
    @Nullable
    String getCustomPrefix(@NonNull TabPlayer player);
@@ -173,7 +173,7 @@ public interface NameTagManager {
     *          Player to get custom suffix of
     * @return  Custom suffix assigned using the API.
     * @see     #setSuffix(TabPlayer, String)
-     * @see     #getOriginalSuffix(TabPlayer)
+     * @see     #getOriginalRawSuffix(TabPlayer)
     */
    @Nullable
    String getCustomSuffix(@NonNull TabPlayer player);
@@ -186,7 +186,7 @@ public interface NameTagManager {
     * @see     #getCustomPrefix(TabPlayer)
     */
    @NotNull
-    String getOriginalPrefix(@NonNull TabPlayer player);
+    String getOriginalRawPrefix(@NonNull TabPlayer player);

    /**
     * Returns original suffix assigned by the plugin using internal logic.
@@ -196,20 +196,86 @@ public interface NameTagManager {
     * @see     #getCustomSuffix(TabPlayer)
     */
    @NotNull
+    String getOriginalRawSuffix(@NonNull TabPlayer player);
+
+    /**
+     * Returns original prefix assigned by the plugin using internal logic with all placeholders replaced.
+     * @param   player
+     *          Player to get replaced original prefix of
+     * @return  Original prefix assigned by the plugin's internal logic.
+     * @see     #getCustomPrefix(TabPlayer)
+     */
+    @NotNull
+    String getOriginalReplacedPrefix(@NonNull TabPlayer player);
+
+    /**
+     * Returns original suffix assigned by the plugin using internal logic with all placeholders replaced.
+     * @param   player
+     *          Player to get replaced original suffix of
+     * @return  Original suffix assigned by the plugin's internal logic.
+     * @see     #getCustomSuffix(TabPlayer)
+     */
+    @NotNull
+    String getOriginalReplacedSuffix(@NonNull TabPlayer player);
+
+    /**
+     * Returns original suffix assigned by the plugin using internal logic.
+     * @param   player
+     *          Player to get replaced original prefix of
+     * @return  Original prefix assigned by the plugin's internal logic.
+     * @see     #getCustomPrefix(TabPlayer)
+     * @deprecated  Use {@link #getOriginalRawPrefix(TabPlayer)} instead.
+     */
+    @Deprecated
+    @NotNull
+    String getOriginalPrefix(@NonNull TabPlayer player);
+
+    /**
+     * Returns original suffix assigned by the plugin using internal logic.
+     * @param   player
+     *          Player to get replaced original suffix of
+     * @return  Original suffix assigned by the plugin's internal logic.
+     * @see     #getCustomSuffix(TabPlayer)
+     * @deprecated  Use {@link #getOriginalRawSuffix(TabPlayer)} instead.
+     */
+    @Deprecated
+    @NotNull
    String getOriginalSuffix(@NonNull TabPlayer player);

    /**
     * Toggles name tag visibility view on all players for specified player.
     * On first call, name tags of all players will become invisible for specified
-     * player. On second call, they will become visible again.
+     * player. On the second call, they will become visible again.
     *
     * @param   player
     *          player to toggle name tag visibility view for
     * @param   sendToggleMessage
-     *          {@code true} if configured toggle message should be sent, {@code false} if not
+     *          {@code true} if the configured toggle message should be sent, {@code false} if not
     */
    void toggleNameTagVisibilityView(@NonNull TabPlayer player, boolean sendToggleMessage);

+    /**
+     * Shows back name tag visibility view on all players for specified player.
+     * If the view is not hidden, nothing happens.
+     *
+     * @param   player
+     *          player to show name tag visibility view for
+     * @param   sendToggleMessage
+     *          {@code true} if the configured toggle message should be sent, {@code false} if not
+     */
+    void showNameTagVisibilityView(@NonNull TabPlayer player, boolean sendToggleMessage);
+
+    /**
+     * Hides name tag visibility view on all players for specified player.
+     * If the view is already hidden, nothing happens.
+     *
+     * @param   player
+     *          player to show name tag visibility view for
+     * @param   sendToggleMessage
+     *          {@code true} if the configured toggle message should be sent, {@code false} if not
+     */
+    void hideNameTagVisibilityView(@NonNull TabPlayer player, boolean sendToggleMessage);
+
    /**
     * Returns {@code true} if player has hidden name tags by either calling
     * {@link #toggleNameTagVisibilityView(TabPlayer, boolean)} or using a command,
@@ -8,6 +8,8 @@ import org.jetbrains.annotations.NotNull;
 import java.util.function.BiFunction;
 import java.util.function.Function;
 import java.util.function.Supplier;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;

 /**
 * An interface allowing placeholder registration. Instance can be
@@ -65,6 +67,14 @@ public interface PlaceholderManager {
     */
    @NotNull RelationalPlaceholder registerRelationalPlaceholder(@NonNull String identifier, int refresh, @NonNull BiFunction<TabPlayer, TabPlayer, String> function);

+    void registerServerPlaceholder(@NonNull Pattern identifier, int refresh, @NonNull Function<Matcher, Supplier<String>> function);
+
+    void registerPlayerPlaceholder(@NonNull Pattern identifier, int refresh,
+                                   @NonNull Function<Matcher, Function<me.neznamy.tab.api.TabPlayer, String>> function);
+
+    void registerRelationalPlaceholder(@NonNull Pattern identifier, int refresh,
+                                       @NonNull Function<Matcher, BiFunction<me.neznamy.tab.api.TabPlayer, me.neznamy.tab.api.TabPlayer, String>> function);
+
    /**
     * Returns placeholder from specified identifier. If it does not exist, it is registered
     * as a PlaceholderAPI placeholder and returned.
@@ -0,0 +1,153 @@
+package me.neznamy.tab.api.playerlistobjective;
+
+import lombok.NonNull;
+import me.neznamy.tab.api.TabAPI;
+import me.neznamy.tab.api.TabPlayer;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Interface for manipulating the playerlist objective of individual players.
+ * <p>
+ * Instance can be obtained using {@link TabAPI#getPlayerListObjectiveManager()}.
+ * Unlike other features, this one is available even if it is disabled in config,
+ * which allows enabling it for specific players using {@link #setEnabled(TabPlayer, Boolean)}.
+ */
+@SuppressWarnings("unused") // API class
+public interface PlayerListObjectiveManager {
+
+    /**
+     * Forces the objective to be visible or hidden for specified player, overriding
+     * both the config option and the disable condition. This only affects what the
+     * player sees, not how the player is displayed to others. Use {@code null} to
+     * give the control back to configuration.
+     *
+     * @param   player
+     *          Player to set visibility for
+     * @param   enabled
+     *          Forced visibility or {@code null} to reset back to configuration
+     * @see     #getCustomEnabled(TabPlayer)
+     */
+    void setEnabled(@NonNull TabPlayer player, @Nullable Boolean enabled);
+
+    /**
+     * Returns forced visibility assigned using {@link #setEnabled(TabPlayer, Boolean)}.
+     * If no visibility is forced, returns {@code null}.
+     *
+     * @param   player
+     *          Player to get forced visibility of
+     * @return  Forced visibility or {@code null} if not forced
+     * @see     #setEnabled(TabPlayer, Boolean)
+     */
+    @Nullable Boolean getCustomEnabled(@NonNull TabPlayer player);
+
+    /**
+     * Changes score value of specified player to provided value. Supports placeholders,
+     * however, the value must evaluate to a number. Only 1.20.2 and lower clients display
+     * this value, newer clients display the number format instead. Use {@code null} to
+     * reset value back to the configured one.
+     *
+     * @param   player
+     *          Player to change score value of
+     * @param   value
+     *          New score value or {@code null} to reset back to configuration
+     * @see     #getCustomValue(TabPlayer)
+     * @see     #setFancyValue(TabPlayer, String)
+     */
+    void setValue(@NonNull TabPlayer player, @Nullable String value);
+
+    /**
+     * Returns score value assigned using {@link #setValue(TabPlayer, String)}.
+     * If no value is assigned, returns {@code null}.
+     *
+     * @param   player
+     *          Player to get custom score value of
+     * @return  Custom score value assigned using the API
+     * @see     #setValue(TabPlayer, String)
+     */
+    @Nullable String getCustomValue(@NonNull TabPlayer player);
+
+    /**
+     * Changes number format of specified player to provided value. Supports placeholders,
+     * as well as any supported RGB formats. Only 1.20.3+ clients display the number format,
+     * older clients display the score value instead. Use {@code null} to reset value back
+     * to the configured one.
+     *
+     * @param   player
+     *          Player to change number format of
+     * @param   fancyValue
+     *          New number format or {@code null} to reset back to configuration
+     * @see     #getCustomFancyValue(TabPlayer)
+     * @see     #setValue(TabPlayer, String)
+     */
+    void setFancyValue(@NonNull TabPlayer player, @Nullable String fancyValue);
+
+    /**
+     * Returns number format assigned using {@link #setFancyValue(TabPlayer, String)}.
+     * If no number format is assigned, returns {@code null}.
+     *
+     * @param   player
+     *          Player to get custom number format of
+     * @return  Custom number format assigned using the API
+     * @see     #setFancyValue(TabPlayer, String)
+     */
+    @Nullable String getCustomFancyValue(@NonNull TabPlayer player);
+
+    /**
+     * Changes objective title of specified player to provided value. Supports placeholders,
+     * as well as any supported RGB formats. The title is only visible on Bedrock Edition.
+     * Use {@code null} to reset value back to the configured one.
+     *
+     * @param   player
+     *          Player to change objective title of
+     * @param   title
+     *          New objective title or {@code null} to reset back to configuration
+     * @see     #getCustomTitle(TabPlayer)
+     */
+    void setTitle(@NonNull TabPlayer player, @Nullable String title);
+
+    /**
+     * Returns objective title assigned using {@link #setTitle(TabPlayer, String)}.
+     * If no title is assigned, returns {@code null}.
+     *
+     * @param   player
+     *          Player to get custom objective title of
+     * @return  Custom objective title assigned using the API
+     * @see     #setTitle(TabPlayer, String)
+     */
+    @Nullable String getCustomTitle(@NonNull TabPlayer player);
+
+    /**
+     * Changes render type of the objective for specified player. Use {@code null} to reset
+     * value back to the configured one.
+     *
+     * @param   player
+     *          Player to change render type of
+     * @param   renderType
+     *          New render type or {@code null} to reset back to configuration
+     * @see     #getCustomRenderType(TabPlayer)
+     */
+    void setRenderType(@NonNull TabPlayer player, @Nullable RenderType renderType);
+
+    /**
+     * Returns render type assigned using {@link #setRenderType(TabPlayer, RenderType)}.
+     * If no render type is assigned, returns {@code null}.
+     *
+     * @param   player
+     *          Player to get custom render type of
+     * @return  Custom render type assigned using the API
+     * @see     #setRenderType(TabPlayer, RenderType)
+     */
+    @Nullable RenderType getCustomRenderType(@NonNull TabPlayer player);
+
+    /**
+     * Render type of the objective, defining how the score is displayed.
+     */
+    enum RenderType {
+
+        /** Score is displayed as a number */
+        INTEGER,
+
+        /** Score is displayed as hearts */
+        HEARTS
+    }
+}
@@ -17,7 +17,7 @@ public interface Scoreboard {
    /**
     * Returns internal name of this scoreboard. Name is defined in registration,
     * scoreboards from config use name they were defined with. This value is
-     * used internally and in /tab announce scoreboard command.
+     * used internally and in /tab scoreboard announce command.
     * 
     * @return  custom name of this scoreboard
     */
@@ -84,8 +84,24 @@ public interface Scoreboard {
     */
    void removeLine(int index);

+    /**
+     * Replaces all current lines with the provided list.
+     * Supports placeholders, which will automatically be refreshed.
+     * Client can only see up to 15 lines at a time.
+     * If the new list is identical to the current one, nothing happens.
+     *
+     * @param   lines
+     *          New list of lines to display
+     * @throws  NullPointerException
+     *          if {@code lines} is {@code null}
+     * @see     #getLines()
+     * @see     #addLine(String)
+     * @see     #removeLine(int)
+     */
+    void setLines(@NonNull List<String> lines);
+
    /**
     * Unregisters this scoreboard from all players who can see it.
     */
    void unregister();
-}
+}
@@ -1,13 +1,13 @@
 package me.neznamy.tab.api.scoreboard;

-import java.util.List;
-import java.util.Map;
-
 import lombok.NonNull;
 import me.neznamy.tab.api.TabPlayer;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

+import java.util.List;
+import java.util.Map;
+
 /**
 * Interface allowing work with scoreboards, such as creating,
 * sending, toggling and modifying.
@@ -54,6 +54,29 @@ public interface ScoreboardManager {
     * @return  map of registered scoreboards
     */
    @NotNull Map<String, Scoreboard> getRegisteredScoreboards();
+
+    /**
+     * Removes scoreboard with specified name from list of scoreboards. If it was displayed to anyone,
+     * it will be removed from their display as well. Then, those players will receive a new scoreboard based
+     * on configuration.
+     *
+     * @param   name    Name of scoreboard to remove
+     * @throws  IllegalArgumentException
+     *          if scoreboard with such name does not exist
+     */
+    void removeScoreboard(@NonNull String name);
+
+    /**
+     * Removes scoreboard from list of scoreboards. If it was displayed to anyone,
+     * it will be removed from their display as well. Then, those players will receive a new scoreboard based
+     * on configuration.
+     *
+     * @param   scoreboard
+     *          Scoreboard to remove
+     * @throws  IllegalArgumentException
+     *          if specified scoreboard is not registered
+     */
+    void removeScoreboard(@NonNull Scoreboard scoreboard);
    
    /**
     * Displays scoreboard to defined player. This will disable all display
@@ -27,7 +27,7 @@ public interface TabListFormatManager {
     * @param   prefix
     *          new prefix value
     * @see     #getCustomPrefix(TabPlayer)
-     * @see     #getOriginalPrefix(TabPlayer)
+     * @see     #getOriginalRawPrefix(TabPlayer)
     */
    void setPrefix(@NonNull TabPlayer player, @Nullable String prefix);

@@ -41,7 +41,7 @@ public interface TabListFormatManager {
     * @param   customName
     *          new customName value
     * @see     #getCustomName(TabPlayer)
-     * @see     #getOriginalName(TabPlayer)
+     * @see     #getOriginalRawName(TabPlayer)
     */
    void setName(@NonNull TabPlayer player, @Nullable String customName);

@@ -55,7 +55,7 @@ public interface TabListFormatManager {
     * @param   suffix
     *          new suffix value
     * @see     #getCustomSuffix(TabPlayer)
-     * @see     #getOriginalSuffix(TabPlayer)
+     * @see     #getOriginalRawSuffix(TabPlayer)
     */
    void setSuffix(@NonNull TabPlayer player, @Nullable String suffix);

@@ -67,7 +67,7 @@ public interface TabListFormatManager {
     *          player to get custom prefix of
     * @return  player's custom prefix or {@code null} if not defined
     * @see     #setPrefix(TabPlayer, String)
-     * @see     #getOriginalPrefix(TabPlayer)
+     * @see     #getOriginalRawPrefix(TabPlayer)
     */
    @Nullable String getCustomPrefix(@NonNull TabPlayer player);

@@ -104,8 +104,11 @@ public interface TabListFormatManager {
     * @return  player's original prefix
     * @see     #setPrefix(TabPlayer, String)
     * @see     #getCustomPrefix(TabPlayer)
+     * @deprecated  Use {@link #getOriginalRawPrefix(TabPlayer)} instead.
     */
-    @NotNull String getOriginalPrefix(@NonNull TabPlayer player);
+    @NotNull
+    @Deprecated
+    String getOriginalPrefix(@NonNull TabPlayer player);

    /**
     * Returns player's original name applied using plugin's internal logic.
@@ -116,8 +119,11 @@ public interface TabListFormatManager {
     * @return  player's original name
     * @see     #setName(TabPlayer, String)
     * @see     #getCustomName(TabPlayer)
+     * @deprecated  Use {@link #getOriginalRawName(TabPlayer)} instead.
     */
-    @NotNull String getOriginalName(@NonNull TabPlayer player);
+    @NotNull
+    @Deprecated
+    String getOriginalName(@NonNull TabPlayer player);

    /**
     * Returns player's original suffix applied using plugin's internal logic.
@@ -128,6 +134,69 @@ public interface TabListFormatManager {
     * @return  player's original suffix
     * @see     #setSuffix(TabPlayer, String)
     * @see     #getCustomSuffix(TabPlayer)
+     * @deprecated  Use {@link #getOriginalRawSuffix(TabPlayer)} instead.
     */
-    @NotNull String getOriginalSuffix(@NonNull TabPlayer player);
+    @NotNull
+    @Deprecated
+    String getOriginalSuffix(@NonNull TabPlayer player);
+
+    /**
+     * Returns original prefix assigned by the plugin using internal logic.
+     * @param   player
+     *          Player to get original prefix of
+     * @return  Original prefix assigned by the plugin's internal logic.
+     * @see     #getCustomPrefix(TabPlayer)
+     */
+    @NotNull
+    String getOriginalRawPrefix(@NonNull TabPlayer player);
+
+    /**
+     * Returns original name assigned by the plugin using internal logic.
+     * @param   player
+     *          Player to get original name of
+     * @return  Original name assigned by the plugin's internal logic.
+     * @see     #getCustomName(TabPlayer)
+     */
+    @NotNull
+    String getOriginalRawName(@NonNull TabPlayer player);
+
+    /**
+     * Returns original suffix assigned by the plugin using internal logic.
+     * @param   player
+     *          Player to get original suffix of
+     * @return  Original suffix assigned by the plugin's internal logic.
+     * @see     #getCustomSuffix(TabPlayer)
+     */
+    @NotNull
+    String getOriginalRawSuffix(@NonNull TabPlayer player);
+
+    /**
+     * Returns original prefix assigned by the plugin using internal logic with all placeholders replaced.
+     * @param   player
+     *          Player to get replaced original prefix of
+     * @return  Original prefix assigned by the plugin's internal logic.
+     * @see     #getCustomPrefix(TabPlayer)
+     */
+    @NotNull
+    String getOriginalReplacedPrefix(@NonNull TabPlayer player);
+
+    /**
+     * Returns original name assigned by the plugin using internal logic with all placeholders replaced.
+     * @param   player
+     *          Player to get replaced original name of
+     * @return  Original name assigned by the plugin's internal logic.
+     * @see     #getCustomName(TabPlayer)
+     */
+    @NotNull
+    String getOriginalReplacedName(@NonNull TabPlayer player);
+
+    /**
+     * Returns original suffix assigned by the plugin using internal logic with all placeholders replaced.
+     * @param   player
+     *          Player to get replaced original suffix of
+     * @return  Original suffix assigned by the plugin's internal logic.
+     * @see     #getCustomSuffix(TabPlayer)
+     */
+    @NotNull
+    String getOriginalReplacedSuffix(@NonNull TabPlayer player);
 }
@@ -65,6 +65,20 @@ public interface Layout {
     */
    void addFixedSlot(int slot, @NonNull String text, @NonNull String skin, int ping);

+    /**
+     * Adds fixed slot with specified parameters
+     *
+     * @param   slot
+     *          Slot (1-80)
+     * @param   text
+     *          Text to display
+     * @param   skin
+     *          Skin definition like in config
+     * @param   ping
+     *          Slot's ping, accepts placeholders that evaluate to a number
+     */
+    void addFixedSlot(int slot, @NonNull String text, @NonNull String skin, @NonNull String ping);
+
    /**
     * Adds a player group.
     *
@@ -24,6 +24,18 @@ public interface LayoutManager {
    @NotNull
    Layout createNewLayout(@NonNull String name);

+    /**
+     * Creates new layout with given name and slot count (1.19.3+ only).
+     *
+     * @param   name
+     *          Unique layout name
+     * @param   slotCount
+     *          Amount of slots to use for 1.19.3+ players
+     * @return  Created layout
+     */
+    @NotNull
+    Layout createNewLayout(@NonNull String name, int slotCount);
+
    /**
     * Returns defined layout from config by name. If no such layout is defined in config,
     * {@code null} is returned.
@@ -36,14 +48,12 @@ public interface LayoutManager {
    Layout getLayout(@NonNull String name);

    /**
-     * Sends layout to player. Set to {@code null} to make player not see
-     * any layout, but default TabList instead.
+     * Sends layout to player. Set to {@code null} to reset layout back to original one based on configuration.
     *
     * @param   player
     *          Player to send layout to
     * @param   layout
     *          Layout to send
-     * @see     #resetLayout(TabPlayer)
     */
    void sendLayout(@NonNull TabPlayer player, @Nullable Layout layout);

@@ -53,6 +63,8 @@ public interface LayoutManager {
     * @param   player
     *          Player to reset layout for
     * @see     #sendLayout(TabPlayer, Layout)
+     * @deprecated Use {@link #sendLayout(TabPlayer, Layout)} with {@code null} instead
     */
+    @Deprecated
    void resetLayout(@NonNull TabPlayer player);
 }
				`@@ -0,0 +1 @@`
				<svg xmlns="http://www.w3.org/2000/svg" width="126" height="20" role="img" aria-label="Documentation: Wiki"><title>Documentation: Wiki</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="126" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="93" height="20" fill="#555"/><rect x="93" width="33" height="20" fill="#d8b800"/><rect width="126" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="475" y="150" fill-opacity=".8" filter="url(#blur)" textLength="830">Documentation</text><text x="475" y="150" fill-opacity=".3" textLength="830">Documentation</text></g><text x="475" y="140" textLength="830">Documentation</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="1085" y="150" fill-opacity=".8" filter="url(#blur)" textLength="230">Wiki</text><text x="1085" y="150" fill-opacity=".3" textLength="230">Wiki</text></g><text x="1085" y="140" textLength="230">Wiki</text></g></g></svg>