[Forge/NeoForge] Workaround to fix tablist tracking not working properly caused by events being fired too late (#1623)

perf: replace String.format with StringBuilder for faster placeholder…

.github/description/README.md

@@ -1,6 +1,6 @@
 # About
 This folder contains the plugin's description as advertised on various marketplaces where each one uses a different syntax.
-(bbcode, markdown).  
+(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.  

.github/description/images/Badge_Minecraft.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="156" height="20" role="img" aria-label="Minecraft: 1.7.x - 1.21.10"><title>Minecraft: 1.7.x - 1.21.10</title><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="156" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="95" height="20" fill="#007ec6"/><rect width="156" 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"><text aria-hidden="true" x="315" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="510">Minecraft</text><text x="315" y="140" transform="scale(.1)" fill="#fff" textLength="510">Minecraft</text><text aria-hidden="true" x="1075" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="850">1.7.x - 1.21.10</text><text x="1075" y="140" transform="scale(.1)" fill="#fff" textLength="850">1.7.x - 1.21.10</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="156" height="20" role="img" aria-label="Minecraft: 1.7.x - 1.21.11"><title>Minecraft: 1.7.x - 1.21.11</title><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="156" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="95" height="20" fill="#007ec6"/><rect width="156" 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"><text aria-hidden="true" x="315" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="510">Minecraft</text><text x="315" y="140" transform="scale(.1)" fill="#fff" textLength="510">Minecraft</text><text aria-hidden="true" x="1075" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="850">1.7.x - 1.21.11</text><text x="1075" y="140" transform="scale(.1)" fill="#fff" textLength="850">1.7.x - 1.21.11</text></g></svg>

.github/description/images/Badge_Release.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="92" height="20" role="img" aria-label="Release: 5.3.2"><title>Release: 5.3.2</title><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" fill="#fff"/></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"><text aria-hidden="true" x="275" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="430">Release</text><text x="275" y="140" transform="scale(.1)" fill="#fff" textLength="430">Release</text><text aria-hidden="true" x="715" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="290">5.3.2</text><text x="715" y="140" transform="scale(.1)" fill="#fff" textLength="290">5.3.2</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="92" height="20" role="img" aria-label="Release: 5.4.0"><title>Release: 5.4.0</title><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" fill="#fff"/></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"><text aria-hidden="true" x="275" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="430">Release</text><text x="275" y="140" transform="scale(.1)" fill="#fff" textLength="430">Release</text><text aria-hidden="true" x="715" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="290">5.4.0</text><text x="715" y="140" transform="scale(.1)" fill="#fff" textLength="290">5.4.0</text></g></svg>

.github/description/images/ImageGenerator.py

@@ -274,10 +274,10 @@ if __name__ == "__main__":
                  ]
     )
 
-    release = "5.3.2"
+    release = "5.4.0"
     download_image(f"https://img.shields.io/badge/Release-{release}-blue.svg", "Badge_Release.svg")
 
-    minecraft = "1.7.x - 1.21.10".replace(" ", "%20").replace("-", "--")
+    minecraft = "1.7.x - 1.21.11".replace(" ", "%20").replace("-", "--")
     download_image(f"https://img.shields.io/badge/Minecraft-{minecraft}-blue.svg", "Badge_Minecraft.svg")
 
     java = "8+"

.github/wiki/additional_information.md

@@ -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.  

.github/wiki/animations.md

@@ -56,5 +56,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.

.github/wiki/client_sided_mechanics.md

