Frequently Asked Questions

General

What is HyperPerms?

HyperPerms is a permissions management plugin for Hytale dedicated servers. It allows server administrators to control what players can and cannot do through a flexible permission system.

Is HyperPerms free?

Yes! HyperPerms is completely free and open source. You can download it from our GitHub releases page.

What makes HyperPerms different from other permission plugins?

HyperPerms offers several unique features:

  • Context-aware permissions - Different permissions per world or gamemode
  • Web editor - Visual interface for managing permissions
  • Modern architecture - Built specifically for Hytale with performance in mind

Installation & Setup

How do I install HyperPerms?

Simply download the JAR file and place it in your server's plugins folder. See our installation guide for detailed instructions.

What Java version do I need?

HyperPerms requires Java 21 or higher.

Can I migrate from other permission plugins?

Yes! HyperPerms supports importing from:

  • EtherealPerms
  • HyPerms
  • MyPermissions

See our migration guide for details.

Usage

How do I create a group?

text
/hp group create <name>

For example: /hp group create vip

How do I give a player a permission?

text
/hp user setperm <player> <permission> true

For example: /hp user setperm Steve fly.enable true

How do I set up group inheritance?

text
/hp group parent add <child> <parent>

For example: /hp group parent add vip default makes VIP inherit from default.

How do I use the web editor?

Run /hp editor in-game. This will generate a link to the web editor with your current permissions loaded. Make changes, then copy the apply command and run it on your server.

Troubleshooting

Permissions aren't working

Check the following:

  1. Is the player online? Changes apply immediately for online players.
  2. Did you spell the permission correctly? Use /hp check <player> <permission> to verify.
  3. Check for conflicting permissions (deny overrides allow).
  4. Check if the permission has a context requirement.

The plugin won't load

Check these common issues:

  1. Make sure you're using Java 21 or higher.
  2. Check the server console for error messages.
  3. Verify the JAR file isn't corrupted (re-download if needed).
  4. Make sure there are no conflicting plugins.

Where can I get help?

Join our Discord server or open an issue on GitHub. We're happy to help!