neznamy/tab

"That" TAB plugin.

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? wiki page.

Download

Releases

You can download full releases from GitHub releases, SpigotMC, Modrinth or BuiltByBit.

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 (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. This includes a detailed description of all features, as well as information regarding compatibility or limitations of each feature.

Issues

The 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

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 updates1	✔
Feature requests	❌
Customer support2	✔
Free user support3	❌*
Optimization4	✔

¹ - Adding new examples, guides and other kind of useful information people ask about.
² - Unrestricted assistance with the plugin for those, who bought a copy of the plugin when it was purchasable.
³ - Unlimited access to my free time for everyone in the world.
⁴ - Improving plugin's performance while not losing out on any features. This was done proactively a lot in the past, so there isn't much to do anymore, only if someone actually finds and reports something.

*Instead, you can use this fresh new community discord made by a nice person who will provide this service.

tab's Issues

[Unlimited nametags] Desynced when riding boats

Unlimited nametag mode's armor stands are out of sync when player is riding boats due to movement packets (or just the animation) being delayed while position on server side is not. I don't see a way to fix this anytime soon.

Add MySQL support

having the custom tag/prefix info in the same file as the config is a bad idea for servers, config will be big and unbearable!
toss it into a separate file or add mysql support

%staffonline% to use permissions also instead of groups.

Sorting by permission is perfect but if you could add a feature allowing the %staffonline% to use permissions also instead of groups.

For example, if I give myself tab.sort.owner then I should be counted as an online staff member, because in the config Owner is listed under the staff groups section.

It shouldn't show this suffix to nametag

Server version: 1.13.2 (PaperSpigot)

Plugin version: 2.5.0

Describe the bug:
As we can see here, the plugin add "Unknow translat" to the name tag of a player (It should be just ADMIN KCVault).

Tab/tag suffix regression

Server version
1.13.2

Plugin version ("latest" is not a version)
2.5.2

Describe the bug
%vault-suffix% seems to be using the value for %vault-prefix%.

How to teproduce
TAB config section:

  _OTHER_:
    tabprefix: "%vault-prefix%"
    tagprefix: "%vault-prefix%"
    tabsuffix: "%vault-suffix%%afk%"
    tagsuffix: "%vault-suffix%%afk%"
    customtabname: "%essentialsnick%"
    customtagname: "%essentialsnick%"
    belowname: "&c%health%❤"

GroupManager group config section:

  Dev:
    default: false
    permissions: []
    inheritance:
    - op
    info:
      prefix: '&9&lDev &9'
      build: true
      suffix: ''

Expected behavior
[groupmanager-prefix][playername][groupmanager-suffix][afk]

Actual behavior

Additional info (errors, screenshots, ...)

SuperVanish placeholder

I want placeholder to show nothing if user is not vanished and &7[V] if user IS vanished.
I tried %supervanish_isvanished% but that just shows "No" all the time.

Nametag doesn't add colour (if player hasn't moved when they received the rank)

Server version
PaperSpigot 1.8.8

Plugin version ("latest" is not a version)
2.5.2

