General Commands

Root-level commands for help, diagnostics, configuration management, backups, and more. For user and group management, see the dedicated pages.

Root Commands

Command	Description
`/hp help [command]`	Show help and subcommand list
`/hp check <player> <permission>`	Check if a player has a permission
`/hp reload`	Reload config and permissions
`/hp resetgroups confirm`	Reset to default groups (requires confirmation)
`/hp export [--filename=name]`	Export permissions to JSON
`/hp editor`	Create a web editor session
`/hp apply <sessionId>`	Apply web editor changes
`/hp update`	Check for plugin updates
`/hp update confirm`	Download and install update
`/hp updates [on\|off]`	Toggle update notifications on join

Container Commands

These command families have their own subcommands. Some have dedicated documentation pages, and others are documented below.

Command	Description
`/hp user ...`	User management (see User Commands page)
`/hp group ...`	Group management (see Group Commands page)
`/hp debug ...`	Debug and diagnostics
`/hp backup ...`	Backup management
`/hp perms ...`	Permission discovery and search
`/hp import ...`	Import permissions
`/hp template ...`	Template management
`/hp analytics ...`	Analytics and audit
`/hp migrate luckperms[-confirm]`	LuckPerms migration

Permissions

Permission	Description	Default
`hyperperms.command.help`	Access to /hp help	true
`hyperperms.command.check`	Access to /hp check	op
`hyperperms.command.reload`	Access to /hp reload	op
`hyperperms.command.resetgroups`	Access to /hp resetgroups	op
`hyperperms.command.export`	Access to /hp export	op
`hyperperms.command.editor`	Access to /hp editor	op
`hyperperms.command.apply`	Access to /hp apply	op
`hyperperms.command.update`	Access to /hp update	op
`hyperperms.command.updates`	Access to /hp updates	op
`hyperperms.command.debug`	Access to /hp debug	op
`hyperperms.command.backup`	Access to /hp backup	op
`hyperperms.command.perms`	Access to /hp perms	op
`hyperperms.command.import`	Access to /hp import	op
`hyperperms.command.template`	Access to /hp template	op
`hyperperms.command.analytics`	Access to /hp analytics	op
`hyperperms.command.migrate`	Access to /hp migrate	op

Root Command Details

/hp help

Display help information for HyperPerms commands.

text

Usage: /hp help [command]

Examples:
/hp help              # Show general help and command list
/hp help group        # Show help for group commands
/hp help user info    # Show help for a specific subcommand

/hp check

Check whether a specific player has a permission. Useful for testing and verifying your permission configuration.

text

Usage: /hp check <player> <permission>

Examples:
/hp check Steve fly.enable
/hp check Steve hyperperms.admin

Output:
[HyperPerms] Permission check for Steve:
[HyperPerms]   fly.enable: true
[HyperPerms]   Source: group 'vip' [world=hub]
[HyperPerms]   Current context: world=hub (matches)

Output shows:

Whether the permission is granted or denied
Which group or user setting provides the permission
Any relevant context requirements

/hp reload

Reload configuration and permission data from disk.

text

Usage: /hp reload

Output:
[HyperPerms] Reloading configuration...
[HyperPerms] Configuration reloaded successfully.
[HyperPerms] Loaded 5 groups, 127 users, 2 tracks.

Use reload after manually editing configuration files. Changes made through commands are saved automatically.

Some configuration changes require a full server restart, such as changing the storage backend type.

/hp resetgroups

Reset all groups back to the default configuration. This is a destructive operation that requires explicit confirmation.

text

Usage: /hp resetgroups confirm

Output:
[HyperPerms] All groups have been reset to defaults.
[HyperPerms] Loaded 1 group (default).

This permanently deletes all custom groups and their permissions. All players will be moved to the default group. Create a backup before running this command.

/hp export

Export all permission data to a JSON file.

text

Usage: /hp export [--filename=name]

Examples:
/hp export                          # Export with default timestamp name
/hp export --filename=my-backup     # Export with custom filename

Output:
[HyperPerms] Exported permissions to: exports/my-backup.json

Exports are saved to the mods/com.hyperperms_HyperPerms/exports/ directory. Use these files with /hp import file to restore later.

