User Commands

Commands for managing individual player permissions, group assignments, and promotions.

Command Summary

CommandDescription
/hp user info <player>View user details
/hp user addpermission <player> <perm> [value] [contexts...]Add permission to user
/hp user removepermission <player> <perm> [contexts...]Remove permission from user
/hp user addgroup <player> <group>Add user to a group
/hp user removegroup <player> <group>Remove user from a group
/hp user setprimarygroup <player> <group>Set user's primary group
/hp user clear <player>Clear all user-specific data
/hp user promote <player> <track>Promote user on a track
/hp user demote <player> <track>Demote user on a track

Permissions

PermissionDescriptionDefault
hyperperms.command.userAccess to all user commandsop
hyperperms.command.user.infoView user infoop
hyperperms.command.user.permissionModify user permissionsop
hyperperms.command.user.groupModify user groupsop
hyperperms.command.user.promotePromote/demote usersop
hyperperms.command.user.clearClear user dataop

Viewing User Information

/hp user info

View detailed information about a player's permissions and groups.

text
Usage: /hp user info <player>

Arguments:
  <player>  - Player name or UUID

Example:
/hp user info Steve

Output:
[HyperPerms] User: Steve
[HyperPerms]   UUID: 853c80ef-3c37-49fd-aa49-938b674adae6
[HyperPerms]   Primary Group: admin
[HyperPerms]   Groups: admin, vip
[HyperPerms]   Prefix: &c[Admin]
[HyperPerms]   User Permissions (2):
[HyperPerms]     - fly.enable: true
[HyperPerms]     - special.perk: true
[HyperPerms]   Effective Permissions: 47
You can use either the player's username or their UUID. UUIDs are useful for players who have changed their name.

Managing User Permissions

/hp user addpermission

Add a permission directly to a user (overrides group permissions).

text
Usage: /hp user addpermission <player> <permission> [value] [contexts...]

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

Examples:
/hp user addpermission Steve fly.enable true
/hp user addpermission Steve mod.ban false
/hp user addpermission Steve special.perk true
/hp user addpermission Steve build.* true world=creative

Use cases:

  • Temporary permissions - Give someone something temporarily
  • Special exceptions - Override a group permission for one player
  • Restrictions - Deny a permission even if their group has it
User permissions have the highest priority. They override all group permissions. Use sparingly to avoid confusion.

/hp user removepermission

Remove a user-specific permission.

text
Usage: /hp user removepermission <player> <permission> [contexts...]

Examples:
/hp user removepermission Steve fly.enable
/hp user removepermission Steve build.* world=creative
This removes the user-specific permission. If the player's group also has this permission, the group permission will take effect.

Managing User Groups

/hp user addgroup

Add a player to a group.

text
Usage: /hp user addgroup <player> <group>

Examples:
/hp user addgroup Steve vip
/hp user addgroup Steve mod
/hp user addgroup Alex helper

Players can be in multiple groups simultaneously. They receive permissions from all their groups.

/hp user removegroup

Remove a player from a group.

text
Usage: /hp user removegroup <player> <group>

Examples:
/hp user removegroup Steve vip
/hp user removegroup Alex helper
If you remove a player's primary group, they'll be automatically moved to the default group.

/hp user setprimarygroup

Set a player's primary group.

text
Usage: /hp user setprimarygroup <player> <group>

Examples:
/hp user setprimarygroup Steve admin
/hp user setprimarygroup Alex mod

The primary group:

  • Determines the player's default prefix/suffix
  • Is shown as their "main" rank in various displays
  • Player must be a member of the group (added automatically if not)

Promotion and Demotion

/hp user promote

Promote a player to the next rank on a track.

text
Usage: /hp user promote <player> <track>

Example:
/hp user promote Steve staff

# If Steve is "helper" on the staff track:
# - Steve is removed from "helper"
# - Steve is added to "mod" (next rank on track)
# - Primary group is updated to "mod"

/hp user demote

Demote a player to the previous rank on a track.

text
Usage: /hp user demote <player> <track>

Example:
/hp user demote Steve staff

# If Steve is "mod" on the staff track:
# - Steve is removed from "mod"
# - Steve is added to "helper" (previous rank)
# - Primary group is updated to "helper"
Promotion and demotion require tracks to be set up. See the tracks guide and track commands.

Edge Cases

text
# At the top of track:
/hp user promote Steve staff
# Error: Steve is already at the top of the staff track

# At the bottom of track:
/hp user demote Steve staff
# Error: Steve is already at the bottom of the staff track

# Not on track:
/hp user promote Alex staff
# Alex is added to the first group on the track

Clearing User Data

/hp user clear

Remove all user-specific data, resetting the player to default state.

text
Usage: /hp user clear <player>

Example:
/hp user clear Steve

This removes:

  • All user-specific permissions
  • All group memberships (except default)
  • Custom prefix/suffix
  • Sets primary group back to default
This is irreversible. Create a backup first if you might need the data.

Working with Offline Players

You can manage permissions for offline players by using their username (if they've played before) or UUID.

text
# By username (must have joined before)
/hp user addgroup Steve admin

# By UUID (always works)
/hp user addgroup 853c80ef-3c37-49fd-aa49-938b674adae6 admin
Changes to offline players are saved immediately. The player will see the changes when they next log in.

Custom Prefix and Suffix

Set custom prefix/suffix that overrides the group prefix:

CommandDescription
/hp user setprefix <player> <prefix>Set custom prefix
/hp user setsuffix <player> <suffix>Set custom suffix
text
# Set custom prefix
/hp user setprefix Steve "&6[MVP] "

# Clear custom prefix (use group prefix)
/hp user setprefix Steve ""

Examples

Promoting a New Staff Member

text
# Add to staff group
/hp user addgroup Steve helper
/hp user setprimarygroup Steve helper

# Or use a track
/hp user promote Steve staff

Giving VIP Perks

text
# Add to VIP group
/hp user addgroup Steve vip

# If they should show VIP prefix instead of staff prefix:
/hp user setprimarygroup Steve vip

# Or let them keep both and choose which to display

Restricting a Specific Player

text
# Player has mod permissions but abused ban
# Remove ban permission specifically for them
/hp user addpermission Steve mod.ban false

# They keep all other mod permissions, but can't ban

See Also