Describe the bug
Nametag (abovename by the looks of it, I don't use belowname) will not add colour and will only show the colour tags (I.E. &4) in white text.

How to reproduce

1. Make sure you have a group which has colour in it's abovename:
2. Put the user in the group which has the abovename:
3. Reload the plugin
4. Remove them from the group
5. Add them back to the group

Expected behavior
Imgur

Actual behavior
Imgur

Additional info (errors, screenshots, ...)
Screenshots taken on Optifine Client 1.8.9

Sort alphabetically when not sorting by rank

Hello, my server involves a gamemode where one player has a secret rank for a week. I also like having the server's staff sorted at the top. Under the "group-sorting-priority-list:", I have only listed the four staff ranks as what I want sorted. Ideally, those who do not fall within these four ranks get sorted alphabetically. However, ranks not specified in the priority list are still getting sorted by rank, resulting in the secret rank potentially not being such a secret. The workaround for now is to just have the entire list sorted alphabetically, but it would be nice if I could stick with the rank-based sorting without having non-specified ranks be sorted.

LibsDisguise compatibility hook.

Would it be possible to add a compatibility hook for LibsDisguise so you can still show TAB nametags above your head when you are disguised as a mob? Currently your name just turns white when disguising and back to normal when undisguising.

Error occured when processing packetOUT

Minecraft Server: Paper 1.12.2
Tab: v2.4.15
Error: https://paste.ubuntu.com/p/d3tzy8yhjq/

"belowname" text doesn't follow the player.

Server version
1.14.4

Plugin version ("latest" is not a version)
2.5.1

Describe the bug
"belowname" text stays on the sites without following the player.

How to teproduce
I don't know how to reproduce it.

Expected behavior
"belowname" text following the player.

Actual behavior
"belowname" text stays on the sites without following the player.

Additional info (errors, screenshots, ...)
https://i.imgur.com/LsglOfj.png

Unlimited Prefix/Suffix removes name on Tamed Dogs

Server version
1.12.2

Plugin version ("latest" is not a version)
2.5.0

Describe the bug
Dogs can be named untamed, but not tamed.

How to reproduce
Name a dog, tame it, name goes away.

Expected behavior
Name is supposed to stay

Actual behavior
Name disappears and you can't name it.

Additional info (errors, screenshots, ...)
No errors

Add option to have fake player slots for organizing player list

So in tablist have a option where there is two columns: one for staff and another for players. You can choose which groups are staff and displayed under the staff column.

Tab is not recognizing users from different groups across servers.

Server version
BungeeCord 1.14.4
Survival: 1.14.4
Skyblock: 1.14.2
Hub: 1.14.4

Plugin version ("latest" is not a version)
2.4.15 on all servers, not on BungeeCord.

Describe the bug
I am using UltraPermissions on Bungeecord and I have groups on specific servers. My skyblock has some groups and my survival has some other groups. If a player buys a rank on skyblock they only get it on skyblock. When they log onto skyblock their name in tab will change color to show the rank they purchased. If they switch over to another server, it still shows the same rank color not the rank color from their current server.

How to reproduce
Add a player to a group on one server and then have them switch servers.

Expected behavior
Use the %rank% value for the rank that is actually on the server.

Actual behavior
Uses the %rank value from the server which they have the highest rank on.

Additional info (errors, screenshots, ...)
None.

No Decimal Formatting

There is a date format option (date-format:) and a time format option (time-format:) but there is no decimal/numerical format option :( At least that i can see so when displaying a players health from PlaceholderAPI in the belowname tag sometimes this happens.

Maybe add some way to format that down to 18.76 (of course rounding to the nearest)

Armor Stands laggy when sprinting

I have no idea why or how to fix it.
Video: https://streamable.com/h8mqf

[Unlimited nametags] Not compatible with disguise plugins

Disguised player has two nametags, his own + armor stands added by the plugin.

Vanilla undername

Hi everyone, I want to say first off, I love the plugin and it's capabilities. I would like to request the ability to use the vanilla undername feature, as it doesn't use armor stands to update where the player's name tag is.

The reason I'm requesting this is: when players are flying or spam crouch, the armor stands bug out and don't keep up perfectly.

If you used the vanilla way to display a number and a word underneath a player's name it keeps up and displays perfectly, no bugging.

vanilla belowname does not work if unlimited-nametag-mode is enabled

Server version
1.12

Plugin version ("latest" is not a version)
2.5.3

Describe the bug
The vanilla belowname does not work if unlimited-nametag-mode is enabled in the config ^^

How to reproduce
Enable unlimited-nametag-prefix-suffix-mode

Expected behavior
the vanilla belowname is just disabled even when there is no custom belowname

Thanks for your help ^^

Bug with unlimited prefix and mod for displaying nicknames and prefixes for creatures

Server version
1.12

Plugin version ("latest" is not a version)
2.5.1

Describe the bug
I turned on the experimental mode for unlimited prefix characters, everything works fine, the prefix is displayed as it should, but in creature nicknames everything is displayed the same way as without this mode

How to teproduce
Just install the Neat mod, put a long prefix (for example: Administrator), turn on the unlimited number of characters in the prefix mode and you will see that in the Neat mode, it is displayed as well as without the mode

Expected behavior
I do not know what to write here :p

Actual behavior
And here too :(

Additional info (errors, screenshots, ...)
screenshot: https://prnt.sc/p6wfxr

Command not working when SimpleAPI plugin is installed

SimpleAPI overrides /tab command because it registers it too early, which would be unsafe to match.

Add 1.7.10 Via Rewind Support.

Hello,

I was wondering if you could add some sort of 1.7.10 support. Any chance of this? I used Via Version and Via Rewind.

Thanks!

Comments disappearing from config files

Whenever plugin modifies a file (adding variable, modifying value) all comments disappear from it.

Empty above name visible

Server version
1.13.2

Plugin version ("latest" is not a version)
2.5.3-pre2

Describe the bug
An empty background is visible in the above player name slot when relational placeholders are evaluated to an empty string for this position (may affect other positions too, didn't test).

How to teproduce
Set above name to a relational placeholder which evaluates to an empty string.

Expected behavior
The above name line should be completely invisible.

Actual behavior
The above name line has an armour stand with an empty name string.

Additional info (errors, screenshots, ...)

Permissions EX bug

07.09.2019 - 14:15:59 - [TAB v2.5.1] An error occured when setting placeholders(2) (player=Pericol123, online=true)
07.09.2019 - 14:15:59 - ru.tehkode.permissions.exceptions.PermissionsNotAvailable: Permissions manager is not accessable. Is the PermissionsEx plugin enabled?
07.09.2019 - 14:15:59 - at ru.tehkode.permissions.bukkit.PermissionsEx.getPermissionManager(PermissionsEx.java:405)
07.09.2019 - 14:15:59 - at net.milkbowl.vault.chat.plugins.Chat_PermissionsEx.getUser(Chat_PermissionsEx.java:108)
07.09.2019 - 14:15:59 - at net.milkbowl.vault.chat.plugins.Chat_PermissionsEx.getPlayerPrefix(Chat_PermissionsEx.java:292)
07.09.2019 - 14:15:59 - at net.milkbowl.vault.chat.Chat.getPlayerPrefix(Chat.java:91)
07.09.2019 - 14:15:59 - at me.neznamy.tab.bukkit.Placeholders.replaceSimplePlaceholders(Placeholders.java:151)
07.09.2019 - 14:15:59 - at me.neznamy.tab.bukkit.Placeholders.replace(Placeholders.java:106)
07.09.2019 - 14:15:59 - at me.neznamy.tab.shared.Placeholders.replace(Placeholders.java:123)
07.09.2019 - 14:15:59 - at me.neznamy.tab.shared.Placeholders.replaceMultiple(Placeholders.java:101)
07.09.2019 - 14:15:59 - at me.neznamy.tab.shared.ITabPlayer.updateTeamPrefixSuffix(ITabPlayer.java:348)
07.09.2019 - 14:15:59 - at me.neznamy.tab.shared.ITabPlayer.updateTeam(ITabPlayer.java:110)
07.09.2019 - 14:15:59 - at me.neznamy.tab.shared.NameTag16$1.run(NameTag16.java:22)
07.09.2019 - 14:15:59 - at me.neznamy.tab.shared.Shared$2.run(Shared.java:149)
07.09.2019 - 14:15:59 - at java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source)
07.09.2019 - 14:15:59 - at java.util.concurrent.FutureTask.run(Unknown Source)
07.09.2019 - 14:15:59 - at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source)
07.09.2019 - 14:15:59 - at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source)
07.09.2019 - 14:15:59 - at java.lang.Thread.run(Unknown Source)

Vanished players (moderators) can be seen because of their plate

Server version

Plugin version ("latest" is not a version) : 2.5.2

Expected behavior
Players tags shouldn't be seen when vanished

Actual behavior
Players can see them, screenshot ->

Additional info (errors, screenshots, ...)
https://media.discordapp.net/attachments/614102652615393283/626053914277576715/unknown_6.png?width=1086&height=611

add TABS to PAPI

you have papi support but there's no papi placeholder available.
trying to make a gui using Deluxe Menu but want the current tag to be highlighted... need to be able to check player tag pre/suffix to do that

Add Server's Uptime

that would be really awesome

Override world names

Like you do for ranks, add the ability to set a list of alternative names for worlds, which could be used in the placeholder %player_world% and so for example, instead of having "world_the_end" it could be renamed "End" or "Moon" or whatever.

Permission based suffix/prefix

What would i want?
The ability to give groups a permission so that the permission can be used to define who gets the specified prefix/suffix.
Why could this be usefull?
For larger networks it is hard to manage the suffixes and prefixes of all the different ranks available. And with permission support you can copy paste the config file in each server and use the permissions to disable a group that should only be on 1 server and not on the whole netwerk.
Also with MySQL support there could be a table like tag_groups for example with a structure like this: http://prntscr.com/padgsg (But then with the correct properties for all the different options.)
With those 2 features you can make it a whole lot easier to manage the prefixes and suffixes on a server.
How could it be added?
It could be added just by adding a line for use-mysql: true/false in the advancedconfig and by having a mysql credentials spot in the same config file.

Pets Names

Server version - 1.14.4

Plugin version - 2.5.0

Describe the bug - Pretty much when I upgraded to tab v2.5.0 pet nametags have the prefix of the owner, but i tested it with version tab v2.4.15 and it removed the prefix. I also have fixed pet names set as true in advancedconfig.

Additional info
Version 2.5.0 - http://prntscr.com/opxxi2
Version 2.4.15 - http://prntscr.com/opxzqx

space between prefix and the name in the nametag

Hello ^^
Can you add more space between prefix (above name) and the name in the nametag please ? Or just allow to change the default space

Thanks for your help ^^

Showing incorrect ping value

Server version
1.13.2

Plugin version ("latest" is not a version)
2.4.11

Describe the bug
it shows 500ms up to 2000ms, for players who join the server
( it will show their actual ping after 2minutes )
as an example, i'm having 1500 ping, and every 20 or maybe 30 seconds it'll start to update
from 1500ms -> 1300ms -> 1200ms -> 900ms -> 500ms -> 200ms ( until it reaches 34ms which is my stable or actual ping )

Expected behavior
Showing correct ping

Actual behavior
Showing incorrect ping value/display,

Thank you!

Additional info (errors, screenshots, ...)

Scoreboard

You're TAB list is already incredible. I barely know any non-paid scoreboard plugins that are high quality. As in they're laggy and such. It would be amazing if you added a scoreboard feature. I know that is not what this plugin is about, let alone the title, but I think it would be really cool to see this for people like me.

Add option to show all players on bungee

Bungee version needs a feature to show all players from all servers instead of just the player's current server.

Not all Staff are shown in the staff count

Server version 1.14.4 Paper

Plugin version ("latest" is not a version) 2.5.1

Describe the bug I have Staff "Owner" Headadmin" "helper" "Builder" the Builders and helpers are not showing in the staff count they are added in "staff-groups:" we have removed and added back in all groups and only Owner and Headadmin show in staff count

How to teproduce Just in Tab "Online Staff"

Expected behavior Helpers and builders not included in this count

Actual behavior Doesnt count staff as staff?

Additional info (errors, screenshots, ...)

Compatibility with LibsDisguises

The current TAB plugin completely overrides hitboxes with its features. I disabled the hitbox control in TAB, which effectively fixed LibsDisguises (the mob you're disguising as's hitbox trying to get into your hitbox), but now everyone is a ghost when they aren't disguised, and able to walk through one another.

Would it be possible to request 1.14.4 TAB support with LibsDisguises?

Disable features bug

Server version
PaperSpigot 1.8.8 latest

Plugin version ("latest" is not a version)
TAB v2.5.2

Describe the bug
I have a list that indicates what worlds have to be disabled NameTag and TablistNames. It doesnt disables on that world but when i go to the lobby it applies the disabled nametag and tablist-feature.

How to teproduce

Expected behavior

Actual behavior

Additional info (errors, screenshots, ...)
https://imgur.com/6bVB09j (config)
https://imgur.com/oKw7Kcp (world that has to be disabled the features named before) this world is PlayCraft
https://imgur.com/LZhU9z7 (when you go back to the lobby) This world is SkyWarsLobby

Remove [] from tab/tag if condition. help to Simpleclans

Hello in another plugin called ultimatechat [chat plugin] there is an option to remove certain strings from the chat, to avoid the simple brackets appearing in simpleclan if the player has no clan. Like u can see on [] comonier example

It's just an idea, but it would be super interesting to have this tab / tag option after all your plugin is the best plugin in the world. With this option would be even better!

Below I have favored to copy and paste the config from another plugin that removes these characters from chat so you have an idea to adapt in TAB Reborn config:

# Remove this from chat (like empty tags)

remove-from-chat:

- '[]'

- '&7[]'

- '&7[&7]'

The letter K gets sorted last.

Server version
Paper git-Paper-175

Plugin version ("latest" is not a version)
v2.5.0

Describe the bug
The letter K is sorted alphabetically after the rest of the letters.

How to teproduce
Have a bunch of players logged in simultaneously, choose the setting to sort by nickname, and those with names beginning with "k" will be at the bottom.

Expected behavior
k usernames get sorted between j and l.

Actual behavior
k usernames are at the bottom.

Additional info (errors, screenshots, ...)

Bug with holder (over head)

Plugin ver: 2.5.2
Server version: SPIGOT 1.11-R1

We updated the plugin to version 2.5.2, but often a bug began to occur with text above the players head. Some players for some reason have 2 names, one from the minecraft itself, and the other from the plugin. If such a player gets into the boat, he will receive only a vanilla (minecraft) holder. Also, their names in the tab rise.

PlaceHolderApi is also used for belowname and abovename.

Sponge [feature request]

+1 xD
love the plugin btw its amazing, would love sponge support too :)