/hp editor

Create a web editor session for managing permissions through the browser.

text

Usage: /hp editor

Output:
[HyperPerms] Web editor session created!
[HyperPerms] URL: https://hyperperms.com/editor?session=abc123
[HyperPerms] Session expires in 30 minutes.

/hp apply

Apply changes made in the web editor back to the server.

text

Usage: /hp apply <sessionId>

Example:
/hp apply abc123

Output:
[HyperPerms] Applying changes from web editor session...
[HyperPerms] Applied 12 changes successfully.

/hp update

Check for and install plugin updates.

text

Usage: /hp update           # Check for updates
       /hp update confirm    # Download and install the update

Example:
/hp update
[HyperPerms] Current version: 2.8.5
[HyperPerms] Latest version: 2.8.6
[HyperPerms] Run /hp update confirm to download.

/hp update confirm
[HyperPerms] Downloading HyperPerms v2.8.6...
[HyperPerms] Update downloaded. Restart the server to apply.

/hp updates

Toggle whether operators receive update notifications when they join the server.

text

Usage: /hp updates [on|off]

Examples:
/hp updates         # Show current setting
/hp updates on      # Enable join notifications
/hp updates off     # Disable join notifications

Debug Commands

Debug commands provide detailed diagnostics for troubleshooting permission issues. All debug commands are under /hp debug.

Command	Description
`/hp debug perms`	Toggle verbose permission checking
`/hp debug tree <user>`	Show permission inheritance tree
`/hp debug resolve <user> <permission>`	Trace permission resolution step-by-step
`/hp debug contexts <user>`	Show active contexts for a user
`/hp debug toggle <category\|all> [on\|off]`	Toggle debug categories
`/hp debug status`	Show current debug status

/hp debug perms

Toggle verbose permission checking. When enabled, you will see detailed output for every permission check on the server.

text

Usage: /hp debug perms

Output (when enabled):
[Debug] Steve checked: fly.enable
[Debug]   Context: world=hub, gamemode=survival
[Debug]   Checking user permissions... not found
[Debug]   Checking group 'admin'... not found
[Debug]   Checking group 'vip' (inherited)... FOUND: true [world=hub]
[Debug]   Result: true

Verbose permission output is only shown to the player who enabled it. Other players will not see the debug output.

/hp debug tree

Display the full permission inheritance tree for a user.

text

Usage: /hp debug tree <user>

Example:
/hp debug tree Steve

Output:
[HyperPerms] Inheritance tree for Steve:
  Steve (user)
  +-- admin (primary, weight: 90)
  |   +-- mod (parent, weight: 50)
  |   |   +-- vip (parent, weight: 20)
  |   |       +-- default (parent, weight: 0)
  +-- vip (secondary, weight: 20)
      +-- default (parent, weight: 0)

/hp debug resolve

Trace the full resolution path for a specific permission on a user.

text

Usage: /hp debug resolve <user> <permission>

Example:
/hp debug resolve Steve fly.enable

Output:
[HyperPerms] Resolving fly.enable for Steve:
  1. Check user permissions... not set
  2. Check group 'admin' (weight: 90)... not set
  3. Check group 'mod' (weight: 50, parent of admin)... not set
  4. Check group 'vip' (weight: 20, parent of mod)... FOUND: true
  Result: true (from group 'vip')

/hp debug contexts

Show all active contexts for a user.

text

Usage: /hp debug contexts <user>

Example:
/hp debug contexts Steve

Output:
[HyperPerms] Active contexts for Steve:
  world = hub
  gamemode = survival
  server = lobby-1

/hp debug toggle

Enable or disable specific debug categories. Available categories:

RESOLUTION - Permission resolution steps
CACHE - Cache hits and misses
STORAGE - Storage read/write operations
CONTEXT - Context evaluation
INHERITANCE - Inheritance chain traversal
INTEGRATION - Third-party plugin integration
CHAT - Chat formatting
WEB - Web editor communication
MIGRATION - Migration operations
EXPIRY - Permission and group expiry

text

Usage: /hp debug toggle <category|all> [on|off]

