Skip to main content

​
Group Condition

The Group condition allows you to create placeholders that display different text based on a player’s group from a permissions plugin.

​
Overview

This condition is perfect for creating rank-based placeholders that integrate with permission systems like LuckPerms, GroupManager, or other Vault-compatible permission plugins.
This condition requires Vault and a permissions plugin like LuckPerms.

​
Configuration

To create a group condition, set the type to GROUP and provide the group name as the value.

​
Basic Example

How it works:
  • Players not in “ExampleGroup” see: “Default”
  • Players in “ExampleGroup” see: “Example condition text”

​
Real-World Examples

​
Rank-Based Placeholder

​
Staff Status

​
Donor Tiers

​
Priority System

Remember that conditions are evaluated in order. If a player is in multiple groups, the first matching condition will be used. Example:
If a player is in both “admin” and “moderator” groups, they’ll see “Administrator” because it’s listed first.

​
Combining with Other Conditions

You can combine group conditions with permission, money, or item conditions:

​
Group Name Matching

The group name must match exactly as it appears in your permissions plugin. Group names are case-sensitive. Example:
  • If your group is “VIP” (uppercase), use value: "VIP"
  • If your group is “vip” (lowercase), use value: "vip"

​
Best Practices

  1. Use consistent naming - Follow your permissions plugin’s group naming conventions
  2. Order by priority - Place higher priority groups first in your condition list
  3. Test with your permission plugin - Make sure group names match exactly
  4. Combine with other conditions - Use group conditions alongside permission or money conditions for complex logic

​
Troubleshooting

Q: The condition isn’t working
A: Make sure:
  • Vault is installed and enabled
  • A permissions plugin (like LuckPerms) is installed and configured
  • The permissions plugin is properly connected to Vault
  • The group name matches exactly (case-sensitive)
  • Players are actually in the specified group
Q: Multiple groups not working
A: Remember that only the first matching condition is used. If a player is in multiple groups, prioritize them in your configuration.