Groups

Groups

A Group defines a set of tab-completion rules that are applied to players based on their permissions.

Each group lets you specify which commands should or shouldn't appear when a player presses tab. This helps keep certain commands hidden unless explicitly allowed.

---

Group Name

Each group is identified by a name and linked to a permission:

plhide.group.<name>

If a player has this permission, the group’s rules are applied to them.

Note: A default group will be used for players who don’t have any group assigned.
See Group Merging for more details.

---

TabComplete

This section defines the list of commands shown or hidden in tab-completion, depending on the group mode.

You can list commands like so:

tabcomplete:
  - "warp"
  - "msg"

Whether those commands are shown or hidden depends on whether the group is in whitelist or blacklist mode (explained below).

---

Sub-Argument Tab Completion

You can also control tab-completion for sub-commands (arguments after the command name).

• In whitelist mode, all sub-arguments are shown by default unless you specifically list them in the config.
  For example:

  - 'commandname test'

  This would only allow test as a sub-argument suggestion for /commandname.

• If a sub-argument is not listed, it will still appear in whitelist mode—unless the command is explicitly configured as above.

---

Group Modes

Group modes control how tab-completion entries are filtered. They are determined by player permissions:

• Players are in blacklist mode by default.
• Grant the permission plhide.whitelist-mode to switch a player to whitelist mode.

Blacklist Mode

• Behavior: Only hides the listed commands.

• Example:

  tabcomplete:
    - 'plugins'
    - 'pl'
    - 'ver'

  → plugins, pl, and ver commands will be hidden from tab-completion.

---

Whitelist Mode

• Behavior: Hides all commands except the ones listed.

• Example:

  tabcomplete:
    - 'spawn'
    - 'warp'

  → Only /spawn and /warp will appear in tab-completion.

---

Group Merging

Group merging is automatic and simple.

• The plugin checks which groups a player has (based on permissions).
• It merges all matching groups into one combined rule set.
• If the player has no groups, it will automatically assume they have the default group.
• All applicable tab-completion rules from those groups are applied together.

Tip: Always assign the default group to all players.

---

Default Groups Example

Here’s the default configuration:

groups:
  default:
    tabcomplete:
      - 'serverlistplus'
      - 'pl'
      - 'plugins'
      - 'version'
      - 'example1'
      - 'example2'

What this does:

• This group will apply to all players who do not have any specific group permission (like plhide.group.admin, etc.).
• It will hide the listed commands from tab-completion when players are in blacklist mode (which is the default mode).
• You can replace example1 and example2 with any other sensitive commands used on your server.

Reminder: When creating new groups, make sure all players have the plhide.group.default permission—either directly or through group inheritance.
That way, the default rules still apply even when players are part of other groups like admin, staff, or moderator.

---

Important Note

The plugin does not add commands to the tab list—it can only hide existing ones.
If a command isn’t already visible, listing it here won’t make it show up.