Group Commands

Commands for creating, modifying, and managing permission groups.

Command Summary

Command	Description
`/hp group create <name> [displayName]`	Create a new group
`/hp group delete <name>`	Delete a group
`/hp group rename <oldname> <newname>`	Rename a group
`/hp group list`	List all groups
`/hp group info <name>`	View group details
`/hp group setweight <name> <weight>`	Set group weight/priority
`/hp group setprefix <name> <prefix>`	Set chat prefix
`/hp group setsuffix <name> <suffix>`	Set chat suffix
`/hp group setdisplayname <name> <displayName>`	Set display name
`/hp group setperm <group> <perm> [value] [duration]`	Set permission on group
`/hp group unsetperm <group> <perm>`	Remove permission from group
`/hp group setexpiry <group> <perm> <duration>`	Set or modify permission expiry
`/hp group parent add <group> <parent> [duration]`	Add parent group
`/hp group parent remove <group> <parent>`	Remove parent group

Permissions

Permission	Description	Default
`hyperperms.command.group`	Access to all group commands	op
`hyperperms.command.group.create`	Create groups	op
`hyperperms.command.group.delete`	Delete groups	op
`hyperperms.command.group.rename`	Rename groups	op
`hyperperms.command.group.list`	List groups	op
`hyperperms.command.group.info`	View group info	op
`hyperperms.command.group.modify`	Modify group properties	op

Duration Syntax

Several group commands accept an optional [duration] parameter for temporary permissions and parent relationships. Durations use a human-readable format:

Command	Description
`30s`	30 seconds
`5m`	5 minutes
`2h`	2 hours
`1d`	1 day
`1w`	1 week
`1d12h`	1 day and 12 hours (combined)
`permanent`	No expiry (default)

text

Examples:
/hp group setperm vip fly.enable true 30d        # Expires in 30 days
/hp group setperm mod event.manage true 2h        # Expires in 2 hours
/hp group parent add mod event-staff 1w           # Temporary inheritance for 1 week

Durations can be combined freely. For example, 1w2d6h means 1 week, 2 days, and 6 hours. Use permanent to explicitly set no expiry.

Creating and Deleting Groups

/hp group create

Create a new permission group.

text

Usage: /hp group create <name> [displayName]

Arguments:
  <name>         - Internal group name (lowercase, no spaces)
  [displayName]  - Optional human-readable name

Examples:
/hp group create vip
/hp group create senior-mod "Senior Moderator"
/hp group create content-creator "Content Creator"

Group names should be lowercase and use hyphens instead of spaces. Use the display name for human-readable formatting.

/hp group delete

Delete an existing group.

text

Usage: /hp group delete <name>

Example:
/hp group delete old-rank

Deleting a group removes all players from it. Players will lose permissions that came from that group. Make sure to reassign players before deleting.

/hp group rename

Rename an existing group. All players, permissions, and parent relationships are preserved.

text

Usage: /hp group rename <oldname> <newname>

Example:
/hp group rename helper junior-mod

Output:
[HyperPerms] Group 'helper' renamed to 'junior-mod'.
[HyperPerms] Updated 15 users and 3 parent references.

Renaming a group automatically updates all references to it, including user memberships, parent relationships, and track entries.

Viewing Groups

/hp group list

List all permission groups.

text

Usage: /hp group list

Output:
[HyperPerms] Groups (5):
  - default (weight: 0)
  - vip (weight: 20)
  - mod (weight: 50)
  - admin (weight: 90)
  - owner (weight: 100)

/hp group info

View detailed information about a group.

text

Usage: /hp group info <name>

Example:
/hp group info admin

Output:
[HyperPerms] Group: admin
[HyperPerms]   Display Name: Administrator
[HyperPerms]   Weight: 90
[HyperPerms]   Prefix: &c[Admin]
[HyperPerms]   Suffix: (none)
[HyperPerms]   Parents: mod
[HyperPerms]   Permissions (3):
[HyperPerms]     - hyperperms.admin: true
[HyperPerms]     - mod.ban: true
[HyperPerms]     - admin.gamemode: true

Modifying Group Properties

/hp group setweight

Set the weight (priority) of a group.

text

Usage: /hp group setweight <name> <weight>

Arguments:
  <name>    - Group name
  <weight>  - Number (higher = higher priority)

Examples:
/hp group setweight vip 20
/hp group setweight admin 90

Weight affects prefix display order and permission conflict resolution. See the weight guide for details.

/hp group setprefix

Set the chat prefix for a group.

text

Usage: /hp group setprefix <name> <prefix>

Arguments:
  <name>    - Group name
  <prefix>  - Prefix text (supports color codes)