Examples:
/hp debug toggle RESOLUTION on       # Enable resolution debugging
/hp debug toggle CACHE off            # Disable cache debugging
/hp debug toggle all on               # Enable all categories
/hp debug toggle all off              # Disable all categories

/hp debug status

Show the current state of all debug categories.

text

Usage: /hp debug status

Output:
[HyperPerms] Debug status:
  RESOLUTION:   ON
  CACHE:        OFF
  STORAGE:      OFF
  CONTEXT:      ON
  INHERITANCE:  OFF
  INTEGRATION:  OFF
  CHAT:         OFF
  WEB:          OFF
  MIGRATION:    OFF
  EXPIRY:       OFF

Debug output can be very verbose and may impact server performance. Only enable the categories you need and disable them when finished.

Backup Commands

HyperPerms includes built-in backup functionality under /hp backup.

Command	Description
`/hp backup create [--name=prefix]`	Create a backup
`/hp backup list`	List available backups
`/hp backup restore <backup>`	Restore from a backup

/hp backup create

text

Usage: /hp backup create [--name=prefix]

Examples:
/hp backup create                         # Create with timestamp name
/hp backup create --name=before-reset     # Create with custom prefix

Output:
[HyperPerms] Backup created: before-reset-2026-02-22-143022.json

/hp backup list

text

Usage: /hp backup list

Output:
[HyperPerms] Available backups:
[HyperPerms]   1. before-reset-2026-02-22-143022.json (2.3 MB)
[HyperPerms]   2. backup-2026-02-21-120000.json (2.1 MB)
[HyperPerms]   3. backup-2026-02-20-080000.json (2.0 MB)

/hp backup restore

text

Usage: /hp backup restore <backup>

Example:
/hp backup restore before-reset-2026-02-22-143022

Output:
[HyperPerms] Restoring from backup: before-reset-2026-02-22-143022.json
[HyperPerms] Backup restored successfully.
[HyperPerms] Loaded 5 groups, 120 users, 2 tracks.

Restoring a backup will overwrite all current permission data. Create a backup of the current state before restoring if you might need it.

Permission Discovery Commands

Search and browse registered permissions with /hp perms.

Command	Description
`/hp perms list [category]`	List registered permissions
`/hp perms search <query>`	Search permissions by pattern

/hp perms list

text

Usage: /hp perms list [category]

Examples:
/hp perms list                # List all permission categories
/hp perms list moderation     # List permissions in the moderation category

Output:
[HyperPerms] Registered permissions (moderation):
  mod.kick - Allow kicking players
  mod.ban - Allow banning players
  mod.mute - Allow muting players
  mod.warn - Allow warning players

/hp perms search

text

Usage: /hp perms search <query>

Example:
/hp perms search fly

Output:
[HyperPerms] Search results for "fly":
  fly.enable - Allow flight
  fly.speed - Allow flight speed changes
  creative.fly - Creative mode flight

Import Commands

Import permission data with /hp import.

Command	Description
`/hp import defaults`	Import default permission setup
`/hp import file <filename>`	Import from a JSON file

/hp import defaults

text

Usage: /hp import defaults

Output:
[HyperPerms] Importing default permission setup...
[HyperPerms] Created 4 groups with default permissions.

This is useful for new installations to get a sensible starting configuration with default, vip, mod, and admin groups.

/hp import file

text

Usage: /hp import file <filename>

Example:
/hp import file my-backup

Output:
[HyperPerms] Importing from: exports/my-backup.json
[HyperPerms] Imported 5 groups, 120 users, 2 tracks.

Importing will merge with existing data. Duplicate groups and users will be overwritten with the imported values.

General Commands

Root Commands

Container Commands

Permissions

Root Command Details

/hp help

/hp check

/hp reload

/hp resetgroups

/hp export

/hp editor

/hp apply

/hp update

/hp updates

Debug Commands

/hp debug perms

/hp debug tree

/hp debug resolve

/hp debug contexts

/hp debug toggle

/hp debug status

Backup Commands

/hp backup create

/hp backup list

/hp backup restore

Permission Discovery Commands

/hp perms list

/hp perms search

Import Commands

/hp import defaults

/hp import file

See Also