Understanding Permission Node Structure
Before diving into the full list, let's understand how permission nodes are structured in Hytale and HyperPerms.
Node Naming Convention
Permission nodes follow a hierarchical dot notation:
<plugin>.<category>.<action>
For example:
hytale.chat.send— Hytale plugin, chat category, send actionhyperperms.group.create— HyperPerms plugin, group category, create action
Wildcard Permissions
The asterisk (*) acts as a wildcard:
hytale.chat.*— All chat-related permissionshyperperms.*— All HyperPerms permissions*— Every permission (use with extreme caution!)
Permission Values
Permissions can be:
true— Grants the permissionfalse— Explicitly denies the permission (overrides inheritance)
Denying a permission with false is powerful for exceptions. If moderators have hytale.teleport.* but shouldn't teleport to spawn, set hytale.teleport.spawn: false.
Core Hytale Permissions
These are the fundamental permissions for basic gameplay.
Building & World Interaction
| Permission | Description | Default |
|---|---|---|
hytale.build | Place and break blocks | true |
hytale.interact | Use doors, buttons, levers | true |
hytale.container.access | Open chests, barrels, etc. | true |
hytale.item.pickup | Pick up dropped items | true |
hytale.item.drop | Drop items from inventory | true |
hytale.vehicle.use | Mount horses, boats, etc. | true |
Chat & Communication
| Permission | Description | Default |
|---|---|---|
hytale.chat | Send messages in chat | true |
hytale.chat.color | Use color codes in chat | false |
hytale.chat.format | Use formatting (bold, italic) | false |
hytale.chat.links | Post clickable links | false |
hytale.msg | Send private messages | true |
hytale.broadcast | Send server-wide announcements | false |
Movement & Teleportation
| Permission | Description | Default |
|---|---|---|
hytale.teleport.home | Teleport to home location | true |
hytale.teleport.spawn | Teleport to world spawn | true |
hytale.teleport.player | Teleport to other players | false |
hytale.teleport.coords | Teleport to coordinates | false |
hytale.fly | Enable flight mode | false |
hytale.speed | Change movement speed | false |
Moderation Permissions
Permissions for staff members managing players.
Player Management
| Permission | Description | Recommended For |
|---|---|---|
hytale.kick | Kick players from server | Moderator |
hytale.ban | Permanently ban players | Admin |
hytale.ban.temporary | Issue temporary bans | Moderator |
hytale.unban | Remove player bans | Admin |
hytale.mute | Mute players in chat | Moderator |
hytale.unmute | Remove player mutes | Moderator |
hytale.warn | Issue warnings to players | Helper |
Server Monitoring
| Permission | Description | Recommended For |
|---|---|---|
hytale.see.hidden | See vanished players | Moderator |
hytale.see.ip | View player IP addresses | Admin |
hytale.logs.view | Access server logs | Admin |
hytale.reports.view | View player reports | Moderator |
Administrative Permissions
High-level permissions for server administrators.
Server Control
| Permission | Description | Recommended For |
|---|---|---|
hytale.reload | Reload server configuration | Admin |
hytale.stop | Stop the server | Owner |
hytale.maintenance | Toggle maintenance mode | Admin |
hytale.whitelist | Manage server whitelist | Admin |
World Management
| Permission | Description | Recommended For |
|---|---|---|
hytale.world.create | Create new worlds | Owner |
hytale.world.delete | Delete worlds | Owner |
hytale.world.load | Load/unload worlds | Admin |
hytale.world.import | Import external worlds | Admin |
hytale.world.teleport | Teleport between worlds | Admin |
Game Control
| Permission | Description | Recommended For |
|---|---|---|
hytale.gamemode | Change own gamemode | Admin |
hytale.gamemode.others | Change others' gamemode | Admin |
hytale.time.set | Change world time | Moderator |
hytale.weather.set | Change world weather | Moderator |
HyperPerms Plugin Permissions
Permissions specific to managing HyperPerms itself.
Group Management
| Permission | Description |
|---|---|
hyperperms.group.create | Create new groups |
hyperperms.group.delete | Delete groups |
hyperperms.group.edit | Modify group settings |
hyperperms.group.list | View all groups |
hyperperms.group.info | View group details |
hyperperms.group.* | All group permissions |
User Management
| Permission | Description |
|---|---|
hyperperms.user.edit | Modify user permissions |
hyperperms.user.info | View user permission info |
hyperperms.user.promote | Promote users on tracks |
hyperperms.user.demote | Demote users on tracks |
hyperperms.user.* | All user permissions |
System Permissions
| Permission | Description |
|---|---|
hyperperms.admin | Full HyperPerms access |
hyperperms.reload | Reload configuration |
hyperperms.editor | Access web editor |
hyperperms.debug | Use debug commands |
Context-Specific Permissions
HyperPerms supports context-aware permissions that only apply in certain situations.
World Contexts
Apply permissions only in specific worlds:
/hp user Player permission set hytale.fly true world=creative
Now the player can only fly in the "creative" world.
Gamemode Contexts
Apply permissions based on gamemode:
/hp group builder permission set hytale.fly true gamemode=creative
Time-Based Contexts
Apply permissions during certain times:
/hp group vip permission set hytale.bonus.* true time=night
Best Practices for Permission Assignment
Start Restrictive
Begin with minimal permissions and add more as needed. It's easier to grant permissions than to revoke them after players are used to having them.
Use Groups, Not Individual Permissions
Instead of giving each player permissions directly, always use groups. This makes management scalable.
Document Your Setup
Keep notes on what each custom permission does and which groups have them. Future you will thank present you.
Test Before Deploying
Use HyperPerms' check command to verify permissions:
/hp user check PlayerName hytale.fly
Quick Reference Card
Essential Player Permissions:
hytale.build,hytale.chat,hytale.teleport.home
Essential Moderator Permissions:
hytale.kick,hytale.mute,hytale.ban.temporary
Essential Admin Permissions:
hytale.ban,hytale.gamemode,hyperperms.user.*
Essential Owner Permissions:
hyperperms.admin,hytale.stop,*(full access)
For a searchable, filterable list of all permissions, try HyperPerms' visual editor which includes a complete permission database with descriptions and categories.