@@ -5,7 +5,7 @@
 * [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
 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.  

.github/wiki/commands_permissions.md

@@ -10,30 +10,30 @@ Commands have required permissions associated with them.
 
 # Content
 * [Configuration](#configuration-commands)
-    * [/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 group \<group\>](#tab-group-group)
-    * [/tab groups](#tab-groups)
+  * [/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 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 announce \<name\> \<length\>](#tab-bossbar-announce-name-duration)
+  * [/tab bossbar send \<name\> \[player\]](#tab-bossbar-show-name-player)
+  * [/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 announce \<name\> \<length\>](#tab-scoreboard-announce-name-duration)
+  * [/tab scoreboard show \<name\> \[player\]](#tab-scoreboard-show-name-player)
+  * [/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 <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)
+  * [/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)
-    * [/tab mysql download](#tab-mysql-download)
+  * [/tab mysql upload](#tab-mysql-upload)
+  * [/tab mysql download](#tab-mysql-download)
 * [Other](#other)
-    * [/tab cpu](#tab-cpu)
-    * [/tab parse \<player\> \<placeholder\>](#tab-parse-player-text)
+  * [/tab cpu](#tab-cpu)
+  * [/tab parse \<player\> \<placeholder\>](#tab-parse-player-text)
 * [Additional permissions](#additional-permissions)
 
 # Configuration commands
@@ -68,10 +68,10 @@ Commands have required permissions associated with them.
 ## /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 proxy, 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.
+  * On proxy, 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 group \<group\>
 * **Permission:** `tab.groupinfo`
@@ -90,7 +90,7 @@ Commands have required permissions associated with them.
 * **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:**
-    * `-s` for silent toggling (no chat message for affected player)
+  * `-s` for silent toggling (no chat message for affected player)
 
 ## /tab scoreboard announce \<name\> \<duration\>
 * **Permission:** `tab.announce.scoreboard`
@@ -105,7 +105,7 @@ Commands have required permissions associated with them.
 * **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:**
-    * `-s` for silent toggling (no chat message for affected player)
+  * `-s` for silent toggling (no chat message for affected player)
 
 ## /tab bossbar announce \<name\> \<duration\>
 * **Permission:** `tab.announce.bar`
@@ -116,13 +116,13 @@ Commands have required permissions associated with them.
 * **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)
+  * `-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 a specified player.
 * **Options:**
-    * `-s` for silent toggling (no chat message for affected player)
+  * `-s` for silent toggling (no chat message for affected player)
 
 ## /tab setcollision \<player\> \<true|false\>
 * **Permission:** `tab.setcollision`

.github/wiki/compatibility.md

@@ -1,16 +1,15 @@
 # Content
 * [Requirements](#requirements)
-    * [Java](#java)
+  * [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)
-    * [Forge / NeoForge](#forge--neoforge)
-    * [Sponge](#sponge)
-    * [Velocity](#velocity)
+  * [All platforms](#all-platforms)
+  * [Bukkit](#bukkit)
+  * [BungeeCord](#bungeecord)
+  * [Fabric](#fabric)
+  * [Forge / NeoForge](#forge--neoforge)
+  * [Velocity](#velocity)
 * [Compatibility issues](#compatibility-issues)
 
 # Requirements
@@ -18,7 +17,7 @@ TAB does not depend on any other plugins. The experience can however be enhanced
 
 ## Java
 TAB's shared module is compiled with Java 8. For the platforms themselves, TAB does have a higher requirement, however, it does not require a Java version higher than the server software itself does. Specifically:
-* Sponge, Fabric, Forge and NeoForge require Java 21
+* Fabric, Forge and NeoForge require Java 21
 * Velocity requires Java 17
 * Bukkit and BungeeCord are ok with Java 8
 
@@ -35,18 +34,18 @@ TAB's shared module is compiled with Java 8. For the platforms themselves, TAB d
         <tr>
             <td rowspan=2>Vanilla</td>
             <td rowspan=1><a href="https://getbukkit.org/">Bukkit</a> (+forge hybrids)</td>
-            <td>✔ (1.7.x - 1.21.10)</td>
+            <td>✔ (1.7.x - 1.21.11)</td>
         </tr>
         <tr>
             <td rowspan=1><a href="https://www.spongepowered.org/">Sponge</a></td>
-            <td>✔ (1.20.6 - 1.21.10)</td>
+            <td>❌</td>
         </tr>
     </tbody>
     <tbody>
         <tr>
             <td rowspan=3>Modded</td>
             <td rowspan=1><a href="https://fabricmc.net">Fabric</a></td>
-            <td>✔ (1.21.9 - 1.21.10)<sup>1</sup></td>
+            <td>✔ (1.21.11)<sup>1</sup></td>
         </tr>
         <tr>
             <td rowspan=1><a href="https://minecraftforge.net">Forge</a></td>
@@ -54,7 +53,7 @@ TAB's shared module is compiled with Java 8. For the platforms themselves, TAB d
         </tr>
         <tr>
             <td rowspan=1><a href="https://neoforged.net/">NeoForge</a></td>
-            <td>✔ (1.21.9 - 1.21.10)<sup>1</sup></td>
+            <td>✔ (1.21.11)<sup>1</sup></td>
         </tr>
     </tbody>
     <tbody>
@@ -70,7 +69,7 @@ TAB's shared module is compiled with Java 8. For the platforms themselves, TAB d
     </tbody>
 </table>
 
-<sup>1</sup> Modded platforms only support the latest MC version(s). For older MC versions try [modrinth](https://modrinth.com/plugin/tab-was-taken)'s version download filter. If TAB is not available for your desired Minecraft version or is very outdated, you may [request a backport](https://github.com/NEZNAMY/TAB/issues/new?template=backport.yml).
+<sup>1</sup> Modded platforms only support the latest MC version(s). For older MC versions try [Modrinth](https://modrinth.com/plugin/tab-was-taken)'s version download filter. If TAB is not available for your desired Minecraft version or is very outdated, you may [request a backport](https://github.com/NEZNAMY/TAB/issues/new?template=backport.yml).
 
 <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.
@@ -81,22 +80,21 @@ Since proxies support all client versions, there is never a reason to stay outda
 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 / 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)                                                                        | ✔               | ✔      | ✔                         | ✔          | ✔                                                                          |
+| 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  
- ❗ = 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
@@ -127,9 +125,6 @@ Communicating with other proxies to properly display visuals on players on anoth
 ## Forge / NeoForge
 [**LuckPerms**](https://github.com/LuckPerms/LuckPerms) - Permission checks with a string instead of using vanilla OP levels.
 
-## Sponge
-*None*
-
 ## Velocity
 [**PremiumVanish**](https://www.spigotmc.org/resources/14404) -
 Supporting PremiumVanish's vanishing levels instead of using a basic compatibility system.  
@@ -141,16 +136,17 @@ Sending scoreboard packets (scoreboard-teams, belowname-objective, playerlist-ob
 # 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.
 * 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.
+* **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.
 * **LimboAuth** may prevent TAB from applying tablist formatting in a way that is not detectable using Velocity API, resulting in the feature not working properly on join.
-* **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.  
+* **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.
-    * 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.
+  * 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.
+  * 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.
+* **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.

.github/wiki/developer_api.md

@@ -35,7 +35,7 @@ For Maven users, you can add the API dependency like this:
     <dependency>
         <groupId>com.github.NEZNAMY</groupId>
         <artifactId>TAB-API</artifactId>
-        <version>5.3.2</version>
+        <version>5.4.0</version>
         <scope>provided</scope>
     </dependency>
 </dependencies>
@@ -50,7 +50,7 @@ repositories {
 }
 
 dependencies {
-    compileOnly 'com.github.NEZNAMY:TAB-API:5.3.2'
+    compileOnly 'com.github.NEZNAMY:TAB-API:5.4.0'
 }
 ```
 
@@ -61,7 +61,7 @@ repositories {
 }
 
 dependencies {
-    compileOnly("com.github.NEZNAMY", "TAB-API", "5.3.2")
+    compileOnly("com.github.NEZNAMY", "TAB-API", "5.4.0")
 }
 ```
 

.github/wiki/feature_guide_belowname.md

@@ -1,29 +1,37 @@
 # Content
 * [About](#about)
 * [Configuration](#configuration)
-* [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)
-    * [Additional note 4 - Compatibility with modified clients](#additional-note-4---compatibility-with-modified-clients)
-* [Compatibility with other plugins](#compatibility-with-other-plugins)
 * [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)
+  * [Additional note 4 - Compatibility with modified clients](#additional-note-4---compatibility-with-modified-clients)
 * [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 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)
 * [Tips & Tricks](#tips--tricks)
-    * [Tip 1 - Heart symbol](#tip-1---heart-symbol)
+  * [Tip 1 - Heart symbol](#tip-1---heart-symbol)
 
 # About
 This features gives you control over Minecraft's scoreboard objective feature with BELOW_NAME slot.
-This line is displayed below the nametags of all player entities in game. It is not possible to explicitly disable this feature for NPCs, however, this goal can be achieved (see below for more info).
+This line is displayed below the nametags of all player entities in game. It is not possible to explicitly disable this feature for NPCs; however, this goal can be achieved (see below for more info).
 It is only visible when within an 8-block range of the player (the range is hardcoded in the client and cannot be changed with a plugin).
 
 Example visual effect:  
 ![](https://images-ext-1.discordapp.net/external/YlGPCRDJVeZZI0TPWmVBKyHszxSkjatmclyqUThvTz8/https/image.prntscr.com/image/jcETUzVQQYqectQ2aI4iqQ.png)
 
+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
+
+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
 The feature can be configured in **config.yml** under **belowname-objective** section.  
 This is how the default configuration looks:
 ```
@@ -35,27 +43,38 @@ belowname-objective:
   fancy-value-default: "NPC"
   disable-condition: '%world%=disabledworld'
 ```
+All the options are explained in the following table.
 
-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
-* `fancy-value` for 1.20.3+ (will show `fancy-value-default` on NPCs), which supports any text
+| 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`.                                                                                                                                                                                                                                                                                                                                                                                                               |
+| 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                | 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. |
 
-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, 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.
+# 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.**
 
-# 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+, where it completely replaces `value`.                                                                                                                                                                                                                                                                                                                                  |
-| 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                | Shared label shown after the score for every player entity. Everyone sees the same text (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) that must be met for disabling the feature for players. Set to empty for not disabling the feature ever.                                                                                                                                                                                                                                                               |
+# 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
@@ -73,33 +92,19 @@ NPC plugin can take advantage of this by using teams to hide the original name a
 
 This is how you can achieve it using the following popular NPC plugins:
 * **Citizens**:
-    * 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))
+  * 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.
+  * 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.
 
 # 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.
 
-# 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.
-
-# 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.
-* [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.**
-
 # Examples
 ## Example 1 - Per-world values
 This feature doesn't directly support per-world values or similar.
@@ -139,8 +144,7 @@ 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 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 - Hiding `title` for 1.20.3+ players
 1.20.3 has replaced `value` field,
@@ -181,7 +185,16 @@ You'll either need to live with it, or put some shared text there to avoid havin
 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
-  In order to use these placeholders, make sure PlaceholderAPI is installed and its `math` and `player` expansions are downloaded.
+
+## 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%"
+```
+<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
@@ -191,14 +204,4 @@ 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 4 - Health bar using hearts
-You can achieve this on `1.20.3+` using `healthbar` expansion from PlaceholderAPI:
-```
-belowname-objective:
-  fancy-value: "%healthbar_healthbar%"
-```
-<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.
+> 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.

.github/wiki/feature_guide_bossbar.md

@@ -1,137 +1,125 @@
 # 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)
+    * [Internal placeholders](#internal-placeholders)
+    * [PlaceholderAPI placeholders](#placeholderapi-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)
 * [API](#api)
 * [Examples](#examples)
-    * [Example 1 - Animated bossbar color](#example-1---animated-bossbar-color)
+    * [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 new placeholders available:
-* `%bossbar_announce_time_left_<bossbar>%` - Returns remaining time of the announcement in seconds.
-* `%bossbar_announce_time_total_<bossbar>%` - Returns total time of the announcement in seconds (the inputted number).
+# Placeholders
+## Internal 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). |
 
-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%`.
+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).
 
-## 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.                                                                                                                                                                                                                                                                                                                                                            |
+## PlaceholderAPI placeholders
+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.
 
+# 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**.
 
-## 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 proxies makes it look like a world switch to the client.
-To avoid this, the only way is to install TAB on the proxy and disable bossbar on that server.
+**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!
 
 # API
 *To get started with the API, see [Developer API](https://github.com/NEZNAMY/TAB/wiki/Developer-API) page.*
@@ -177,27 +165,29 @@ Methods in `BossBar`:
 * `BossBar#isAnnouncementBar()` - Returns `true` if this bossbar is defined as announcement bar in config, `false` if visible permanently.
 
 # Examples
-## Example 1 - Animated bossbar color
-You can animate the color of a bossbar using [animations](https://github.com/NEZNAMY/TAB/wiki/Animations).  
+## 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.
+
+> [!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
@@ -240,8 +230,20 @@ Then, create a display condition that checks if the animation is on the first fr
     ServerInfo:
       display-condition: "%animation:bossbar-toggle%=ON" # Check for the first frame of the animation
       style: "PROGRESS"
-      color: "%animation:barcolors%"
-      progress: "100" # in %
+      color: "PURPLE"
+      progress: "100"
       text: "&fWebsite: &bwww.domain.com"
 ```
-Now, the bossbar will appear and disappear every 10 seconds.
+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%"` 

.github/wiki/feature_guide_conditional_placeholders.md

@@ -1,28 +1,27 @@
 # Content
 * [About](#about)
 * [Condition types](#condition-types)
-    * [Number comparisons](#number-comparisons)
-    * [Text operations](#text-operations)
-    * [Permission](#permission)
+  * [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)
+  * [Displaying text](#displaying-text)
+  * [Display condition of a feature](#display-condition-of-a-feature)
+    * [Short format](#short-format)
 * [Refresh interval](#refresh-interval)
 * [Examples](#examples)
-    * [Example 1 - Chaining conditional placeholders](#example-1---chaining-conditional-placeholders)
-    * [Example 2 - Combining AND and OR](#example-2---combining-and-and-or)
-    * [Example 3 - Negating expressions](#example-3---negating-expressions)
+  * [Example 1 - Chaining conditional placeholders](#example-1---chaining-conditional-placeholders)
+  * [Example 2 - Combining AND and OR](#example-2---combining-and-and-or)
 
 # 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 comparisons
@@ -205,32 +204,3 @@ conditions:
     type: AND
 ```
 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 - Negating expressions
-Most condition types contain their opposites, such as:
-* `=` -> `!=`
-* `permission:` -> `!permission:`
-* `>=` -> `<`
-* `>` -> `<=`
-* `|-` -> `!|-`
-* `-|` -> `!-|`
-* `<-` -> `!<-`
-
-You can achieve this by creating a full condition and check if it returned false.  
-**Example:**  
-Original:
-```
-display-condition: "%server%|-lobby"
-```
-Negated:
-```
-conditions:
-  lobby:
-    conditions:
-      - "%server%|-lobby"
-```
-...
-```
-display-condition: "%condition:lobby%=false"
-```
-This way, the display condition will pass if the nested condition returned `false` (player is not in any lobby).

.github/wiki/feature_guide_global_playerlist.md

@@ -1,25 +1,46 @@
 # Content
 * [About](#about)
 * [Configuration](#configuration)
-    * [Grouping players only from certain servers](#grouping-players-only-from-certain-servers)
-    * [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)
+  * [Grouping players only from certain servers](#grouping-players-only-from-certain-servers)
+  * [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 other plugins](#compatibility-with-other-plugins)
 
 # About
 This feature allows you to see players from other servers, instead of only seeing players on the same server.  
 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) for proper linking of servers. On proxy installation, this is not required.
 
 # Configuration
+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                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| 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` (![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,
@@ -46,6 +67,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.
@@ -71,5 +122,5 @@ 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
+# 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.

.github/wiki/feature_guide_header_footer.md

@@ -1,15 +1,16 @@
 # Content
 * [About](#about)
 * [Configuration](#configuration)
-    * [Designs](#designs)
-    * [Chaining designs](#chaining-designs)
+  * [Design](#design)
+  * [Chaining designs](#chaining-designs)
+* [Compatibility with other plugins](#compatibility-with-other-plugins)
 * [Additional info](#additional-info)
-    * [Additional note 1 - [1.8 - 1.20.1] Not resetting on server switch](#additional-note-1---18---1201-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)
 * [API](#api)
 * [Examples](#examples)
-    * [Example 1 - Per-version header/footer](#example-1---per-version-headerfooter)
+  * [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.
@@ -17,16 +18,48 @@ 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
+The feature can be configured in **config.yml** under **header-footer** section.  
+This is how the default configuration looks:
+```
+header-footer:
+  enabled: true
+  designs:
+    world-test:
+      display-condition: "%world%=test"
+      header:
+        - "Test header in world 'test'"
+      footer:
+        - "Test footer in world 'test'"
+    default:
+      header:
+        - "<#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:
+        - "%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.
+
 | Option name       | Default value         | Description                                                       |
 |-------------------|-----------------------|-------------------------------------------------------------------|
 | enabled           | true                  | Enables / Disables the feature                                    |
 | designs           | *Map*                 | Designs to display based on conditions (see below for more info). |
 
-# Designs
-A header/footer design has 3 options:
-* `display-condition` (optional) - [Condition](https://github.com/NEZNAMY/TAB/wiki/Feature-guide:-Conditional-placeholders) that must be met for the design to be displayed. If not defined, design will be displayed without any required condition. If player does not meet condition, another design may be displayed 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.
+## 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**:
 ```
@@ -41,13 +74,13 @@ header-footer:
         - "Footer for world %world%"
 ```
 
-# Chaining designs
+## 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:
+If no suitable design is found (the last one has a condition requirement which wasn't met), none is displayed.  
+**Example**:
 ```
 header-footer:
   enabled: true
@@ -55,18 +88,23 @@ header-footer:
     per-world:
       display-condition: "%world%=world"
       header:
-        - "Header for world %world%"
+        - "Header for world world"
       footer:
-        - "Footer for world %world%"
+        - "Footer for world world"
     default:  # No display condition
       header:
-        - "Header for every world except %world%"
+        - "Header for every world except world"
       footer:
-        - "Footer for every world except %world%"
+        - "Footer for every world except world"
 ```
 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 - [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:
@@ -75,31 +113,6 @@ When under a BungeeCord network and having TAB installed on backend server and s
 
 Velocity sends reset packet, so it isn't a problem there.
 
-# Tips & Tricks
-## Tip 1 - 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>
-
-**animations.yml**
-```
-MyAnimation:
-  change-interval: 1000
-  texts:
-    - "First frame with only 1 line"
-    - "Second frame\nconsisting of 2 lines"
-```
-**config.yml**
-```
-header-footer:
-  designs:
-    DesignName:
-      header:
-        - "%animation:MyAnimation%"
-```
-</details>
-
 # API
 *To get started with the API, see [Developer API](https://github.com/NEZNAMY/TAB/wiki/Developer-API) page.*
 
@@ -130,4 +143,53 @@ header-footer:
         - "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>
+
+**animations.yml**
+```
+MyAnimation:
+  change-interval: 1000
+  texts:
+    - "First frame with only 1 line"
+    - "Second frame\nconsisting of 2 lines"
+```
+**config.yml**
+```
+header-footer:
+  designs:
+    DesignName:
+      header:
+        - "%animation:MyAnimation%"
+```
+</details>

.github/wiki/feature_guide_layout.md

@@ -1,82 +1,99 @@
 # Content
 * [About](#about)
-* [Creating a layout](#creating-a-layout)
-    * [Display condition](#display-condition)
-    * [default-skin](#default-skin)
+* [Configuration](#configuration)
+  * [Layout](#layout)
     * [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)
-* [Compatibility](#compatibility)
-    * [Playerlist objective incompatibility](#playerlist-objective-incompatibility)
-    * [Global playerlist incompatibility](#global-playerlist-incompatibility)
-    * [Per world playerlist incompatibility](#per-world-playerlist-incompatibility)
+  * [Chaining layouts](#chaining-layouts)
+  * [Skins](#skins)
+* [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 - [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](https://github.com/NEZNAMY/TAB/wiki/Feature-guide%3A-Layout/_edit#additional-note-3---entry-overlap)
+  * [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)
 * [Examples](#examples)
-    * [Example 1 - Per-server columns](#example-1---per-server-columns)
+  * [Example 1 - Per-server columns](#example-1---per-server-columns)
 
 # About
 This feature allows you to customize all 80 tablist slots. Displaying less than 4 columns is currently not supported ([here's why](https://gist.github.com/NEZNAMY/3dfcbf7d44283735d3c18266a2851651)). 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. A layout has 4 settings:
-* [Display condition](#display-condition) (optional)
-* [default-skin](#default-skin) (optional)
-* [Fixed slots](#fixed-slots)
-* [Player groups](#player-groups)
-
-## 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:
-```
-layouts:
-  staff:
-    condition: "permission:tab.staff"
-```
-This layout will only be visible to players with `tab.staff` permission.
-
-## default-skin
-When configured, layout will override `default-skin` value and use that one for empty slots and fixed slots without skin definition. When not set, global `default-skin` will be displayed.  
-**Example**:
+# Configuration
+The feature can be configured in **config.yml** under **layout** section.  
+This is how the default configuration looks:
 ```
 layout:
-  enabled: true
+  enabled: false
   direction: COLUMNS
-  default-skin: mineskin:37e93c8e12cd426cb28fce31969e0674  # Global default skin for all layouts
+  default-skin: mineskin:37e93c8e12cd426cb28fce31969e0674
   enable-remaining-players-text: true
   remaining-players-text: '... and %s more'
   empty-slot-ping-value: 1000
   layouts:
-    test:
-      default-skin: player:Notch  # All empty slots will use skin of player "Notch" in this layout
-      fixed-slots: []
+    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:
+          condition: permission:tab.staff
+          slots:
+            - 24-40
         players:
           slots:
-          - 1-80
+            - 44-80
 ```
+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      |
+|-------------|------------------|
+| `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`. **This option is coming in TAB v5.5.0**. |
+| `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'
@@ -87,12 +104,12 @@ layouts:
 If you do not wish to use any fixed slots, make it an empty list (`[]`).  
 Example:
 ```
-layouts:
-  staff:
-    fixed-slots: []
+  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**  
@@ -106,25 +123,25 @@ 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:
+          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:
@@ -142,31 +159,22 @@ layouts:
 ```
 In this example, players with `tab.staff` permission will see `staff` layout, others will see `default` layout.
 
-# 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).*  
-In slots which display a connected player, 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.
+## 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:<UUID>` - 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 with the `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 show this value. |
 
-# 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 |
+# 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).
 
-![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)
-
-# Compatibility
+# 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.  

.github/wiki/feature_guide_nametags.md

@@ -1,26 +1,29 @@
 # Content
 * [About](#about)
 * [Configuration](#configuration)
-    * [Groups and users](#groups-and-users)
-    * [Per-world / per-server](#per-world--per-server)
-    * [Priority system](#priority-system)
-    * [Name color](#name-color)
-    * [Placeholder support](#placeholder-support)
-    * [Additional settings](#additional-settings)
-* [Tips & Tricks](#tips--tricks)
+  * [config.yml](#configyml)
+  * [groups.yml and users.yml](#groupsyml-and-usersyml)
+  * [Name color](#name-color)
+* [Commands](#commands)
+* [Placeholders](#placeholders)
+  * [PlaceholderAPI placeholders](#placeholderapi-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)
+  * [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)
 * [API](#api)
-    * [Changing prefix and suffix](#changing-prefix-and-suffix)
-    * [Collision](#collision)
-    * [Manipulating visibility](#manipulating-visibility)
-    * [Disabling team handling](#disabling-team-handling)
+  * [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:
@@ -30,13 +33,36 @@ 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.
+
 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**
@@ -44,8 +70,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**
 ```
@@ -56,7 +81,7 @@ _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.  
@@ -69,7 +94,6 @@ _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 a proxy), where they can be defined per group/user. These values take priority over global settings. Example:  
 **groups.yml**
 ```
@@ -96,8 +120,7 @@ per-world:
       tagsuffix: "Suffix in all worlds starting with lobby-"
 ```
 
-## Priority system
-The full list of priorities looks like this:
+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
@@ -119,37 +142,36 @@ part of the value you are looking for.
 ## 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.
 
-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, while people are used to putting some color code at the end of prefix and expect the name to take it. For that reason, TAB detects the last used color code and uses that for team color.
+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`.
+> 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`.
 
-## 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.
+# 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.                                                                                                                                      |
 
-## 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 [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                 | When evaluates to `true`, makes player's nametag invisible. 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). <br /> Option to hide nametags was added in minecraft **1.8**, therefore it will not work on 1.7 and lower. |
-| 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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+# Placeholders
+This feature does not offer any internal placeholders, only PlaceholderAPI placeholders.
 
-# 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%"
-```
+## PlaceholderAPI 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). Any characters beyond that will be cut to prevent players getting disconnected.
+* [<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.
+  * 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.
 
@@ -159,9 +181,13 @@ If you want to avoid these at all costs, the only way is to create entities (arm
 * [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
@@ -171,9 +197,7 @@ To avoid it, make their names not match any online player and use holograms to d
 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. The only way to achieve this goal is to send & modify packets to replace the player's actual profile name with a fake one. This is very complicated and can have a lot of side effects. This is out of scope of TAB and is in fact something nick plugins are trying to achieve. As such, **TAB does not offer this**.
-
-Once you find a nick plugin that supports this, you will need to [make sure TAB properly detects this](https://github.com/NEZNAMY/TAB/wiki/How-to-display-name-from-nickname-plugins#proper-compatibility-with-plugins-that-change-profile-name) to make name-bound features (such as nametags) work properly for nicked players.
+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.
@@ -198,7 +222,8 @@ In config.yml. Keep in mind, you'll not be able to use any team features if you
 ## 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. The easiest way 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).
+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.
 
@@ -245,4 +270,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.

.github/wiki/feature_guide_per_world_playerlist.md

@@ -1,12 +1,12 @@
 # Content
 * [About](#about)
 * [Configuration](#configuration)
-    * [Grouping playerlist from multiple worlds](#grouping-playerlist-from-multiple-worlds)
+  * [Grouping playerlist from multiple worlds](#grouping-playerlist-from-multiple-worlds)
 
 # 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                                                                                                 |

.github/wiki/feature_guide_playerlist_objective.md

@@ -2,11 +2,15 @@
 * [About](#about)
 * [Configuration](#configuration)
 * [Limitations](#limitations)
+* [Compatibility with other plugins](#compatibility-with-other-plugins)
 * [Additional info](#additional-info)
-    * [Additional note 1 - Spectator gamemode](#additional-note-1---spectator-gamemode)
+  * [Additional note 1 - Spectator gamemode](#additional-note-1---spectator-gamemode)
+* [Examples](#examples)
+  * [Example 1 - Per-world values](#example-1---per-world-values)
 
 # 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,22 +19,81 @@ 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
+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-] Defines value displayed. You can set this to any placeholder that outputs a number. 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.                                                                                                                                                                                                                                                                                                   |
+| 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. <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`.                                                                                                                                                                                                                                                                                                   |
 | title             | "TAB"                 | Title to send. Only visible on Bedrock Edition.                                                                                                                                                                                                                                                                                                                      |
-| render-type       | INTEGER               | Render type of the value. Supported values are `INTEGER` and `HEARTS`                                                                                                                                                                                                                                                                                                |
-| 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.                                                                                                                                                                  |
+| render-type       | INTEGER               | Render type of the value. Supported values are `INTEGER` and `HEARTS`.                                                                                                                                                                                                                                                                                                |
+| 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.
+
+# 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.

.github/wiki/feature_guide_scoreboard.md

@@ -1,46 +1,112 @@
 # 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)
+  * [PlaceholderAPI placeholders](#placeholderapi-placeholders)
 * [Limitations](#limitations)
-* [Longer lines](#longer-lines)
 * [Compatibility with other plugins](#compatibility-with-other-plugins)
-* [Geyser / Bedrock issues](#geyser--bedrock-issues)
+* [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)
 * [API](#api)
-    * [Creating custom scoreboards](#creating-custom-scoreboards)
-    * [Showing custom scoreboards](#showing-custom-scoreboards)
-    * [Toggling scoreboard visibility](#toggling-scoreboard-visibility)
-    * [Announcing a scoreboard](#announcing-a-scoreboard)
+  * [Creating custom scoreboards](#creating-custom-scoreboards)
+  * [Showing custom scoreboards](#showing-custom-scoreboards)
+  * [Toggling scoreboard visibility](#toggling-scoreboard-visibility)
+  * [Announcing a scoreboard](#announcing-a-scoreboard)
 * [Examples](#examples)
-    * [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)
+  * [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.
+# 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:
+    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:
+        - "&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:
+        - "&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%"
+```
+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:** 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. Will not be visible for 1.20.3+ players, instead, you can configure any text to show using `\|\|text` in the lines (scroll up for more info).                                                                                                                                                                                                   |
+| 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).
+|
 
-# 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.
+## Scoreboard
+A scoreboard consists of the following options:
 
-Each scoreboard defines up to 3 parameters:
+| 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.                                                                                                                                                                                                                                                                                              |
 
-## 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.
+**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"
+```
 
-## lines
-Up to 15 lines of text. You can define more, but the client won't display them.
+### 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. To set it, use `||` sequence and put right-side text after it. Example:
 ```
@@ -77,75 +143,12 @@ Will give you
 
 The right side text will not be visible at 1.20.2 and lower, and numbers will be displayed instead.
 
-### 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
+### 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.
 
-## 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.
+### Longer lines
+*Since 1.13 the line length is unlimited, so you don't need to worry about this if you use 1.13+.*
 
-# 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.
-
-# Announce command
-This takes priority over the current scoreboard.
-Once the announcement is over, the previous scoreboard is restored.  
-`/tab scoreboard announce <name> <time>`  
-name - name of scoreboard to be displayed  
-time - number of seconds to display the scoreboard for
-
-# Additional settings
-| 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. |
-| 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. Will not be visible for 1.20.3+ players, instead, you can configure any text to show using `\|\|text` in the lines (scroll up for more info).                                                                                                                                                                                                   |
-| 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.                                                                                                                                                                                                                                                                                                                                                                                                    |
-
-# 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) (64 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 (on versions below 1.8 the scoreboard won't appear at all if more than 15 lines are displayed).
-* [Bedrock] Scoreboard lines may be cut off and show `...`, this can be bypassed by using [GeyserOptionalPack](https://github.com/GeyserMC/GeyserOptionalPack)
-
-# 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.
@@ -168,52 +171,77 @@ 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
+This feature does not offer any internal placeholders, only PlaceholderAPI placeholders.
+
+## PlaceholderAPI 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>
-
-# Geyser / Bedrock issues
+## 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
@@ -234,10 +262,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
@@ -274,8 +302,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:  

.github/wiki/feature_guide_sorting.md

@@ -1,20 +1,20 @@
 # Content
 * [Enabling](#enabling)
 * [Methods of sorting](#methods-of-sorting)
-    * [GROUPS](#groups)
-    * [PERMISSIONS](#permissions)
-    * [PLACEHOLDER](#placeholder)
-    * [PLACEHOLDER_A_TO_Z](#placeholder_a_to_z)
-    * [PLACEHOLDER_Z_TO_A](#placeholder_z_to_a)
-    * [PLACEHOLDER_LOW_TO_HIGH](#placeholder_low_to_high)
-    * [PLACEHOLDER_HIGH_TO_LOW](#placeholder_high_to_low)
+  * [GROUPS](#groups)
+  * [PERMISSIONS](#permissions)
+  * [PLACEHOLDER](#placeholder)
+  * [PLACEHOLDER_A_TO_Z](#placeholder_a_to_z)
+  * [PLACEHOLDER_Z_TO_A](#placeholder_z_to_a)
+  * [PLACEHOLDER_LOW_TO_HIGH](#placeholder_low_to_high)
+  * [PLACEHOLDER_HIGH_TO_LOW](#placeholder_high_to_low)
 * [Multiple elements with the same priority](#multiple-elements-with-the-same-priority)
 * [Combining multiple sorting types](#combining-multiple-sorting-types)
 * [Additional settings](#additional-settings)
 * [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)
+  * [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)
 * [API](#api)
 
@@ -228,10 +228,10 @@ The most common mistakes include:
 * Disabling both teams and layout, not realizing it disables sorting as well.
 * 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 a proxy without knowing what it does.
-    * Installing TAB on a proxy without having any permission plugin on the proxy.
-    * Enabling `assign-groups-by-permissions` without giving those permissions (or the opposite - giving away OP to users, resulting in the highest group being taken).
+  * Not configuring group weights in LuckPerms.
+  * Accidentally enabling `use-bukkit-permission-manager` option when on a proxy without knowing what it does.
+  * Installing TAB on a proxy without having any permission plugin on the proxy.
+  * 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 backend and proxy, causing the installations to conflict.

.github/wiki/feature_guide_spectator_fix.md

@@ -3,12 +3,12 @@
 * [Enabling](#enabling)
 * [Permissions](#permissions)
 * [Additional info](#additional-info)
-    * [Additional note 1 - Seeing yourself still as spectator](#additional-note-1---seeing-yourself-still-as-spectator)
+  * [Additional note 1 - Seeing yourself still as spectator](#additional-note-1---seeing-yourself-still-as-spectator)
 
 # 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

.github/wiki/feature_guide_tablist_name_formatting.md

@@ -1,18 +1,18 @@
 # 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)
+  * [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)
 * [API](#api)
 
 # 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,

.github/wiki/feature_requests.md

@@ -1,8 +1,5 @@
 # About
 A collection of things people have requested that I might look into implementing when I get extremely bored sometime next decade.
-* Less than 4 columns in Layout
 * Relational placeholder support in sorting
-* Relational conditions for layout player groups
 * 1.21.2+ sorting support
-* disable-condition support in multi-server-support
-* Custom relational placeholders
+* disable-condition support in multi-server-support

.github/wiki/frequently_asked_questions.md

@@ -10,7 +10,7 @@
 * [#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)
@@ -18,6 +18,7 @@
 * [#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).
@@ -26,8 +27,8 @@ See [Citizens FAQ](https://wiki.citizensnpcs.co/Frequently_Asked_Questions#Why_a
 * 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. 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%`.
+  * 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%`.
 
 ## #3 - I enabled MySQL, and my prefix is now gone!
 When enabling [MySQL](https://github.com/NEZNAMY/TAB/wiki/MySQL), it will be used as a data storage and groups.yml / users.yml files will no longer be used.  
@@ -71,7 +72,7 @@ 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:
@@ -82,14 +83,29 @@ Most common reasons for a placeholder to not work include:
 
 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.
@@ -114,7 +130,7 @@ An alternative solution using TAB is putting a lot of empty lines into header,
 which will push all players out of the screen.
 
 ## #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?
@@ -141,4 +157,11 @@ 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).
+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).

.github/wiki/home.md

@@ -1,5 +1,5 @@
 # About the wiki
-The wiki explains the functionality of the plugin as of version **5.3.2**.
+The wiki explains the functionality of the plugin as of version **5.4.0**.
 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.
@@ -14,9 +14,9 @@ A lot of examples on the wiki use PlaceholderAPI placeholders without explaining
 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), Sponge and modded servers |
+| 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 (even on modded platforms, it is only a server-sided mod).

.github/wiki/how_to_assign_players_into_groups.md

@@ -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:
 ```

.github/wiki/how_to_display_name_from_nickname_plugins.md

@@ -3,8 +3,8 @@
 * [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)
+  * [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)
 
 # Tablist
 This one is straightforward.
@@ -29,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,
@@ -43,13 +53,13 @@ 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 modded platforms.
-**This detection is not available on Sponge and Velocity**.
+**This detection is not available on 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 (either you use TAB on Sponge / Velocity, or 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.
+> If automatic detection is not working for you (either you use TAB on Velocity, or 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.

.github/wiki/how_to_use_minecraft_components.md

@@ -1,25 +1,25 @@
 # 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)
+  * [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)
+  * [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)
+  * [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)
+  * [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.  
+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.
@@ -121,7 +121,7 @@ Example:
 > ```
 > in **config.yml**.
 
-This type allows you to display minecraft heads. There are 3 ways to define a head:
+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. |
@@ -136,7 +136,7 @@ Here are all the ways you can display player skins using TAB and their implement
 | `<head:signed_texture:VALUE;SIGNATURE>` | Shows head defined by value and signature | value and signature |
 | `<head:player:NAME` | Connects to Mojang and retrieves value and signature of defined player | value and signature |
 | `<head:mineskin:ID>` | Connects to Mineskin and retrieves value and signature of specified upload ID | value and signature |
-| `<head:texture:VALUE>` | Connects to Mojang and retrieves skin value and signature from "texture" | value and signature |
+| `<head:texture:TEXTURE>` | Gets the texture from `http://textures.minecraft.net/texture/TEXTURE` | value and signature |
 
 Here is an example for all types:
 ```
@@ -155,12 +155,12 @@ Here is an example for all types:
 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          | ViaBackwards 5.5.0 - [Client disconnects with a packet decoding error](https://github.com/ViaVersion/ViaBackwards/issues/1107) <br /> ViaBackwards 5.5.1+ - (empty) |
-| BungeeCord      | TAB                 | `<Object components were added in 1.21.9>`                                                                                                                          |
-| Velocity        | Velocity            | Client disconnects with a packet decoding error                                                                                                                     |
+| 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.

.github/wiki/installation.md

@@ -1,9 +1,9 @@
 # Content
 * [Backend](#backend)
 * [Proxy](#proxy)
-    * [Proxy installation](#proxy-installation)
-    * [Backend installation](#backend-installation)
-    * [Mixed installation](#mixed-installation)
+  * [Proxy installation](#proxy-installation)
+  * [Backend installation](#backend-installation)
+  * [Mixed installation](#mixed-installation)
 * [Updating the plugin](#updating-the-plugin)
 
 # Backend

.github/wiki/known_issues.md

@@ -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.

.github/wiki/mini_guides_collection.md

@@ -7,8 +7,8 @@ Combine the knowledge gathered by reading the wiki to get interesting results, m
 * [BedWars1058 compatibility](#bedwars1058-compatibility)
 * [Displaying AFK status in tablist](#displaying-afk-status-in-tablist)
 * [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)
+  * [Option 1 - Using global playerlist](#option-1---using-global-playerlist)
+  * [Option 2 - Using PlaceholderAPI](#option-2---using-placeholderapi)
 
 # Displaying kill / death counter in tablist
 This example uses PlaceholderAPI placeholders.  

.github/wiki/mysql.md

@@ -3,8 +3,8 @@
 * [Enabling](#enabling)
 * [Configuration changes](#configuration-changes)
 * [Data conversion](#data-conversion)
-    * [Downloading from MySQL to files](#downloading-from-mysql-to-files)
-    * [Uploading from files to MySQL](#uploading-from-files-to-mysql)
+  * [Downloading from MySQL to files](#downloading-from-mysql-to-files)
+  * [Uploading from files to MySQL](#uploading-from-files-to-mysql)
 * [Synchronization frequency](#synchronization-frequency)
 
 # About
@@ -26,8 +26,7 @@ See the compatibility table below for current information about compatibility:
 |------------|-----------|
 | Bukkit     | ✔         |
 | BungeeCord | ✔         |
-| Fabric     | ❌         |
-| Sponge     | ❌         |
+| Modded     | ❌         |
 | Velocity   | ❌         |
 
 # Enabling

.github/wiki/placeholders.md

@@ -1,23 +1,23 @@
 # Content
 * [About](#about)
 * [Internal placeholders](#internal-placeholders)
-    * [Universal](#universal)
-    * [Backend only](#backend-only)
-    * [Proxy only](#proxy-only)
+  * [Universal](#universal)
+  * [Backend only](#backend-only)
+  * [Proxy only](#proxy-only)
 * [PlaceholderAPI](#placeholderapi)
 * [Relational placeholders](#relational-placeholders)
-    * [About](#about-1)
-    * [Usage](#usage)
+  * [About](#about-1)
+  * [Usage](#usage)
 * [Refreshing](#refreshing)
-    * [Refresh intervals](#refresh-intervals)
-    * [Sync refreshing](#sync-refreshing)
+  * [Refresh intervals](#refresh-intervals)
+  * [Sync refreshing](#sync-refreshing)
 * [Placeholder is not working](#placeholder-is-not-working)
-    * [Internal placeholder is not working](#internal-placeholder-is-not-working)
-    * [PlaceholderAPI placeholder is not working](#placeholderapi-placeholder-is-not-working)
+  * [Internal placeholder is not working](#internal-placeholder-is-not-working)
+  * [PlaceholderAPI placeholder is not working](#placeholderapi-placeholder-is-not-working)
 * [API](#api)
-    * [Server placeholders](#server-placeholders)
-    * [Player placeholders](#player-placeholders)
-    * [Relational placeholders](#relational-placeholders-1)
+  * [Server placeholders](#server-placeholders)
+  * [Player placeholders](#player-placeholders)
+  * [Relational placeholders](#relational-placeholders-1)
 
 # About
 TAB offers various placeholders to display the most common information. It also supports [PlaceholderAPI placeholders](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders).
@@ -37,35 +37,35 @@ Refresh interval for conditions is set to be equal to the fastest refreshing pla
 ## 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                                                                                                                                                                                                                                                                                                                                        |
-| %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 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                                                                                                                                                                                                                                                                                         |
-| %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.                                                                                                                                                                                                                                                                                                              |
-| %%                                        | -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.                                                                                                                                                                                                                                                                                                |
+| %%                                        | -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, 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.
@@ -73,7 +73,7 @@ These placeholders only work when TAB is installed on a backend server, they don
 | ------------- | ------------- | ------------- | ------------- |
 | %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 the server. Not directly available on Fabric, Forge and Neoforge. Primitive approximation using MSPT (TPS = 1000/MSPT, max 20) is used there. | %server_tps_1% |
+| %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% |
 
@@ -100,25 +100,43 @@ placeholders:
   register-tab-expansion: true
 ```
 in **config.yml**.  
-Full list of placeholders:  
+Full list of placeholders (general + feature specific):
+
+**General**:
 | 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_visibility% | "Enabled" if player can see nametags, "Disabled" if disabled using `/tab nametag toggleview` |
-| %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%) |
+| `%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%`) |
+
+**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. |
 
 # Relational placeholders
 ## About
@@ -167,22 +185,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 backend only (meaning they won't work on proxy) and some are proxy only.
-> [!IMPORTANT]
-> Trying to use a backend-only placeholder on proxy will not work.
-> If you want to use those,
-> [set up PlaceholderAPI support on proxy](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 a proxy, make sure you [set up PlaceholderAPI support on proxy](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.*

.github/wiki/quick_placeholderapi_startup_guide.md

@@ -2,7 +2,7 @@
 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.
+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.

.github/wiki/tab_bridge.md

@@ -20,7 +20,7 @@ Bridge itself has no config file, as everything is configured in the main plugin
 * Forward player's gamemode for spectator fix feature to work
 
 # Compatibility
-Just like with Minecraft, when there is a change in the communication protocol between TAB <-> TAB-Bridge,
+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.
 

.github/wiki/tab_vs_other_plugins.md

@@ -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**       | ✔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | ✔                                                                                                                                                                                                                                                                                      | ✔                                                                                                                                                                                         | ❌                                                                                            | ✔                                                                                            |

.github/wiki/why_tab.md

@@ -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, Fabric, Forge, NeoForge, Sponge, Velocity),
+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.

README.md

@@ -1,55 +1,3 @@
 # About
-TAB aims to be a superior all-in-one minecraft plugin for displaying information that outperforms all 
-similar plugins in terms of features, performance and compatibility.  
-More information can be found at [Why TAB?](https://github.com/NEZNAMY/TAB/wiki/Why-TAB%3F) wiki page.
-
-# 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), [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
-update, therefore development builds are being created and eventually a full update is released when enough changes are made.  
-If you want to benefit from a recent change in the code before official release, you can download development builds
-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.  
-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.
-
-# Documentation
-You can find everything about the plugin on the [Wiki](https://github.com/NEZNAMY/TAB/wiki). This includes a detailed description
-of all features, as well as information regarding compatibility or limitations of each feature.  
-
-# Issues
-The [Issues](https://github.com/NEZNAMY/TAB/issues) section is an issue tracker for all the kind of problems covered in issue templates.
-Please refrain from attempting to use it to receive help with your server, such issues will be closed immediately.  
-When opening an issue, provide as much information as possible. The difference between a bug getting fixed in 1 week vs 1 hour
-is in quality of the report. Bug reports where steps to reproduce are "idk" have no value and will not help to get the bug fixed at all.  
-
-# Contributing
-See [CONTRIBUTING.md](https://github.com/NEZNAMY/TAB/blob/master/CONTRIBUTING.md)
-
-# Provided services
-The plugin is being used by a large amount of servers, which also means the demand for my attention is high. Unfortunately, 
-I am no longer able to keep up with the demand since I don't want to dedicate my whole existence to a free plugin. 
-In order to provide the best quality of all provided services, the amount of services provided may vary over time. 
-Here is the full list of potential services and their status:
-
-| Service type                  | Availability |
-|-------------------------------|--------------|
-| Updates for new MC versions   | ✔            |
-| Bug fixes                     | ✔            |
-| Wiki improvements             | ✔            |
-| Performance optimizations     | ✔            |
-| Feature requests              | ❌            |
-| Customer support<sup>1</sup>  | ✔            |
-| Free user support<sup>2</sup> | ❌*           |
-
-<sup>1</sup> - Unrestricted assistance with the plugin for those, who bought a copy of the plugin when it was purchasable.  
-<sup>2</sup> - Unlimited access to my free time for everyone in the world.  
-  
-*Instead, you can use [this fresh new community discord](https://discord.gg/YPqXt63YQj) made by a nice person who will provide this service.  
+This is an archived source code of the latest release with full MC 1.x support on Bukkit and backporting services on modded platforms - 5.5.0.  
+Starting with 6.0.0, support for old unused Bukkit versions will start disappearing and modded platforms will only support MC 26+ without offering backport services to 1.x.

build.gradle.kts

@@ -4,7 +4,7 @@ plugins {
 
 allprojects {
     group = "me.neznamy"
-    version = "5.4.0"
+    version = "5.5.0"
     description = "An all-in-one solution that works"
 
     ext.set("id", "tab")

bukkit/paper_1_20_5/src/main/java/me/neznamy/tab/platforms/paper_1_20_5/PaperImplementationProvider.java

@@ -7,9 +7,11 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 /**
  * Implementation provider using direct Mojang-mapped NMS code for versions 1.20.5 - 1.21.1.
@@ -34,8 +36,14 @@ public class PaperImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().connection.connection.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().connection.connection.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new PaperTabListEntryTracker();
     }
 
     @Override

bukkit/paper_1_20_5/src/main/java/me/neznamy/tab/platforms/paper_1_20_5/PaperPacketTabList.java

@@ -87,11 +87,6 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(new ClientboundTabListPacket(header.convert(), footer.convert()));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {
@@ -119,6 +114,7 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
                 Component displayName = nmsData.displayName();
                 int latency = nmsData.latency();
                 int gameMode = nmsData.gameMode().getId();
+                boolean listed = nmsData.listed();
                 if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_DISPLAY_NAME)) {
                     TabComponent forcedDisplayName = getForcedDisplayNames().get(nmsData.profileId());
                     if (forcedDisplayName != null && forcedDisplayName.convert() != displayName) {
@@ -138,11 +134,17 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
                         rewriteEntry = rewritePacket = true;
                     }
                 }
+                if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_LISTED)) {
+                    if (allPlayersHidden && nmsData.profileId().getMostSignificantBits() != 0) { // Filter out layout entries
+                        listed = false;
+                        rewriteEntry = rewritePacket = true;
+                    }
+                }
                 if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) {
                     TAB.getInstance().getFeatureManager().onEntryAdd(player, nmsData.profileId(), nmsData.profile().getName());
                 }
                 updatedList.add(rewriteEntry ? new ClientboundPlayerInfoUpdatePacket.Entry(
-                        nmsData.profileId(), nmsData.profile(), nmsData.listed(), latency, GameType.byId(gameMode), displayName,
+                        nmsData.profileId(), nmsData.profile(), listed, latency, GameType.byId(gameMode), displayName,
                         nmsData.chatSession()
                 ) : nmsData);
             }

bukkit/paper_1_20_5/src/main/java/me/neznamy/tab/platforms/paper_1_20_5/PaperTabListEntryTracker.java

@@ -0,0 +1,30 @@
+package me.neznamy.tab.platforms.paper_1_20_5;
+
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import net.minecraft.network.protocol.game.ClientboundPlayerInfoRemovePacket;
+import net.minecraft.network.protocol.game.ClientboundPlayerInfoUpdatePacket;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.UUID;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class PaperTabListEntryTracker extends TabListEntryTracker {
+
+    @Override
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof ClientboundPlayerInfoRemovePacket remove) {
+            for (UUID id : remove.profileIds()) {
+                tablistEntries.remove(id);
+            }
+        }
+        if (packet instanceof ClientboundPlayerInfoUpdatePacket update) {
+            if (update.actions().contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) {
+                for (ClientboundPlayerInfoUpdatePacket.Entry nmsData : update.entries()) {
+                    tablistEntries.add(nmsData.profileId());
+                }
+            }
+        }
+    }
+}

bukkit/paper_1_21_11/src/main/java/me/neznamy/tab/platforms/paper_1_21_11/PaperImplementationProvider.java

@@ -7,9 +7,11 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 /**
  * Implementation provider using direct Mojang-mapped NMS code for version 1.21.11.
@@ -34,8 +36,14 @@ public class PaperImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().connection.connection.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().connection.connection.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new PaperTabListEntryTracker();
     }
 
     @Override

bukkit/paper_1_21_11/src/main/java/me/neznamy/tab/platforms/paper_1_21_11/PaperPacketTabList.java

@@ -90,11 +90,6 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(new ClientboundTabListPacket(header.convert(), footer.convert()));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {
@@ -122,6 +117,7 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
                 Component displayName = nmsData.displayName();
                 int latency = nmsData.latency();
                 int gameMode = nmsData.gameMode().getId();
+                boolean listed = nmsData.listed();
                 if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_DISPLAY_NAME)) {
                     TabComponent forcedDisplayName = getForcedDisplayNames().get(nmsData.profileId());
                     if (forcedDisplayName != null && forcedDisplayName.convert() != displayName) {
@@ -141,11 +137,17 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
                         rewriteEntry = rewritePacket = true;
                     }
                 }
+                if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_LISTED)) {
+                    if (allPlayersHidden && nmsData.profileId().getMostSignificantBits() != 0) { // Filter out layout entries
+                        listed = false;
+                        rewriteEntry = rewritePacket = true;
+                    }
+                }
                 if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) {
                     TAB.getInstance().getFeatureManager().onEntryAdd(player, nmsData.profileId(), nmsData.profile().name());
                 }
                 updatedList.add(rewriteEntry ? new ClientboundPlayerInfoUpdatePacket.Entry(
-                        nmsData.profileId(), nmsData.profile(), nmsData.listed(), latency, GameType.byId(gameMode), displayName,
+                        nmsData.profileId(), nmsData.profile(), listed, latency, GameType.byId(gameMode), displayName,
                         nmsData.showHat(), nmsData.listOrder(), nmsData.chatSession()
                 ) : nmsData);
             }

bukkit/paper_1_21_11/src/main/java/me/neznamy/tab/platforms/paper_1_21_11/PaperTabListEntryTracker.java

@@ -0,0 +1,30 @@
+package me.neznamy.tab.platforms.paper_1_21_11;
+
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import net.minecraft.network.protocol.game.ClientboundPlayerInfoRemovePacket;
+import net.minecraft.network.protocol.game.ClientboundPlayerInfoUpdatePacket;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.UUID;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class PaperTabListEntryTracker extends TabListEntryTracker {
+
+    @Override
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof ClientboundPlayerInfoRemovePacket remove) {
+            for (UUID id : remove.profileIds()) {
+                tablistEntries.remove(id);
+            }
+        }
+        if (packet instanceof ClientboundPlayerInfoUpdatePacket update) {
+            if (update.actions().contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) {
+                for (ClientboundPlayerInfoUpdatePacket.Entry nmsData : update.entries()) {
+                    tablistEntries.add(nmsData.profileId());
+                }
+            }
+        }
+    }
+}

bukkit/paper_1_21_2/src/main/java/me/neznamy/tab/platforms/paper_1_21_2/PaperImplementationProvider.java

@@ -7,9 +7,11 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 /**
  * Implementation provider using direct Mojang-mapped NMS code for versions 1.21.2 - 1.21.3.
@@ -34,8 +36,14 @@ public class PaperImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().connection.connection.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().connection.connection.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new PaperTabListEntryTracker();
     }
 
     @Override

bukkit/paper_1_21_2/src/main/java/me/neznamy/tab/platforms/paper_1_21_2/PaperPacketTabList.java

@@ -88,11 +88,6 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(new ClientboundTabListPacket(header.convert(), footer.convert()));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {
@@ -120,6 +115,7 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
                 Component displayName = nmsData.displayName();
                 int latency = nmsData.latency();
                 int gameMode = nmsData.gameMode().getId();
+                boolean listed = nmsData.listed();
                 if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_DISPLAY_NAME)) {
                     TabComponent forcedDisplayName = getForcedDisplayNames().get(nmsData.profileId());
                     if (forcedDisplayName != null && forcedDisplayName.convert() != displayName) {
@@ -139,11 +135,17 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
                         rewriteEntry = rewritePacket = true;
                     }
                 }
+                if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_LISTED)) {
+                    if (allPlayersHidden && nmsData.profileId().getMostSignificantBits() != 0) { // Filter out layout entries
+                        listed = false;
+                        rewriteEntry = rewritePacket = true;
+                    }
+                }
                 if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) {
                     TAB.getInstance().getFeatureManager().onEntryAdd(player, nmsData.profileId(), nmsData.profile().getName());
                 }
                 updatedList.add(rewriteEntry ? new ClientboundPlayerInfoUpdatePacket.Entry(
-                        nmsData.profileId(), nmsData.profile(), nmsData.listed(), latency, GameType.byId(gameMode), displayName,
+                        nmsData.profileId(), nmsData.profile(), listed, latency, GameType.byId(gameMode), displayName,
                         nmsData.listOrder(), nmsData.chatSession()
                 ) : nmsData);
             }

bukkit/paper_1_21_2/src/main/java/me/neznamy/tab/platforms/paper_1_21_2/PaperTabListEntryTracker.java

@@ -0,0 +1,30 @@
+package me.neznamy.tab.platforms.paper_1_21_2;
+
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import net.minecraft.network.protocol.game.ClientboundPlayerInfoRemovePacket;
+import net.minecraft.network.protocol.game.ClientboundPlayerInfoUpdatePacket;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.UUID;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class PaperTabListEntryTracker extends TabListEntryTracker {
+
+    @Override
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof ClientboundPlayerInfoRemovePacket remove) {
+            for (UUID id : remove.profileIds()) {
+                tablistEntries.remove(id);
+            }
+        }
+        if (packet instanceof ClientboundPlayerInfoUpdatePacket update) {
+            if (update.actions().contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) {
+                for (ClientboundPlayerInfoUpdatePacket.Entry nmsData : update.entries()) {
+                    tablistEntries.add(nmsData.profileId());
+                }
+            }
+        }
+    }
+}

bukkit/paper_1_21_4/src/main/java/me/neznamy/tab/platforms/paper_1_21_4/PaperImplementationProvider.java

@@ -7,9 +7,11 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 /**
  * Implementation provider using direct Mojang-mapped NMS code for versions 1.21.4 - 1.21.8.
@@ -34,8 +36,14 @@ public class PaperImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().connection.connection.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().connection.connection.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new PaperTabListEntryTracker();
     }
 
     @Override

bukkit/paper_1_21_4/src/main/java/me/neznamy/tab/platforms/paper_1_21_4/PaperPacketTabList.java

@@ -89,11 +89,6 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(new ClientboundTabListPacket(header.convert(), footer.convert()));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {
@@ -121,6 +116,7 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
                 Component displayName = nmsData.displayName();
                 int latency = nmsData.latency();
                 int gameMode = nmsData.gameMode().getId();
+                boolean listed = nmsData.listed();
                 if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_DISPLAY_NAME)) {
                     TabComponent forcedDisplayName = getForcedDisplayNames().get(nmsData.profileId());
                     if (forcedDisplayName != null && forcedDisplayName.convert() != displayName) {
@@ -140,11 +136,17 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
                         rewriteEntry = rewritePacket = true;
                     }
                 }
+                if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_LISTED)) {
+                    if (allPlayersHidden && nmsData.profileId().getMostSignificantBits() != 0) { // Filter out layout entries
+                        listed = false;
+                        rewriteEntry = rewritePacket = true;
+                    }
+                }
                 if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) {
                     TAB.getInstance().getFeatureManager().onEntryAdd(player, nmsData.profileId(), nmsData.profile().getName());
                 }
                 updatedList.add(rewriteEntry ? new ClientboundPlayerInfoUpdatePacket.Entry(
-                        nmsData.profileId(), nmsData.profile(), nmsData.listed(), latency, GameType.byId(gameMode), displayName,
+                        nmsData.profileId(), nmsData.profile(), listed, latency, GameType.byId(gameMode), displayName,
                         nmsData.showHat(), nmsData.listOrder(), nmsData.chatSession()
                 ) : nmsData);
             }

bukkit/paper_1_21_4/src/main/java/me/neznamy/tab/platforms/paper_1_21_4/PaperTabListEntryTracker.java

@@ -0,0 +1,30 @@
+package me.neznamy.tab.platforms.paper_1_21_4;
+
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import net.minecraft.network.protocol.game.ClientboundPlayerInfoRemovePacket;
+import net.minecraft.network.protocol.game.ClientboundPlayerInfoUpdatePacket;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.UUID;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class PaperTabListEntryTracker extends TabListEntryTracker {
+
+    @Override
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof ClientboundPlayerInfoRemovePacket remove) {
+            for (UUID id : remove.profileIds()) {
+                tablistEntries.remove(id);
+            }
+        }
+        if (packet instanceof ClientboundPlayerInfoUpdatePacket update) {
+            if (update.actions().contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) {
+                for (ClientboundPlayerInfoUpdatePacket.Entry nmsData : update.entries()) {
+                    tablistEntries.add(nmsData.profileId());
+                }
+            }
+        }
+    }
+}

bukkit/paper_1_21_9/src/main/java/me/neznamy/tab/platforms/paper_1_21_9/PaperImplementationProvider.java

@@ -7,9 +7,11 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 /**
  * Implementation provider using direct Mojang-mapped NMS code for versions 1.21.9 - 1.21.10.
@@ -34,8 +36,14 @@ public class PaperImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().connection.connection.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().connection.connection.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new PaperTabListEntryTracker();
     }
 
     @Override

bukkit/paper_1_21_9/src/main/java/me/neznamy/tab/platforms/paper_1_21_9/PaperPacketTabList.java

@@ -91,11 +91,6 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(new ClientboundTabListPacket(header.convert(), footer.convert()));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {
@@ -123,6 +118,7 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
                 Component displayName = nmsData.displayName();
                 int latency = nmsData.latency();
                 int gameMode = nmsData.gameMode().getId();
+                boolean listed = nmsData.listed();
                 if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_DISPLAY_NAME)) {
                     TabComponent forcedDisplayName = getForcedDisplayNames().get(nmsData.profileId());
                     if (forcedDisplayName != null && forcedDisplayName.convert() != displayName) {
@@ -142,11 +138,17 @@ public class PaperPacketTabList extends TrackedTabList<BukkitTabPlayer> {
                         rewriteEntry = rewritePacket = true;
                     }
                 }
+                if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.UPDATE_LISTED)) {
+                    if (allPlayersHidden && nmsData.profileId().getMostSignificantBits() != 0) { // Filter out layout entries
+                        listed = false;
+                        rewriteEntry = rewritePacket = true;
+                    }
+                }
                 if (actions.contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) {
                     TAB.getInstance().getFeatureManager().onEntryAdd(player, nmsData.profileId(), nmsData.profile().name());
                 }
                 updatedList.add(rewriteEntry ? new ClientboundPlayerInfoUpdatePacket.Entry(
-                        nmsData.profileId(), nmsData.profile(), nmsData.listed(), latency, GameType.byId(gameMode), displayName,
+                        nmsData.profileId(), nmsData.profile(), listed, latency, GameType.byId(gameMode), displayName,
                         nmsData.showHat(), nmsData.listOrder(), nmsData.chatSession()
                 ) : nmsData);
             }

bukkit/paper_1_21_9/src/main/java/me/neznamy/tab/platforms/paper_1_21_9/PaperTabListEntryTracker.java

@@ -0,0 +1,30 @@
+package me.neznamy.tab.platforms.paper_1_21_9;
+
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import net.minecraft.network.protocol.game.ClientboundPlayerInfoRemovePacket;
+import net.minecraft.network.protocol.game.ClientboundPlayerInfoUpdatePacket;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.UUID;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class PaperTabListEntryTracker extends TabListEntryTracker {
+
+    @Override
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof ClientboundPlayerInfoRemovePacket remove) {
+            for (UUID id : remove.profileIds()) {
+                tablistEntries.remove(id);
+            }
+        }
+        if (packet instanceof ClientboundPlayerInfoUpdatePacket update) {
+            if (update.actions().contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) {
+                for (ClientboundPlayerInfoUpdatePacket.Entry nmsData : update.entries()) {
+                    tablistEntries.add(nmsData.profileId());
+                }
+            }
+        }
+    }
+}

bukkit/src/main/java/me/neznamy/tab/platforms/bukkit/BukkitEventListener.java

@@ -1,5 +1,6 @@
 package me.neznamy.tab.platforms.bukkit;
 
+import lombok.RequiredArgsConstructor;
 import me.neznamy.tab.platforms.bukkit.platform.BukkitPlatform;
 import me.neznamy.tab.shared.TAB;
 import me.neznamy.tab.shared.platform.EventListener;
@@ -16,8 +17,12 @@ import org.jetbrains.annotations.NotNull;
 /**
  * The core for bukkit forwarding events into all enabled features
  */
+@RequiredArgsConstructor
 public class BukkitEventListener implements EventListener<Player>, Listener {
 
+    /** Platform reference */
+    private final BukkitPlatform platform;
+
     /**
      * Listens to player quit event.
      *
@@ -37,6 +42,11 @@ public class BukkitEventListener implements EventListener<Player>, Listener {
      */
     @EventHandler(priority = EventPriority.LOW)
     public void onJoin(PlayerJoinEvent e) {
+        TAB.getInstance().addTablistTracker(
+                e.getPlayer().getUniqueId(),
+                platform.getImplementationProvider().getChannel(e.getPlayer()),
+                platform.getImplementationProvider().newTabListEntryTracker()
+        );
         join(e.getPlayer());
     }
 
@@ -54,6 +64,6 @@ public class BukkitEventListener implements EventListener<Player>, Listener {
     @Override
     @NotNull
     public TabPlayer createPlayer(@NotNull Player player) {
-        return new BukkitTabPlayer((BukkitPlatform) TAB.getInstance().getPlatform(), player);
+        return new BukkitTabPlayer(platform, player);
     }
 }

bukkit/src/main/java/me/neznamy/tab/platforms/bukkit/BukkitPipelineInjector.java

@@ -1,7 +1,6 @@
 package me.neznamy.tab.platforms.bukkit;
 
 import io.netty.channel.Channel;
-import lombok.SneakyThrows;
 import me.neznamy.tab.platforms.bukkit.platform.BukkitPlatform;
 import me.neznamy.tab.shared.features.injection.NettyPipelineInjector;
 import me.neznamy.tab.shared.platform.TabPlayer;
@@ -21,8 +20,7 @@ public class BukkitPipelineInjector extends NettyPipelineInjector {
 
     @Override
     @NotNull
-    @SneakyThrows
     protected Channel getChannel(@NotNull TabPlayer player) {
-        return ((BukkitPlatform)player.getPlatform()).getImplementationProvider().getChannelFunction().apply((BukkitTabPlayer) player);
+        return ((BukkitPlatform)player.getPlatform()).getImplementationProvider().getChannel(((BukkitTabPlayer) player).getPlayer());
     }
 }

bukkit/src/main/java/me/neznamy/tab/platforms/bukkit/BukkitTabCommand.java

@@ -23,8 +23,8 @@ public class BukkitTabCommand implements CommandExecutor, TabCompleter {
     @Override
     public boolean onCommand(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String[] args) {
         if (TAB.getInstance().isPluginDisabled()) {
-            for (String message : TAB.getInstance().getDisabledCommand().execute(args, sender.hasPermission(TabConstants.Permission.COMMAND_RELOAD), sender.hasPermission(TabConstants.Permission.COMMAND_ALL))) {
-                sender.sendMessage(((BukkitPlatform)TAB.getInstance().getPlatform()).toBukkitFormat(TabComponent.fromColoredText(message)));
+            for (TabComponent message : TAB.getInstance().getDisabledCommand().execute(args, sender.hasPermission(TabConstants.Permission.COMMAND_RELOAD), sender.hasPermission(TabConstants.Permission.COMMAND_ALL))) {
+                sender.sendMessage(((BukkitPlatform)TAB.getInstance().getPlatform()).toBukkitFormat(message));
             }
         } else {
             TabPlayer p = null;

bukkit/src/main/java/me/neznamy/tab/platforms/bukkit/features/BukkitTabExpansion.java

@@ -3,10 +3,13 @@ package me.neznamy.tab.platforms.bukkit.features;
 import lombok.Getter;
 import me.clip.placeholderapi.PlaceholderAPI;
 import me.clip.placeholderapi.expansion.PlaceholderExpansion;
+import me.clip.placeholderapi.expansion.Relational;
+import me.neznamy.tab.api.placeholder.Placeholder;
 import me.neznamy.tab.shared.ProjectVariables;
 import me.neznamy.tab.shared.TAB;
 import me.neznamy.tab.shared.features.PlaceholderManagerImpl;
 import me.neznamy.tab.shared.placeholders.expansion.TabExpansion;
+import me.neznamy.tab.shared.placeholders.types.RelationalPlaceholderImpl;
 import me.neznamy.tab.shared.platform.TabPlayer;
 import me.neznamy.tab.shared.util.ReflectionUtils;
 import org.bukkit.entity.Player;
@@ -21,7 +24,7 @@ import java.util.List;
  * TAB's expansion for PlaceholderAPI
  */
 @Getter
-public class BukkitTabExpansion extends PlaceholderExpansion implements TabExpansion {
+public class BukkitTabExpansion extends PlaceholderExpansion implements TabExpansion, Relational {
 
     /** List of all placeholders offered by the plugin for command suggestions */
     @NotNull
@@ -95,11 +98,43 @@ public class BukkitTabExpansion extends PlaceholderExpansion implements TabExpan
             String requestedPlaceholder = "%" + identifier.substring("placeholder_".length()) + "%";
             PlaceholderManagerImpl pm = TAB.getInstance().getPlaceholderManager();
             pm.addUsedPlaceholder(requestedPlaceholder, pm);
-            return pm.getPlaceholder(requestedPlaceholder).getLastValue(p);
+            return pm.getPlaceholder(requestedPlaceholder).set(requestedPlaceholder, p);
         }
         return p.expansionValues.get(identifier);
     }
 
+    @Override
+    public String onPlaceholderRequest(@NotNull Player viewer, @NotNull Player target, @NotNull String identifier) {
+        if (identifier.startsWith("replace_")) {
+            String text = "%" + identifier.substring(8) + "%";
+            String textBefore;
+            do {
+                textBefore = text;
+                for (String placeholder : PlaceholderManagerImpl.detectPlaceholders(text)) {
+                    text = text.replace(placeholder, TAB.getInstance().getPlaceholderManager().findReplacement(placeholder,
+                            PlaceholderAPI.setRelationalPlaceholders(viewer, target, placeholder)));
+                }
+            } while (!textBefore.equals(text));
+            return text;
+        }
+        if (identifier.startsWith("placeholder_")) {
+            String requestedPlaceholder = "%" + identifier.substring("placeholder_".length()) + "%";
+            PlaceholderManagerImpl pm = TAB.getInstance().getPlaceholderManager();
+            pm.addUsedPlaceholder(requestedPlaceholder, pm);
+            Placeholder placeholder = pm.getPlaceholder(requestedPlaceholder);
+            if (placeholder instanceof RelationalPlaceholderImpl) {
+                RelationalPlaceholderImpl rel = (RelationalPlaceholderImpl) placeholder;
+                TabPlayer v = TAB.getInstance().getPlayer(viewer.getUniqueId());
+                TabPlayer t = TAB.getInstance().getPlayer(target.getUniqueId());
+                if (v == null || t == null) return "<Player is not loaded>";
+                return rel.getLastValue(v, t);
+            } else {
+                return "<Not a relational placeholder: " + requestedPlaceholder + ">";
+            }
+        }
+        return "<Unknown identifier: " + identifier + ">";
+    }
+
     @Override
     public void setPlaceholderValue(@NotNull TabPlayer player, @NotNull String placeholder, @NotNull String value) {
         // Do not unnecessarily do all placeholders, just retrieve them on request to save resources by not using string builder all the time

bukkit/src/main/java/me/neznamy/tab/platforms/bukkit/platform/BukkitPlatform.java

@@ -46,7 +46,10 @@ import net.milkbowl.vault.permission.Permission;
 import org.bstats.bukkit.Metrics;
 import org.bstats.charts.SimplePie;
 import org.bukkit.Bukkit;
-import org.bukkit.command.*;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.bukkit.command.PluginCommand;
+import org.bukkit.command.SimpleCommandMap;
 import org.bukkit.command.defaults.BukkitCommand;
 import org.bukkit.entity.Entity;
 import org.bukkit.entity.Player;
@@ -57,7 +60,7 @@ import org.jetbrains.annotations.Nullable;
 
 import java.io.File;
 import java.util.*;
-import java.util.function.Consumer;
+import java.util.function.BiConsumer;
 
 /**
  * Implementation of Platform interface for Bukkit platform
@@ -213,7 +216,7 @@ public class BukkitPlatform implements BackendPlatform {
     @Override
     @Nullable
     public PipelineInjector createPipelineInjector() {
-        return implementationProvider.getChannelFunction() != null ? new BukkitPipelineInjector() : null;
+        return serverVersion.getMinorVersion() >= 8 ? new BukkitPipelineInjector() : null;
     }
 
     @Override
@@ -293,7 +296,7 @@ public class BukkitPlatform implements BackendPlatform {
 
     @Override
     public void registerListener() {
-        Bukkit.getPluginManager().registerEvents(new BukkitEventListener(), plugin);
+        Bukkit.getPluginManager().registerEvents(new BukkitEventListener(this), plugin);
     }
 
     @Override
@@ -315,6 +318,7 @@ public class BukkitPlatform implements BackendPlatform {
                 () -> TAB.getInstance().getGroupManager().getPermissionPlugin()));
         String version = serverVersion == ProtocolVersion.UNKNOWN ? "Unknown" : "1." + serverVersion.getMinorVersion() + ".x";
         metrics.addCustomChart(new SimplePie(TabConstants.MetricsChart.SERVER_VERSION, () -> version));
+        metrics.addCustomChart(new SimplePie("tab_5_5_0_servers", serverVersion::getFriendlyName));
     }
 
     @Override
@@ -362,6 +366,11 @@ public class BukkitPlatform implements BackendPlatform {
         return true;
     }
 
+    @Override
+    public boolean supportsListed() {
+        return serverVersion.getNetworkId() >= ProtocolVersion.V1_19_3.getNetworkId();
+    }
+
     @Override
     public boolean supportsListOrder() {
         return serverVersion.getNetworkId() >= ProtocolVersion.V1_21_2.getNetworkId();
@@ -373,20 +382,20 @@ public class BukkitPlatform implements BackendPlatform {
     }
 
     @Override
-    public void registerCustomCommand(@NotNull String commandName, @NotNull Consumer<TabPlayer> function) {
+    public void registerCustomCommand(@NotNull String commandName, @NotNull BiConsumer<TabPlayer, String[]> function) {
         Command cmd = new BukkitCommand(commandName) {
 
             @Override
             public boolean execute(@NotNull CommandSender commandSender, @NotNull String alias, @NotNull String[] args) {
-                if (commandSender instanceof ConsoleCommandSender) {
+                if (commandSender instanceof Player) {
+                    TabPlayer p = TAB.getInstance().getPlayer(((Player) commandSender).getUniqueId());
+                    if (p == null) return false; //player not loaded correctly
+                    function.accept(p, args);
+                } else {
                     commandSender.sendMessage(toBukkitFormat(
                             TabComponent.fromColoredText(TAB.getInstance().getConfiguration().getMessages().getCommandOnlyFromGame())
                     ));
-                    return false;
                 }
-                TabPlayer p = TAB.getInstance().getPlayer(((Player) commandSender).getUniqueId());
-                if (p == null) return false; //player not loaded correctly
-                function.accept(p);
                 return false;
             }
         };

bukkit/src/main/java/me/neznamy/tab/platforms/bukkit/provider/ImplementationProvider.java

@@ -4,7 +4,8 @@ import io.netty.channel.Channel;
 import me.neznamy.tab.platforms.bukkit.BukkitTabPlayer;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -42,13 +43,22 @@ public interface ImplementationProvider {
     ComponentConverter<?> getComponentConverter();
 
     /**
-     * Returns a function that extracts Netty channel from the given player.
-     * If not supported in the version, returns {@code null}.
+     * Gets player's channel. If not available, returns {@code null}.
      *
-     * @return  Channel extractor function or {@code null} if not supported
+     * @param   player
+     *          Player to get channel of
+     * @return  Player's channel or {@code null} if not supported
      */
     @Nullable
-    FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction();
+    Channel getChannel(@NotNull Player player);
+
+    /**
+     * Creates a new instance of tab list entry tracker.
+     *
+     * @return  Newly created tab list entry tracker
+     */
+    @NotNull
+    TabListEntryTracker newTabListEntryTracker();
 
     /**
      * Returns ping of the given player.

bukkit/v1_10_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_10_R1/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_10_R1.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().playerConnection.networkManager.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().playerConnection.networkManager.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_10_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_10_R1/NMSPacketTabList.java

@@ -97,11 +97,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(newHeaderFooter(header, footer));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_10_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_10_R1/NMSTabListEntryTracker.java

@@ -0,0 +1,43 @@
+package me.neznamy.tab.platforms.bukkit.v1_10_R1;
+
+import com.mojang.authlib.GameProfile;
+import lombok.SneakyThrows;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import me.neznamy.tab.shared.util.ReflectionUtils;
+import net.minecraft.server.v1_10_R1.PacketPlayOutPlayerInfo;
+import net.minecraft.server.v1_10_R1.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+import java.lang.reflect.Field;
+import java.util.Arrays;
+import java.util.List;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final Field ACTION = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, EnumPlayerInfoAction.class);
+    private static final Field PLAYERS = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, List.class);
+    private static final Class<?> PlayerInfoData = Arrays.stream(PacketPlayOutPlayerInfo.class.getDeclaredClasses()).filter(c -> !c.isEnum() && c.getConstructors().length > 0).findFirst().get();
+    private static final Field PlayerInfoData_Profile = ReflectionUtils.getOnlyField(PlayerInfoData, GameProfile.class);
+
+    @Override
+    @SneakyThrows
+    @SuppressWarnings("unchecked")
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            EnumPlayerInfoAction action = (EnumPlayerInfoAction) ACTION.get(info);
+            for (Object nmsData : (List<Object>) PLAYERS.get(info)) {
+                GameProfile profile = (GameProfile) PlayerInfoData_Profile.get(nmsData);
+                if (action == EnumPlayerInfoAction.ADD_PLAYER) {
+                    tablistEntries.add(profile.getId());
+                }
+                if (action == EnumPlayerInfoAction.REMOVE_PLAYER) {
+                    tablistEntries.remove(profile.getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_11_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_11_R1/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_11_R1.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().playerConnection.networkManager.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().playerConnection.networkManager.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_11_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_11_R1/NMSPacketTabList.java

@@ -97,11 +97,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(newHeaderFooter(header, footer));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_11_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_11_R1/NMSTabListEntryTracker.java

@@ -0,0 +1,42 @@
+package me.neznamy.tab.platforms.bukkit.v1_11_R1;
+
+import com.mojang.authlib.GameProfile;
+import lombok.SneakyThrows;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import me.neznamy.tab.shared.util.ReflectionUtils;
+import net.minecraft.server.v1_11_R1.PacketPlayOutPlayerInfo;
+import net.minecraft.server.v1_11_R1.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+import java.lang.reflect.Field;
+import java.util.List;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final Field ACTION = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, EnumPlayerInfoAction.class);
+    private static final Field PLAYERS = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, List.class);
+    private static final Class<?> PlayerInfoData = PacketPlayOutPlayerInfo.class.getDeclaredClasses()[0];
+    private static final Field PlayerInfoData_Profile = ReflectionUtils.getOnlyField(PlayerInfoData, GameProfile.class);
+
+    @Override
+    @SneakyThrows
+    @SuppressWarnings("unchecked")
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            EnumPlayerInfoAction action = (EnumPlayerInfoAction) ACTION.get(info);
+            for (Object nmsData : (List<Object>) PLAYERS.get(info)) {
+                GameProfile profile = (GameProfile) PlayerInfoData_Profile.get(nmsData);
+                if (action == EnumPlayerInfoAction.ADD_PLAYER) {
+                    tablistEntries.add(profile.getId());
+                }
+                if (action == EnumPlayerInfoAction.REMOVE_PLAYER) {
+                    tablistEntries.remove(profile.getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_12_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_12_R1/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_12_R1.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().playerConnection.networkManager.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().playerConnection.networkManager.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_12_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_12_R1/NMSPacketTabList.java

@@ -97,11 +97,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(newHeaderFooter(header, footer));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_12_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_12_R1/NMSTabListEntryTracker.java

@@ -0,0 +1,42 @@
+package me.neznamy.tab.platforms.bukkit.v1_12_R1;
+
+import com.mojang.authlib.GameProfile;
+import lombok.SneakyThrows;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import me.neznamy.tab.shared.util.ReflectionUtils;
+import net.minecraft.server.v1_12_R1.PacketPlayOutPlayerInfo;
+import net.minecraft.server.v1_12_R1.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+import java.lang.reflect.Field;
+import java.util.List;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final Field ACTION = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, EnumPlayerInfoAction.class);
+    private static final Field PLAYERS = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, List.class);
+    private static final Class<?> PlayerInfoData = PacketPlayOutPlayerInfo.class.getDeclaredClasses()[0];
+    private static final Field PlayerInfoData_Profile = ReflectionUtils.getOnlyField(PlayerInfoData, GameProfile.class);
+
+    @Override
+    @SneakyThrows
+    @SuppressWarnings("unchecked")
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            EnumPlayerInfoAction action = (EnumPlayerInfoAction) ACTION.get(info);
+            for (Object nmsData : (List<Object>) PLAYERS.get(info)) {
+                GameProfile profile = (GameProfile) PlayerInfoData_Profile.get(nmsData);
+                if (action == EnumPlayerInfoAction.ADD_PLAYER) {
+                    tablistEntries.add(profile.getId());
+                }
+                if (action == EnumPlayerInfoAction.REMOVE_PLAYER) {
+                    tablistEntries.remove(profile.getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_13_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_13_R1/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_13_R1.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().playerConnection.networkManager.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().playerConnection.networkManager.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_13_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_13_R1/NMSPacketTabList.java

@@ -94,11 +94,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(newHeaderFooter(header, footer));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_13_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_13_R1/NMSTabListEntryTracker.java

@@ -0,0 +1,42 @@
+package me.neznamy.tab.platforms.bukkit.v1_13_R1;
+
+import com.mojang.authlib.GameProfile;
+import lombok.SneakyThrows;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import me.neznamy.tab.shared.util.ReflectionUtils;
+import net.minecraft.server.v1_13_R1.PacketPlayOutPlayerInfo;
+import net.minecraft.server.v1_13_R1.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+import java.lang.reflect.Field;
+import java.util.List;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final Field ACTION = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, EnumPlayerInfoAction.class);
+    private static final Field PLAYERS = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, List.class);
+    private static final Class<?> PlayerInfoData = PacketPlayOutPlayerInfo.class.getDeclaredClasses()[0];
+    private static final Field PlayerInfoData_Profile = ReflectionUtils.getOnlyField(PlayerInfoData, GameProfile.class);
+
+    @Override
+    @SneakyThrows
+    @SuppressWarnings("unchecked")
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            EnumPlayerInfoAction action = (EnumPlayerInfoAction) ACTION.get(info);
+            for (Object nmsData : (List<Object>) PLAYERS.get(info)) {
+                GameProfile profile = (GameProfile) PlayerInfoData_Profile.get(nmsData);
+                if (action == EnumPlayerInfoAction.ADD_PLAYER) {
+                    tablistEntries.add(profile.getId());
+                }
+                if (action == EnumPlayerInfoAction.REMOVE_PLAYER) {
+                    tablistEntries.remove(profile.getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_13_R2/src/main/java/me/neznamy/tab/platforms/bukkit/v1_13_R2/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_13_R2.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().playerConnection.networkManager.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().playerConnection.networkManager.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_13_R2/src/main/java/me/neznamy/tab/platforms/bukkit/v1_13_R2/NMSPacketTabList.java

@@ -94,11 +94,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(newHeaderFooter(header, footer));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_13_R2/src/main/java/me/neznamy/tab/platforms/bukkit/v1_13_R2/NMSTabListEntryTracker.java

@@ -0,0 +1,42 @@
+package me.neznamy.tab.platforms.bukkit.v1_13_R2;
+
+import com.mojang.authlib.GameProfile;
+import lombok.SneakyThrows;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import me.neznamy.tab.shared.util.ReflectionUtils;
+import net.minecraft.server.v1_13_R2.PacketPlayOutPlayerInfo;
+import net.minecraft.server.v1_13_R2.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+import java.lang.reflect.Field;
+import java.util.List;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final Field ACTION = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, EnumPlayerInfoAction.class);
+    private static final Field PLAYERS = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, List.class);
+    private static final Class<?> PlayerInfoData = PacketPlayOutPlayerInfo.class.getDeclaredClasses()[0];
+    private static final Field PlayerInfoData_Profile = ReflectionUtils.getOnlyField(PlayerInfoData, GameProfile.class);
+
+    @Override
+    @SneakyThrows
+    @SuppressWarnings("unchecked")
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            EnumPlayerInfoAction action = (EnumPlayerInfoAction) ACTION.get(info);
+            for (Object nmsData : (List<Object>) PLAYERS.get(info)) {
+                GameProfile profile = (GameProfile) PlayerInfoData_Profile.get(nmsData);
+                if (action == EnumPlayerInfoAction.ADD_PLAYER) {
+                    tablistEntries.add(profile.getId());
+                }
+                if (action == EnumPlayerInfoAction.REMOVE_PLAYER) {
+                    tablistEntries.remove(profile.getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_14_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_14_R1/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_14_R1.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().playerConnection.networkManager.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().playerConnection.networkManager.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_14_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_14_R1/NMSPacketTabList.java

@@ -94,11 +94,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(newHeaderFooter(header, footer));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_14_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_14_R1/NMSTabListEntryTracker.java

@@ -0,0 +1,42 @@
+package me.neznamy.tab.platforms.bukkit.v1_14_R1;
+
+import com.mojang.authlib.GameProfile;
+import lombok.SneakyThrows;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import me.neznamy.tab.shared.util.ReflectionUtils;
+import net.minecraft.server.v1_14_R1.PacketPlayOutPlayerInfo;
+import net.minecraft.server.v1_14_R1.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+import java.lang.reflect.Field;
+import java.util.List;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final Field ACTION = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, EnumPlayerInfoAction.class);
+    private static final Field PLAYERS = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, List.class);
+    private static final Class<?> PlayerInfoData = PacketPlayOutPlayerInfo.class.getDeclaredClasses()[0];
+    private static final Field PlayerInfoData_Profile = ReflectionUtils.getOnlyField(PlayerInfoData, GameProfile.class);
+
+    @Override
+    @SneakyThrows
+    @SuppressWarnings("unchecked")
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            EnumPlayerInfoAction action = (EnumPlayerInfoAction) ACTION.get(info);
+            for (Object nmsData : (List<Object>) PLAYERS.get(info)) {
+                GameProfile profile = (GameProfile) PlayerInfoData_Profile.get(nmsData);
+                if (action == EnumPlayerInfoAction.ADD_PLAYER) {
+                    tablistEntries.add(profile.getId());
+                }
+                if (action == EnumPlayerInfoAction.REMOVE_PLAYER) {
+                    tablistEntries.remove(profile.getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_15_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_15_R1/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_15_R1.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().playerConnection.networkManager.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().playerConnection.networkManager.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_15_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_15_R1/NMSPacketTabList.java

@@ -94,11 +94,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(newHeaderFooter(header, footer));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_15_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_15_R1/NMSTabListEntryTracker.java

@@ -0,0 +1,42 @@
+package me.neznamy.tab.platforms.bukkit.v1_15_R1;
+
+import com.mojang.authlib.GameProfile;
+import lombok.SneakyThrows;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import me.neznamy.tab.shared.util.ReflectionUtils;
+import net.minecraft.server.v1_15_R1.PacketPlayOutPlayerInfo;
+import net.minecraft.server.v1_15_R1.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+import java.lang.reflect.Field;
+import java.util.List;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final Field ACTION = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, EnumPlayerInfoAction.class);
+    private static final Field PLAYERS = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, List.class);
+    private static final Class<?> PlayerInfoData = PacketPlayOutPlayerInfo.class.getDeclaredClasses()[0];
+    private static final Field PlayerInfoData_Profile = ReflectionUtils.getOnlyField(PlayerInfoData, GameProfile.class);
+
+    @Override
+    @SneakyThrows
+    @SuppressWarnings("unchecked")
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            EnumPlayerInfoAction action = (EnumPlayerInfoAction) ACTION.get(info);
+            for (Object nmsData : (List<Object>) PLAYERS.get(info)) {
+                GameProfile profile = (GameProfile) PlayerInfoData_Profile.get(nmsData);
+                if (action == EnumPlayerInfoAction.ADD_PLAYER) {
+                    tablistEntries.add(profile.getId());
+                }
+                if (action == EnumPlayerInfoAction.REMOVE_PLAYER) {
+                    tablistEntries.remove(profile.getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_16_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_16_R1/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_16_R1.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().playerConnection.networkManager.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().playerConnection.networkManager.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_16_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_16_R1/NMSPacketTabList.java

@@ -94,11 +94,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(newHeaderFooter(header, footer));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_16_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_16_R1/NMSTabListEntryTracker.java

@@ -0,0 +1,42 @@
+package me.neznamy.tab.platforms.bukkit.v1_16_R1;
+
+import com.mojang.authlib.GameProfile;
+import lombok.SneakyThrows;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import me.neznamy.tab.shared.util.ReflectionUtils;
+import net.minecraft.server.v1_16_R1.PacketPlayOutPlayerInfo;
+import net.minecraft.server.v1_16_R1.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+import java.lang.reflect.Field;
+import java.util.List;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final Field ACTION = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, EnumPlayerInfoAction.class);
+    private static final Field PLAYERS = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, List.class);
+    private static final Class<?> PlayerInfoData = PacketPlayOutPlayerInfo.class.getDeclaredClasses()[0];
+    private static final Field PlayerInfoData_Profile = ReflectionUtils.getOnlyField(PlayerInfoData, GameProfile.class);
+
+    @Override
+    @SneakyThrows
+    @SuppressWarnings("unchecked")
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            EnumPlayerInfoAction action = (EnumPlayerInfoAction) ACTION.get(info);
+            for (Object nmsData : (List<Object>) PLAYERS.get(info)) {
+                GameProfile profile = (GameProfile) PlayerInfoData_Profile.get(nmsData);
+                if (action == EnumPlayerInfoAction.ADD_PLAYER) {
+                    tablistEntries.add(profile.getId());
+                }
+                if (action == EnumPlayerInfoAction.REMOVE_PLAYER) {
+                    tablistEntries.remove(profile.getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_16_R2/src/main/java/me/neznamy/tab/platforms/bukkit/v1_16_R2/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_16_R2.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().playerConnection.networkManager.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().playerConnection.networkManager.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_16_R2/src/main/java/me/neznamy/tab/platforms/bukkit/v1_16_R2/NMSPacketTabList.java

@@ -94,11 +94,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(newHeaderFooter(header, footer));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_16_R2/src/main/java/me/neznamy/tab/platforms/bukkit/v1_16_R2/NMSTabListEntryTracker.java

@@ -0,0 +1,42 @@
+package me.neznamy.tab.platforms.bukkit.v1_16_R2;
+
+import com.mojang.authlib.GameProfile;
+import lombok.SneakyThrows;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import me.neznamy.tab.shared.util.ReflectionUtils;
+import net.minecraft.server.v1_16_R2.PacketPlayOutPlayerInfo;
+import net.minecraft.server.v1_16_R2.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+import java.lang.reflect.Field;
+import java.util.List;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final Field ACTION = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, EnumPlayerInfoAction.class);
+    private static final Field PLAYERS = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, List.class);
+    private static final Class<?> PlayerInfoData = PacketPlayOutPlayerInfo.class.getDeclaredClasses()[0];
+    private static final Field PlayerInfoData_Profile = ReflectionUtils.getOnlyField(PlayerInfoData, GameProfile.class);
+
+    @Override
+    @SneakyThrows
+    @SuppressWarnings("unchecked")
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            EnumPlayerInfoAction action = (EnumPlayerInfoAction) ACTION.get(info);
+            for (Object nmsData : (List<Object>) PLAYERS.get(info)) {
+                GameProfile profile = (GameProfile) PlayerInfoData_Profile.get(nmsData);
+                if (action == EnumPlayerInfoAction.ADD_PLAYER) {
+                    tablistEntries.add(profile.getId());
+                }
+                if (action == EnumPlayerInfoAction.REMOVE_PLAYER) {
+                    tablistEntries.remove(profile.getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_16_R3/src/main/java/me/neznamy/tab/platforms/bukkit/v1_16_R3/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_16_R3.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().playerConnection.networkManager.channel;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().playerConnection.networkManager.channel;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_16_R3/src/main/java/me/neznamy/tab/platforms/bukkit/v1_16_R3/NMSPacketTabList.java

@@ -94,11 +94,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(newHeaderFooter(header, footer));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_16_R3/src/main/java/me/neznamy/tab/platforms/bukkit/v1_16_R3/NMSTabListEntryTracker.java

@@ -0,0 +1,42 @@
+package me.neznamy.tab.platforms.bukkit.v1_16_R3;
+
+import com.mojang.authlib.GameProfile;
+import lombok.SneakyThrows;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import me.neznamy.tab.shared.util.ReflectionUtils;
+import net.minecraft.server.v1_16_R3.PacketPlayOutPlayerInfo;
+import net.minecraft.server.v1_16_R3.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+import java.lang.reflect.Field;
+import java.util.List;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final Field ACTION = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, EnumPlayerInfoAction.class);
+    private static final Field PLAYERS = ReflectionUtils.getOnlyField(PacketPlayOutPlayerInfo.class, List.class);
+    private static final Class<?> PlayerInfoData = PacketPlayOutPlayerInfo.class.getDeclaredClasses()[0];
+    private static final Field PlayerInfoData_Profile = ReflectionUtils.getOnlyField(PlayerInfoData, GameProfile.class);
+
+    @Override
+    @SneakyThrows
+    @SuppressWarnings("unchecked")
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            EnumPlayerInfoAction action = (EnumPlayerInfoAction) ACTION.get(info);
+            for (Object nmsData : (List<Object>) PLAYERS.get(info)) {
+                GameProfile profile = (GameProfile) PlayerInfoData_Profile.get(nmsData);
+                if (action == EnumPlayerInfoAction.ADD_PLAYER) {
+                    tablistEntries.add(profile.getId());
+                }
+                if (action == EnumPlayerInfoAction.REMOVE_PLAYER) {
+                    tablistEntries.remove(profile.getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_17_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_17_R1/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_17_R1.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().b.a.k;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().b.a.k;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_17_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_17_R1/NMSPacketTabList.java

@@ -35,6 +35,7 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
     private static final EnumPlayerInfoAction UPDATE_GAME_MODE = EnumPlayerInfoAction.b;
     private static final EnumPlayerInfoAction UPDATE_LATENCY = EnumPlayerInfoAction.c;
     private static final EnumPlayerInfoAction UPDATE_DISPLAY_NAME = EnumPlayerInfoAction.d;
+    private static final EnumPlayerInfoAction REMOVE_PLAYER = EnumPlayerInfoAction.e;
 
     /**
      * Constructs new instance.
@@ -94,11 +95,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(new PacketPlayOutPlayerListHeaderFooter(header.convert(), footer.convert()));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_17_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_17_R1/NMSTabListEntryTracker.java

@@ -0,0 +1,30 @@
+package me.neznamy.tab.platforms.bukkit.v1_17_R1;
+
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import net.minecraft.network.protocol.game.PacketPlayOutPlayerInfo;
+import net.minecraft.network.protocol.game.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final EnumPlayerInfoAction ADD_PLAYER = EnumPlayerInfoAction.valueOf("ADD_PLAYER");
+    private static final EnumPlayerInfoAction REMOVE_PLAYER = EnumPlayerInfoAction.valueOf("REMOVE_PLAYER");
+
+    @Override
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            for (PacketPlayOutPlayerInfo.PlayerInfoData nmsData : info.b()) {
+                if (info.c() == ADD_PLAYER) {
+                    tablistEntries.add(nmsData.a().getId());
+                }
+                if (info.c() == REMOVE_PLAYER) {
+                    tablistEntries.remove(nmsData.a().getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_18_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_18_R1/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_18_R1.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().b.a.k;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().b.a.k;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_18_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_18_R1/NMSPacketTabList.java

@@ -35,6 +35,7 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
     private static final EnumPlayerInfoAction UPDATE_GAME_MODE = EnumPlayerInfoAction.b;
     private static final EnumPlayerInfoAction UPDATE_LATENCY = EnumPlayerInfoAction.c;
     private static final EnumPlayerInfoAction UPDATE_DISPLAY_NAME = EnumPlayerInfoAction.d;
+    private static final EnumPlayerInfoAction REMOVE_PLAYER = EnumPlayerInfoAction.e;
 
     /**
      * Constructs new instance.
@@ -94,11 +95,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(new PacketPlayOutPlayerListHeaderFooter(header.convert(), footer.convert()));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_18_R1/src/main/java/me/neznamy/tab/platforms/bukkit/v1_18_R1/NMSTabListEntryTracker.java

@@ -0,0 +1,30 @@
+package me.neznamy.tab.platforms.bukkit.v1_18_R1;
+
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import net.minecraft.network.protocol.game.PacketPlayOutPlayerInfo;
+import net.minecraft.network.protocol.game.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final EnumPlayerInfoAction ADD_PLAYER = EnumPlayerInfoAction.valueOf("ADD_PLAYER");
+    private static final EnumPlayerInfoAction REMOVE_PLAYER = EnumPlayerInfoAction.valueOf("REMOVE_PLAYER");
+
+    @Override
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            for (PacketPlayOutPlayerInfo.PlayerInfoData nmsData : info.b()) {
+                if (info.c() == ADD_PLAYER) {
+                    tablistEntries.add(nmsData.a().getId());
+                }
+                if (info.c() == REMOVE_PLAYER) {
+                    tablistEntries.remove(nmsData.a().getId());
+                }
+            }
+        }
+    }
+}

bukkit/v1_18_R2/src/main/java/me/neznamy/tab/platforms/bukkit/v1_18_R2/NMSImplementationProvider.java

@@ -7,8 +7,9 @@ import me.neznamy.tab.platforms.bukkit.provider.ComponentConverter;
 import me.neznamy.tab.platforms.bukkit.provider.ImplementationProvider;
 import me.neznamy.tab.shared.platform.Scoreboard;
 import me.neznamy.tab.shared.platform.TabList;
-import me.neznamy.tab.shared.util.function.FunctionWithException;
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
 import org.bukkit.craftbukkit.v1_18_R2.entity.CraftPlayer;
+import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -34,8 +35,14 @@ public class NMSImplementationProvider implements ImplementationProvider {
 
     @Override
     @NotNull
-    public FunctionWithException<BukkitTabPlayer, Channel> getChannelFunction() {
-        return player -> ((CraftPlayer)player.getPlayer()).getHandle().b.a.m;
+    public Channel getChannel(@NotNull Player player) {
+        return ((CraftPlayer)player).getHandle().b.a.m;
+    }
+
+    @Override
+    @NotNull
+    public TabListEntryTracker newTabListEntryTracker() {
+        return new NMSTabListEntryTracker();
     }
 
     @Override

bukkit/v1_18_R2/src/main/java/me/neznamy/tab/platforms/bukkit/v1_18_R2/NMSPacketTabList.java

@@ -35,6 +35,7 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
     private static final EnumPlayerInfoAction UPDATE_GAME_MODE = EnumPlayerInfoAction.b;
     private static final EnumPlayerInfoAction UPDATE_LATENCY = EnumPlayerInfoAction.c;
     private static final EnumPlayerInfoAction UPDATE_DISPLAY_NAME = EnumPlayerInfoAction.d;
+    private static final EnumPlayerInfoAction REMOVE_PLAYER = EnumPlayerInfoAction.e;
 
     /**
      * Constructs new instance.
@@ -94,11 +95,6 @@ public class NMSPacketTabList extends TrackedTabList<BukkitTabPlayer> {
         sendPacket(new PacketPlayOutPlayerListHeaderFooter(header.convert(), footer.convert()));
     }
 
-    @Override
-    public boolean containsEntry(@NonNull UUID entry) {
-        return true; // TODO?
-    }
-
     @Override
     @Nullable
     public Skin getSkin() {

bukkit/v1_18_R2/src/main/java/me/neznamy/tab/platforms/bukkit/v1_18_R2/NMSTabListEntryTracker.java

@@ -0,0 +1,30 @@
+package me.neznamy.tab.platforms.bukkit.v1_18_R2;
+
+import me.neznamy.tab.shared.platform.TabListEntryTracker;
+import net.minecraft.network.protocol.game.PacketPlayOutPlayerInfo;
+import net.minecraft.network.protocol.game.PacketPlayOutPlayerInfo.EnumPlayerInfoAction;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Implementation of TabListEntryTracker.
+ */
+public class NMSTabListEntryTracker extends TabListEntryTracker {
+
+    private static final EnumPlayerInfoAction ADD_PLAYER = EnumPlayerInfoAction.valueOf("ADD_PLAYER");
+    private static final EnumPlayerInfoAction REMOVE_PLAYER = EnumPlayerInfoAction.valueOf("REMOVE_PLAYER");
+
+    @Override
+    public void onPacketSend(@NotNull Object packet) {
+        if (packet instanceof PacketPlayOutPlayerInfo) {
+            PacketPlayOutPlayerInfo info = (PacketPlayOutPlayerInfo) packet;
+            for (PacketPlayOutPlayerInfo.PlayerInfoData nmsData : info.b()) {
+                if (info.c() == ADD_PLAYER) {
+                    tablistEntries.add(nmsData.a().getId());
+                }
+                if (info.c() == REMOVE_PLAYER) {
+                    tablistEntries.remove(nmsData.a().getId());
+                }
+            }
+        }
+    }
+}