ReferenceJanuary 16, 202612 min read

Hytale Permission Nodes: Complete List & Explanation

A comprehensive reference guide to all default Hytale permission nodes. Organized by category with clear explanations of what each permission does.

hytale permissionspermission nodesreferencedocumentation

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 action
  • hyperperms.group.create β€” HyperPerms plugin, group category, create action

Wildcard Permissions

The asterisk (*) acts as a wildcard:

  • hytale.chat.* β€” All chat-related permissions
  • hyperperms.* β€” All HyperPerms permissions
  • * β€” Every permission (use with extreme caution!)

Permission Values

Permissions can be:

  • true β€” Grants the permission
  • false β€” 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

PermissionDescriptionDefault
hytale.buildPlace and break blockstrue
hytale.interactUse doors, buttons, leverstrue
hytale.container.accessOpen chests, barrels, etc.true
hytale.item.pickupPick up dropped itemstrue
hytale.item.dropDrop items from inventorytrue
hytale.vehicle.useMount horses, boats, etc.true

Chat & Communication

PermissionDescriptionDefault
hytale.chatSend messages in chattrue
hytale.chat.colorUse color codes in chatfalse
hytale.chat.formatUse formatting (bold, italic)false
hytale.chat.linksPost clickable linksfalse
hytale.msgSend private messagestrue
hytale.broadcastSend server-wide announcementsfalse

Movement & Teleportation

PermissionDescriptionDefault
hytale.teleport.homeTeleport to home locationtrue
hytale.teleport.spawnTeleport to world spawntrue
hytale.teleport.playerTeleport to other playersfalse
hytale.teleport.coordsTeleport to coordinatesfalse
hytale.flyEnable flight modefalse
hytale.speedChange movement speedfalse

Moderation Permissions

Permissions for staff members managing players.

Player Management

PermissionDescriptionRecommended For
hytale.kickKick players from serverModerator
hytale.banPermanently ban playersAdmin
hytale.ban.temporaryIssue temporary bansModerator
hytale.unbanRemove player bansAdmin
hytale.muteMute players in chatModerator
hytale.unmuteRemove player mutesModerator
hytale.warnIssue warnings to playersHelper

Server Monitoring

PermissionDescriptionRecommended For
hytale.see.hiddenSee vanished playersModerator
hytale.see.ipView player IP addressesAdmin
hytale.logs.viewAccess server logsAdmin
hytale.reports.viewView player reportsModerator

Administrative Permissions

High-level permissions for server administrators.

Server Control

PermissionDescriptionRecommended For
hytale.reloadReload server configurationAdmin
hytale.stopStop the serverOwner
hytale.maintenanceToggle maintenance modeAdmin
hytale.whitelistManage server whitelistAdmin

World Management

PermissionDescriptionRecommended For
hytale.world.createCreate new worldsOwner
hytale.world.deleteDelete worldsOwner
hytale.world.loadLoad/unload worldsAdmin
hytale.world.importImport external worldsAdmin
hytale.world.teleportTeleport between worldsAdmin

Game Control

PermissionDescriptionRecommended For
hytale.gamemodeChange own gamemodeAdmin
hytale.gamemode.othersChange others' gamemodeAdmin
hytale.time.setChange world timeModerator
hytale.weather.setChange world weatherModerator

HyperPerms Plugin Permissions

Permissions specific to managing HyperPerms itself.

Group Management

PermissionDescription
hyperperms.group.createCreate new groups
hyperperms.group.deleteDelete groups
hyperperms.group.editModify group settings
hyperperms.group.listView all groups
hyperperms.group.infoView group details
hyperperms.group.*All group permissions

User Management

PermissionDescription
hyperperms.user.editModify user permissions
hyperperms.user.infoView user permission info
hyperperms.user.promotePromote users on tracks
hyperperms.user.demoteDemote users on tracks
hyperperms.user.*All user permissions

System Permissions

PermissionDescription
hyperperms.adminFull HyperPerms access
hyperperms.reloadReload configuration
hyperperms.editorAccess web editor
hyperperms.debugUse 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.

HyperPerms Team

HyperPerms Documentation

Related Articles