How to create a group - montlikadani/TabList GitHub Wiki

This site briefly describes the documentation for your groups, how to use it, and what to do if you have a minor problem.

First steps before doing anything in game

1) Groups requires Vault and some kind of permission plugin as a service provider to ensure the groups work properly.

2) Go to TabList/config.yml and set change-prefix-suffix-in-tablist to true

3) Type /tablist reload

4) Go to TabList/groups.yml and set groups. Or use commands to setup some prefix/suffix for your group.

Using commands to setup group

Setting prefixes/suffixes with command

There is an ability to make a group within this command. If you use /tl group <name> prefix "prefixHere ", then it will set the prefix for the given player and also it saves the given group name to the file.

Please refer to use meta-formatting page.

Setting groups.yml manually

Instead of the group name you can also type here player's name.

Example

groups:
  # An existing Vault group name OR custom group name (custom is assigned via permission)
  Default:
    prefix: "&7"
    tabname: "%player%"
    suffix: ""
    permission: tablist.default # Only needed if you don't use your permission plugin group names

  Admin:
    prefix: "%anim:Admin%"
    tabname: "%essentials_nickname%"
    suffix: "&7 <62>"

Per player prefixes

In order to display different prefix for specific player, you can specify a valid player name in the groups file following this example:

  PlayerName:
    prefix: "&a[MyGroup] &7"
    tabname: "%player%"
    suffix: ""
  player2:
    prefix: "&c"
    tabname: "%player%"
    suffix: ""

Replace the PlayerName with the player you want to assign an individual prefix.


The order of the groups matters

If a player has more than one group added, such as VIP and moderator, you want the moderator prefix to be visible. To do this, move the moderator at the bottom after the last group, or set a sort-priority value that the plugin will sort.

Example of demonstrating this

groups:
  VIP:
    prefix: "&a"
  moderator:
    prefix: "&3"

Or set priority for each group, please refer to this document how priorities are working.


If you are looking for luckperms or any other permissions plugin prefixes

You can use PlaceholderAPI placeholders, install your permission plugin expansion (if required), and after you can use that plugin placeholders, like we have luckperms and we using %luckperms_prefix%

The groups are not working?

  • Make sure you have configured correctly the tablist group permission to that permission system group if you have.
  • Make sure you not given the world name in restricted worlds where you are.
  • If you have LuckPerms, check if your groups have any weights set and change it to lower or remove from player.
  • Make sure there is no any conflict in your plugins with this tablist.
  • Players can have multiple parents (groups) set which causes to not display anything or repeatedly flickers prefixes. You need to disable prefer-primary-vault-group option in config.yml
⚠️ **GitHub.com Fallback** ⚠️