Skip to content

Frequently Asked Questions

NEZNAMY edited this page Dec 1, 2024 · 105 revisions

Content

#1 - Why are NPCs showing up in the tablist?

See Citizens FAQ.

#2 - How to make TAB work with LuckPerms?

#3 - I enabled MySQL, and my prefix is now gone!

When enabling MySQL, it will be used as a data storage and groups.yml / users.yml files will no longer be used.
If you want to upload your configuration to MySQL (or download it back to files), use MySQL conversion commands - /tab mysql upload and /tab mysql download, respectively.
After you are done, run /tab reload for the changes to take effect.

#4 - Why is player sorting not working?

See Common mistakes section on sorting page.

#5 - How to add players to the %staffonline% placeholder?

Give them the tab.staff permission.

#6 - How to make player heads visible in tablist?

Players who did not buy the game will never be able to see heads. The client displays Player heads when connection to the server is an online connection authenticated through Mojang. It cannot be directly controlled by plugins. The intended way to reach this is by setting online-mode=true in server.properties.
If you want to allow pirates on your server, you can still display heads for players who bought the game by changing their connections to online connections. Most commonly used plugins for this are FastLogin and JPremium, which change connections of premium players who enabled it to online connections.
The same goes for disabling heads - you cannot disable them if you have online mode enabled.

#7 - Where can i find current default config files?

You can do any of the following:

  • Check the source code.
  • Delete or rename a file, and the plugin will regenerate it.
  • Open the plugin jar as a zip file and take files from there.

#8 - How can I split players into multiple columns?

The client puts players into columns, it is not managed by the server. The only way is to get more players. They automatically split into more columns at 21, 41 and 61 players (due to limit of 20 entries per column). If you don't mind getting all 80 slots filled with fake player slots, check out the Layout feature.

#9 - How to use spaces in prefix/suffix command?

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.

#11 - Placeholder is not working

Most common reasons for a placeholder to not work include:

The full list of reasons can be found on the Placeholders 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.

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'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 and use your desired symbol directly.

Option 2: Find hex code of your symbol (4 hexadecimal numbers) and use \uxxxx format, where xxxx is hex code of the symbol.
Make sure to also wrap the text into "" for the text to properly take \ as an escape symbol. Using '' will result in the text being display literally, not as a code.

Note: Minecraft does not support every single UTF symbol and displays unsupported symbols as a box. You can try sending your symbol into chat and see if it works or not. If not, it's not supported by MC.

#14 - Is there a way to remove all players from tablist?

For a player to be visible in game, they must be in the tablist as well. Remember the NPC in tablist issue? If you don't mind players not appearing in the game, get a plugin that hides all players. If you want to see them in the game, however, your only choice is to put a lot of empty lines into header, which will push all players out of the screen.

#15 - How to add images to tablist?

You can check out this reddit post. When using the symbol in configuration using \u format, remember to use "" in config instead of ''.

#16 - Is MiniMessage supported?

Kind of. MiniMessage support is included; however, this doesn't mean it is guaranteed to work. Here are a few reasons why it may not work for you:

  • MiniMessage library must be included in your server software. TAB does not include this library.
    • It is included in Paper 1.16.5 and higher, Velocity and Sponge 8.
    • It is not included in Spigot, any server software for 1.16.4 and lower, BungeeCord (and any of its forks), Sponge 7 and Fabric.
  • You may not use any legacy color codes (&) in the text where you want MiniMessage support. If you use them, MiniMessage parser will throw an error. Therefore, if trying to use both legacy colors and MiniMessage syntax, MiniMessage syntax will not work.
  • A plugin/mod might be shading an outdated/incomplete version of Adventure without relocating it, and java class loader might make TAB use the wrong source of the duplicated library.

This list is not final. There might still be other reasons why MiniMessage won't work for you, which are not known yet. If you believe MiniMessage should be supported on your server but doesn't work, open a bug report.

#17 - Is it possible to show the number of players in a specific group, similar to staffonline placeholder?

The plugin's internal placeholders are limited, and this kind of functionality is not included. However, you can achieve this using PlaceholderAPI's PlayerList expansion and following this example.

#18 - Why is the plugin flagged as a virus by Windows defender?

First, this is a false positive. Here's a spigot thread confirming it.

After experimenting with VirusTotal, it turns out the antivirus software available on the website used flags bStats library as malicious. Its purpose is to collect anonymous data about servers and submitting it to bStats.org, where plugin authors can see how many servers use their plugins (if they don't disable it). It also checks for CPU and OS types, which could be the reason for the false positive. Here is one of TAB's pages as an example.

Windows defender could be flagging it for the same reason.

Clone this wiki locally