Examples:
/hp group setprefix vip "&a[VIP] "
/hp group setprefix admin "&c[Admin] "
/hp group setprefix owner "&4&l[OWNER] "
/hp group setprefix mvp "&#FF5555[MVP] "

Include a space after your prefix for proper chat formatting. Use quotes if the prefix contains spaces.

/hp group setsuffix

Set the chat suffix for a group.

text

Usage: /hp group setsuffix <name> <suffix>

Examples:
/hp group setsuffix vip " &6*"
/hp group setsuffix admin " &c+"
/hp group setsuffix owner " &4#"

/hp group setdisplayname

Set the human-readable display name for a group.

text

Usage: /hp group setdisplayname <name> <displayName>

Examples:
/hp group setdisplayname mod "Server Moderator"
/hp group setdisplayname vip "VIP Member"
/hp group setdisplayname trial-mod "Trial Moderator"

Managing Permissions

/hp group setperm

Set a permission on a group.

text

Usage: /hp group setperm <group> <permission> [value] [duration]

Arguments:
  <group>       - Group name
  <permission>  - Permission node
  [value]       - true (default) or false
  [duration]    - Optional expiry duration

Examples:
/hp group setperm vip fly.enable true
/hp group setperm mod mod.kick true
/hp group setperm mod mod.ban false
/hp group setperm builder worldedit.* true
/hp group setperm admin teleport.* true
/hp group setperm mod event.manage true 1w

/hp group unsetperm

Remove a permission from a group.

text

Usage: /hp group unsetperm <group> <permission>

Examples:
/hp group unsetperm vip fly.enable
/hp group unsetperm builder worldedit.*

When removing contextual permissions, you must specify the same permission node that was used when setting it. Use /hp group info to see current permissions.

/hp group setexpiry

Set or modify the expiry duration on an existing group permission.

text

Usage: /hp group setexpiry <group> <permission> <duration>

Examples:
/hp group setexpiry vip fly.enable 30d          # Set 30-day expiry
/hp group setexpiry mod event.manage 1h         # Reduce to 1 hour
/hp group setexpiry mod event.manage permanent  # Remove expiry

The duration is always relative to the current time. Setting an expiry replaces any existing expiry on that permission.

Managing Inheritance

/hp group parent add

Add a parent group (inheritance), with optional duration for temporary inheritance.

text

Usage: /hp group parent add <group> <parent> [duration]

Arguments:
  <group>     - The group that will inherit
  <parent>    - The group to inherit from
  [duration]  - Optional expiry duration

Examples:
/hp group parent add vip default         # vip inherits from default
/hp group parent add mod vip             # mod inherits from vip
/hp group parent add admin mod           # admin inherits from mod
/hp group parent add mod event-staff 1w  # Temporary inheritance for 1 week

After these commands, admin has permissions from admin + mod + vip + default. See the inheritance guide for details.

/hp group parent remove

Remove a parent group (inheritance).

text

Usage: /hp group parent remove <group> <parent>

Example:
/hp group parent remove mod helper

Examples

Creating a Complete Group

text

# Create the group
/hp group create mod "Server Moderator"

# Set properties
/hp group setweight mod 50
/hp group setprefix mod "&9[Mod] "

# Set up inheritance
/hp group parent add mod vip

# Add permissions
/hp group setperm mod mod.kick true
/hp group setperm mod mod.mute true
/hp group setperm mod mod.warn true
/hp group setperm mod teleport.player true

Setting Up a Full Hierarchy

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
/hp group setweight default 0
/hp group setweight vip 20
/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 parent add vip default
/hp group parent add helper default
/hp group parent add mod vip
/hp group parent add mod helper
/hp group parent add admin mod
/hp group parent add owner admin

Renaming a Group

text

# Rename helper to junior-mod
/hp group rename helper junior-mod

# All player memberships, parent relationships, and track
# entries are automatically updated

Temporary Event Permissions

text

# Give the VIP group event access for one week
/hp group setperm vip event.access true 1w
/hp group setperm vip event.rewards true 1w

# Or create a temporary parent relationship
/hp group parent add vip event-perms 1w

Group Commands

Command Summary

Permissions

Duration Syntax

Creating and Deleting Groups

/hp group create

/hp group delete

/hp group rename

Viewing Groups

/hp group list

/hp group info

Modifying Group Properties

/hp group setweight

/hp group setprefix

/hp group setsuffix

/hp group setdisplayname

Managing Permissions

/hp group setperm

/hp group unsetperm

/hp group setexpiry

Managing Inheritance

/hp group parent add

/hp group parent remove

Examples

Creating a Complete Group

Setting Up a Full Hierarchy

Renaming a Group

Temporary Event Permissions

See Also