Groups

Groups are collections of permissions that can be assigned to players. Instead of managing permissions for each player individually, you assign players to groups and manage permissions at the group level.

What are Groups?

A group is a named collection of:

  • Permissions - What members of this group can do
  • Parents - Other groups whose permissions are inherited
  • Metadata - Display name, prefix, suffix, weight

Common group examples:

text
Default   - All new players start here
VIP       - Donors with extra perks
Helper    - Staff in training
Moderator - Staff who can moderate
Admin     - Full server administrators
Owner     - Server owner with all permissions

Group Properties

Name

The internal identifier for the group. Must be unique and is used in commands. Use lowercase letters without spaces.

text
Good: default, vip, moderator, senior-mod
Bad: VIP Players!, My Cool Group, rank 1

Display Name

A human-readable name for the group, shown in the web editor and info commands. Can include spaces and capitalization.

text
/hp group setdisplayname moderator "Server Moderator"
/hp group setdisplayname vip "VIP Member"

Weight

A number that determines the group's priority. Higher weight = higher priority.

  • Used to determine prefix/suffix display order
  • Affects inheritance resolution when there are conflicts
  • Typically ranges from 0-100
text
/hp group setweight default 0
/hp group setweight vip 20
/hp group setweight mod 50
/hp group setweight admin 90
/hp group setweight owner 100

Learn more in the weight guide.

Prefix

Text displayed before the player's name in chat. Supports color codes.

text
/hp group setprefix admin "&c[Admin] "
/hp group setprefix vip "&a[VIP] "
/hp group setprefix default "&7"
Include a space after your prefix (inside the quotes) for proper spacing in chat. For example: "&c[Admin] " with a trailing space.

Suffix

Text displayed after the player's name in chat. Works like prefix.

text
/hp group setsuffix vip " &6ā˜…"
/hp group setsuffix admin " &cāœ¦"

Parents

Groups that this group inherits permissions from. A group can have multiple parents.

text
/hp group addparent mod vip    # mod inherits from vip
/hp group addparent mod helper # mod also inherits from helper

Learn more in the inheritance guide.

The Default Group

Every server has a default group that new players are automatically assigned to. This group is created when HyperPerms first runs.

Do not delete the default group. It's required for new players to have a base set of permissions.

Managing Groups

Creating Groups

CommandDescription
/hp group create <name>Create a new group
/hp group create <name> [displayName]Create with display name
text
/hp group create vip
/hp group create senior-mod "Senior Moderator"

Viewing Groups

CommandDescription
/hp group listList all groups
/hp group info <group>View group details

Modifying Groups

CommandDescription
/hp group setweight <name> <weight>Set group weight
/hp group setprefix <name> <prefix>Set chat prefix
/hp group setsuffix <name> <suffix>Set chat suffix
/hp group setdisplayname <name> <displayName>Set display name

Managing Permissions

CommandDescription
/hp group addpermission <group> <permission> [value]Add permission
/hp group removepermission <group> <permission>Remove permission

Managing Inheritance

CommandDescription
/hp group addparent <group> <parent>Add parent group
/hp group removeparent <group> <parent>Remove parent group

Deleting Groups

CommandDescription
/hp group delete <name>Delete a group
/hp group clear <name>Remove all permissions from group
Deleting a group removes all players from it. Make sure to reassign players before deleting their primary group.

Color Codes in Groups

Prefixes, suffixes, and display names support color codes:

Standard Colors

text
&0 Black      &1 Dark Blue   &2 Dark Green  &3 Dark Aqua
&4 Dark Red   &5 Dark Purple &6 Gold        &7 Gray
&8 Dark Gray  &9 Blue        &a Green       &b Aqua
&c Red        &d Pink        &e Yellow      &f White

Formatting Codes

text
&l Bold
&o Italic
&n Underline
&m Strikethrough
&k Magic/Obfuscated
&r Reset

Hex Colors

text
&#RRGGBB - Custom hex color
&#FF5555 - Light red
&#55FF55 - Light green
&#5555FF - Light blue

See the color codes reference for more details.

Best Practices for Group Organization

Keep It Simple

Start with a simple hierarchy and only add complexity when needed:

text
default ā†’ vip ā†’ mod ā†’ admin ā†’ owner

Separate Staff and Donor Tracks

Keep donation ranks and staff ranks separate to avoid giving donors staff permissions:

text
Staff track:  default ā†’ helper ā†’ mod ā†’ admin ā†’ owner
Donor track:  default ā†’ vip ā†’ vip+ ā†’ mvp

Use Meaningful Names

  • moderator instead of rank3
  • builder instead of group-b
  • trial-mod instead of temp1

Document Your Groups

Use display names to provide clear descriptions:

text
/hp group setdisplayname trial-mod "Trial Moderator (2 week evaluation)"
/hp group setdisplayname content "Content Creator Partner"

Example Group Setup

text
# Create groups
/hp group create vip
/hp group create helper
/hp group create mod
/hp group create admin
/hp group create owner

# Set weights (for display priority)
/hp group setweight default 0
/hp group setweight vip 10
/hp group setweight helper 30
/hp group setweight mod 50
/hp group setweight admin 90
/hp group setweight owner 100

# Set up inheritance chain
/hp group addparent vip default
/hp group addparent helper default
/hp group addparent mod helper
/hp group addparent admin mod
/hp group addparent owner admin

# Configure display
/hp group setprefix default "&7"
/hp group setprefix vip "&a[VIP] "
/hp group setprefix helper "&e[Helper] "
/hp group setprefix mod "&9[Mod] "
/hp group setprefix admin "&c[Admin] "
/hp group setprefix owner "&4[Owner] "

See Also