Enable Parts Of Unlimited Nametag Mode

Yeah I Was Wondering If You Could Add An Option To Only Enable Certain Parts Of Unlimited Nametag Mode Like If We Wanted To Use The Vanilla Nametag But Still Wanted BelowName Or AboveName

Remove a player from the tab list

How would I make a player invisible in the tab list? If it's not currently possible I would like this added as a feature. Would like the option to hide players based on a permission node or if they are invisible in essentials/CMI.

In-game datapack statistics

Unless spigot does it, this plugin messes up the displaying objective I tell it to show in-game from a datapack. The objective I have it show so Im able to edit it when neccessary is in tab and once the server restarts it shows something like 346 instead of 0. This is with paperspigot 1.14.4. and datapack track raw statistics from Xisumavoid.

Health Below Players Name

Hey! would be cool if you could add a feature that does something like this
https://user-images.githubusercontent.com/53785299/63692771-53a41080-c80a-11e9-80ab-883767a52b0b.png

Maven Support

Hello! After having several issues with so many other plugins, I've been trying to use your API in our core development. However, since your project is not hosted on maven, we are unable to use it in our projects.

Would it be possible to convert to maven? (We've tried self hosting and it doesn't appear to work :/)

PlaceholderAPI placeholders aren't parsed when running on a Bungee instance

