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 migrating from LuckPerms (YAML, JSON, H2, SQLite, MySQL/MariaDB) via /hp migrate luckperms. You can also import from JSON files or reset to default permission setups.

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.

Why does Hytale reset my OP/Default group permissions?

Hytale's built-in permission system forcibly resets the OP and Default groups every server restart. Any custom permissions you add to these vanilla groups will be lost. Use HyperPerms groups instead (/hp group create). HyperPerms logs a warning at startup if it detects custom permissions in vanilla groups.

Is SQLite required?

No. SQLite is optional and only needed for analytics tracking and audit logs. Without it, everything works fine using JSON storage. To enable, download the sqlite-jdbc driver from sqlite-jdbc releases and place it in mods/com.hyperperms_HyperPerms/lib/.

How do I set up MariaDB/MySQL?

Set "storage": { "type": "mariadb" } in config.json and add your MariaDB connection settings. See the storage configuration guide for full details on database setup.

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.
  5. Use /hp debug resolve <player> <permission> to see step-by-step resolution.

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.

Player not showing the right prefix

Check the Primary Group System documentation. The prefix displayed depends on:

  1. User's custom prefix (if set)
  2. Primary group's prefix
  3. Highest prefixPriority/weight group
  4. Config default prefix

Cache issues

If permissions seem stale, the cache may need invalidation. You can:

  • Run /hp reload to reload all data
  • Have the player relog to refresh their permissions
  • Reduce cache.expireAfterAccessMinutes in config.json for faster updates

Where can I get help?

We're here to help! You can:

Couldn't find your answer? Have a suggestion?

Send us feedback →