How to assign players into groups

Content

• About
• Method 1: Primary group from permission plugin
• Method 2: Choosing from group list
• Method 3: Permission nodes

About

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

Methods 1 and 2 hook into your permission plugin and take groups from it. Therefore, your permission plugin must be supported. If your plugin is not supported, you can still use Method 3

Supported permission plugins on bukkit: LuckPerms and UltraPermissions directly, other plugins through Vault (if you're using PowerRanks, you must enable vault_permissions option in PowerRanks config).

Supported permission plugins on bungeecord: Luckperms, UltraPermissions and BungeePerms.

Method 1: Primary group from permission plugin

This is the default method. TAB will ask your permission plugin for player's primary group.

1. Put players into groups in your permission plugin (don't forget to configure weights - for luckperms /lp group <group> setweight <number>).

Method 2: Choosing from group list

TAB will ask your permission plugin for full list of groups a player is in and picks one based on your settings.

1. Go to config.yml and set use-primary-group: false
2. Put all groups from your permission plugin to primary-group-finding-list in order you want them to be picked. Out of player's groups the highest one in this list will be chosen as primary.

Method 3: 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).