Server version
Waterfall (build 295) and BungeeCord (build 1420)

Plugin version ("latest" is not a version)
2.5.2, running alongside PAPI version 2.10.3
Also tested on 2.5.3-pre13

Describe the bug
When running on a Spigot or Paper server, PAPI placeholders work perfectly fine, but when running on a Bungee or Waterfall (Paper's fork of Bungee) server, they aren't parsed at all, instead the errors.txt file is flooded with stack traces related to analysing packets (on non-prerelease versions). This happens when a player joins the server.

Initially I had moved the plugin and config files from my survival server to my Waterfall server since the plugin was originally running on survival and I figured it'd be better letting Waterfall handle the tablist globally. My original config was somewhat out of date so I deleted it to start fresh with a new file, but the issue still persists.

Checking on Discord I saw an issue related to Bungee that was fixed in a recent prerelease. I tested 2.5.3-pre13 and although I no longer see a flood of stacktraces in the logs now, placeholders still aren't being parsed properly it seems.

How to reproduce
Install TAB onto a BungeeCord or Waterfall server, insert any PAPI placeholder in the config, connect to the server and observe.

Expected behavior
Placeholders should be parsed, just like they would if TAB was running on a standalone server

Actual behavior
PAPI placeholders aren't being parsed

Additional info (errors, screenshots, ...)
Example config.yml: https://gist.github.com/Apocalypsing/cb7de8b4bfd37be9a7f82f00bcedaccd

add gui for selecting possible name tag to display

would be nice to have a GUI that players can select from Current Rank, any custom one made by the server or NONE. and it would show the current tag in the title of the menu

Separate unlimited nametag prefix and suffix

Can you separate the unlimited nametag prefix and the unlimited nametag suffix please ? ^^
Like that, only the prefix is in armorstand and the nickname stay normal :)

(Or you can just keep the normal nickname when the vanilla belowname feature is enabled)

Thanks for your help ^^