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 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 addpermission <name> <perm> [value] [contexts...]`	Add permission
`/hp group removepermission <name> <perm> [contexts...]`	Remove permission
`/hp group addparent <name> <parent>`	Add parent group
`/hp group removeparent <name> <parent>`	Remove parent group
`/hp group clear <name>`	Clear all permissions

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.list`	List groups	op
`hyperperms.command.group.info`	View group info	op
`hyperperms.command.group.modify`	Modify group properties	op

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.

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 addpermission

Add a permission to a group.

text

Usage: /hp group addpermission <group> <permission> [value] [contexts...]

Arguments:
  <group>       - Group name
  <permission>  - Permission node
  [value]       - true (default) or false
  [contexts...] - Optional context restrictions

Examples:
/hp group addpermission vip fly.enable true
/hp group addpermission mod mod.kick true
/hp group addpermission mod mod.ban false
/hp group addpermission builder worldedit.* true world=creative
/hp group addpermission admin teleport.* true

Context examples:

text

# World-specific permission
/hp group addpermission vip fly.enable true world=hub

# Gamemode-specific permission
/hp group addpermission builder we.* true gamemode=creative

# Multiple contexts (AND logic)
/hp group addpermission builder we.* true world=creative gamemode=creative

/hp group removepermission

Remove a permission from a group.

text

Usage: /hp group removepermission <group> <permission> [contexts...]

Examples:
/hp group removepermission vip fly.enable
/hp group removepermission builder we.* world=creative

When removing contextual permissions, you must specify the same contexts that were used when adding. A global remove won't affect contextual permissions.

Managing Inheritance

/hp group addparent

Add a parent group (inheritance).

text

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

Arguments:
  <group>   - The group that will inherit
  <parent>  - The group to inherit from

Examples:
/hp group addparent vip default    # vip inherits from default
/hp group addparent mod vip        # mod inherits from vip
/hp group addparent admin mod      # admin inherits from mod

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

/hp group removeparent

Remove a parent group (inheritance).

text

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

Example:
/hp group removeparent mod helper

Clearing Group Data

/hp group clear

Remove all permissions from a group.

text

Usage: /hp group clear <name>

Example:
/hp group clear old-rank

This only removes direct permissions. Parents, weight, prefix, and suffix remain unchanged. Use separate commands to modify those.

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 addparent mod vip

# Add permissions
/hp group addpermission mod mod.kick true
/hp group addpermission mod mod.mute true
/hp group addpermission mod mod.warn true
/hp group addpermission 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 addparent vip default
/hp group addparent helper default
/hp group addparent mod vip
/hp group addparent mod helper
/hp group addparent admin mod
/hp group addparent owner admin

Group Commands

Command Summary

Permissions

Creating and Deleting Groups

/hp group create

/hp group delete

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 addpermission

/hp group removepermission

Managing Inheritance

/hp group addparent

/hp group removeparent

Clearing Group Data

/hp group clear

Examples

Creating a Complete Group

Setting Up a Full Hierarchy

See Also