HyperPerms

The first Hytale permissions plugin with a web editor.

Run /hp editor. Your browser opens. Edit permissions visually — groups, inheritance, prefixes, everything. No config files. No commands to memorize. Just click, drag, and save.

Works on any device with a browser. No desktop apps required.

⚠️ Early access — actively developing. Report bugs and help shape the future of this plugin!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Get Running in 60 Seconds

1. Drop HyperPerms.jar in your mods folder
2. Start your server
3. Run /hp editor — or /hp template apply survival for instant ranks
4. That's it.

Need a full rank hierarchy? Pick from 11 ready-made templates — survival, RPG, factions, skyblock, prison, creative, SMP, towny, minigames, vanilla, or a staff-only setup. One command gives you groups, permissions, inheritance, prefixes, and tracks.

Prefer the command line? Everything in the web editor is also available via /hp group, /hp user, and 40+ subcommands.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Web Editor Highlights

• Drag-and-drop permission management
• Interactive inheritance graph — see how groups connect at a glance
• Smart autocomplete with 300+ permissions organized by plugin and category
• Live chat preview — see exactly how your ranks look before saving
• Temporary permissions — set durations like 2h30m or 1w with a built-in picker
• Context rules — assign permissions per-world or per-gamemode

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Works With Your Favorite Plugins

VaultUnlocked

Official partnership. Any plugin using VaultUnlocked for permissions works automatically — zero configuration. Install both and they connect on their own. Get VaultUnlocked

MMOSkillTree

First-class support with 200+ permission nodes pre-registered. All 23 skills, all 140 XP boost nodes, full ziggfreed.* alternate prefix resolution, tab completion, and web editor autocomplete — all out of the box.

HyperFactions

Faction tags, colors, and ranks appear in chat automatically. No setup needed.

PlaceholderAPI

Two-way placeholder support — use %hyperperms_prefix%, %hyperperms_group%, %hyperperms_suffix%, and more in any PlaceholderAPI-compatible plugin.

MysticNameTags

Tag permissions and nametag display stay in sync. When a player's group or permissions change, their nameplate updates automatically.

WerChat

Full chat channel support with prefix/suffix integration.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Coming From LuckPerms or PermissionsPlus?

One command migrates everything — groups, users, tracks, temporary permissions, and contexts.

/hp migrate luckperms          (preview changes)
/hp migrate luckperms --confirm (execute migration)
/hp migrate permissionsplus` — Preview migration (dry-run)
/hp migrate permissionsplus --confirm` — Execute migration

Supports YAML, JSON, H2, and MySQL/MariaDB backends. An automatic backup is created before anything changes.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Multi-Server Ready

Three storage backends to match your setup:

• JSON — Zero setup, works immediately
• SQLite — Embedded database for single servers
• MariaDB / MySQL — Shared database across your network with HikariCP connection pooling

Set storage.type in config.json. Schema auto-creates on first run.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Everything You'd Expect, and More

Permissions — Wildcards (*, rpg.dungeon.*), negation (-hytale.command.spawn), temporary durations (1d, 2h30m, 1w), context-aware resolution, and unlimited inheritance depth.

Groups & Ranks — Unlimited groups with weighted priority, parent inheritance, prefix/suffix with priority, promotion/demotion tracks, and custom display names.

Debugging — 10 toggleable debug categories (/hp debug toggle RESOLUTION). Trace permission resolution, cache behavior, storage operations, chat formatting, and more.

Backup & Restore — /hp backup create, /hp backup list, /hp backup restore. Never lose your configuration.

Analytics — /hp analytics summary shows permission health. /hp analytics hotspots reveals your most-checked permissions. Change history audit trail tracks who modified what and when.

Runtime Discovery — HyperPerms scans your installed plugins at startup and discovers their permission nodes automatically. Discovered permissions appear in the web editor with "Installed" badges.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

For Developers

• Event system — GroupCreateEvent, UserGroupChangeEvent, PermissionCheckEvent, and more. All cancellable with priority levels.
• Async API — hasPermissionAsync(), fluent checkAsync() builder, permission query API for bulk operations
• Permission enumeration — HyperPermsAPI.getResolvedPermissions(UUID) returns all granted permissions for a player
• JitPack — Add as a dependency: com.github.HyperSystemsDev:HyperPerms:<version>

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Links

• Wiki & Docs — hyperperms.com/wiki
• Discord — Join the community
• Feedback — hyperperms.com/feedback
• Roadmap — hyperperms.com/wiki/roadmap
• Source — GitHub

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Built for Hytale from day one. Simple for beginners. Powerful for pros.