How to assign players into groups

Content

• About
• Option 1: Primary group from permission plugin
• Option 2: Permission nodes

About

TAB uses groups to assign properties (such as tabprefix) and sort players in tablist (if sorting by groups). You have 3 ways of configuring primary groups of players in TAB.

First option hooks into your permission plugin and takes groups from it. Therefore, your permission plugin must be supported.

Supported permission plugins on bukkit: LuckPerms and UltraPermissions directly, other plugins through Vault.

Supported permission plugins on bungeecord: Luckperms and UltraPermissions.

If your permission plugin is not supported, you can use Option 2.

There is 1 more way, however listing it here only confuses people and makes them use it while only following half of steps. It will be removed in the future and therefore is no longer documented.

Option 1: Primary group from permission plugin

This is the default method and recommended. TAB will ask your permission plugin for player's primary group.
Put players into groups in your permission plugin (don't forget to configure weights - for luckperms /lp group <group> setweight <number>).

Option 2: Permission nodes

None of the above worked or do you simply prefer permission nodes?

1. Go to config.yml and set assign-groups-by-permissions: true.
2. Give tab.group.<group name> permission to the user/permission group.
3. Put all possible groups into primary-group-finding-list. This is needed because:
   #1 - there's no way to get list of permissions of a player, only checking for a permission. The list will be used for list of permissions to check for.
   #2 - if a player has permission for more than one group, the list will be used to pick the correct one (the one higher in the list).

Don't forget that OP = all permissions! That's the whole point of OP function. To grant all permissions. In that case, you need to negate permissions in your permission plugin for other groups which are higher than player's wanted group (depending on your permission plugin it can be achieved using -tab.group.groupname or setting the permission value to false).