Hytale Permissions & Ranks Guide (Admin, OP, Groups)

This guide explains how to manage permissions on your Hytale server — including becoming an admin, creating rank groups, and configuring permissions.json for fine-grained access control.

---

Understanding Hytale Permissions

Hytale's permission system controls what actions players can perform on your server. It has two main components:

• User permissions — apply directly to a specific player
• Group permissions — bundled permissions assigned to multiple players at once

Each player is identified by their UUID (unique identifier), which you'll need when managing permissions.

---

How to Become Admin on a Hytale Server

There are two methods to get admin (operator) access:

Method 1: Using the Server Console (Quick)

The fastest way to give yourself admin:

1. Open your server console (hosting panel or terminal)
2. Run:

/op self

You should see: "You're now OP!"

To give another player OP:

/op add <username>

To remove OP:

/op remove <username>

Method 2: Editing permissions.json (Permanent)

For permanent admin access that survives restarts:

1. Stop your server (important — changes while running may be overwritten)
2. Open permissions.json in your server's root directory
3. Find your UUID (run /uuid in-game, or check server logs)
4. Add yourself to the OP group

Example permissions.json structure:

{
  "groups": {
    "op": {
      "permissions": ["*"]
    }
  },
  "users": {
    "06d8af17-a640-4cad-8b37-08e58820faab": {
      "groups": ["op"]
    }
  }
}

The "*" wildcard means the OP group has all permissions.

4. Save the file and start your server

Method 3: Temporary OP via Startup Flag

You can enable a temporary OP command by adding a flag to your server startup:

java -jar HytaleServer.jar --assets Assets.zip --allow-op

This makes the /op command available in the console. Once you've set up permissions.json, you can remove the flag.

Warning: This method is temporary. If you restart without --allow-op and haven't configured permissions.json, you'll lose admin access.

---

Finding Your UUID

Your UUID is required when editing permissions.json manually.

In-game:

/uuid

From server logs:
When a player joins, their UUID is logged. Check logs/ for entries like:

Player <username> (06d8af17-a640-4cad-8b37-08e58820faab) connected

---

Creating Ranks and Groups

Groups let you create ranks like Admin, Moderator, and Player with different permission levels.

Example: Three-Tier Rank System

{
  "groups": {
    "admin": {
      "permissions": ["*"]
    },
    "moderator": {
      "permissions": [
        "hytale.command.kick",
        "hytale.command.ban",
        "hytale.command.unban",
        "hytale.command.tp",
        "hytale.command.who"
      ]
    },
    "player": {
      "permissions": [
        "hytale.command.home",
        "hytale.command.sethome",
        "hytale.command.spawn"
      ]
    }
  },
  "users": {
    "your-uuid-here": {
      "groups": ["admin"]
    },
    "moderator-uuid-here": {
      "groups": ["moderator"]
    }
  }
}

Group Inheritance

Groups can inherit permissions from other groups. This means a Moderator can automatically have all Player permissions, and Admin can have all Moderator permissions.

Check /perm --help in-game for inheritance commands on your server version.

---

Assigning Players to Groups

Via Console/Chat

/perm user <uuid> group add <groupname>

Example:

/perm user 06d8af17-a640-4cad-8b37-08e58820faab group add moderator

Via permissions.json

Add the player's UUID to the users section:

"users": {
  "player-uuid-here": {
    "groups": ["moderator"]
  }
}

---

Common Permission Commands

Command	Description
/op self	Give yourself operator access
/op add <player>	Give another player OP
/op remove <player>	Remove OP from a player
/perm --help	Show permission command help
/whoami	Show your current permissions/groups
/uuid	Display your UUID

---

Common Permission Nodes

Permission nodes control access to specific commands. Here are commonly used ones:

Permission	Grants Access To
*	All permissions (wildcard)
hytale.command.kick	/kick command
hytale.command.ban	/ban command
hytale.command.tp	/tp command
hytale.command.time	/time command
hytale.command.weather	/weather command
hytale.command.gamemode	/gamemode command

Note: Permission node names may vary between Hytale versions. Use /perm --help to see available nodes on your server.

---

LuckPerms for Hytale (Advanced)

For larger servers or complex permission setups, LuckPerms is a popular permission management mod originally from Minecraft that's been adapted for Hytale.

LuckPerms Features

• Web Editor — manage permissions via browser interface
• Group inheritance — create complex rank hierarchies
• Contexts — apply permissions based on world, server, etc.
• Multi-server sync — share permissions across multiple Hytale servers

Installing LuckPerms

1. Download LuckPerms for Hytale from the official source
2. Place the .jar file in your mods/ folder
3. Restart your server
4. Configure via /lp commands or the web editor

LuckPerms is recommended for servers with many ranks or staff members.

---

permissions.json Location

The permissions file is located in your server's root directory:

permissions.json

Same location as config.json, whitelist.json, and HytaleServer.jar.

Important: Always stop the server before editing permissions.json. Changes made while the server is running may be overwritten when in-game permission commands are used.

---

Troubleshooting

"You do not have permission to use this command"

This means you need OP or a specific permission node:

1. Run /op self from the server console
2. Or have an existing admin run /op add <yourname>
3. Or add the permission node to your group in permissions.json

Changes to permissions.json not working

• Make sure the server was stopped before editing
• Check for JSON syntax errors (missing commas, brackets)
• Verify you're using the correct UUID
• Restart the server after saving changes

Can't find my UUID

• Run /uuid in-game
• Check server logs when you join
• Some hosting panels show player UUIDs in their player management interface

OP access lost after restart

If you used --allow-op temporarily, you need to either:

• Keep using the startup flag, or
• Configure permissions.json permanently (recommended)

---

Quick Reference

Task	Method
Quick admin access	/op self in console
Permanent admin	Edit permissions.json
Create ranks	Add groups to permissions.json
Assign player to rank	/perm user <uuid> group add <group>
Check your permissions	/whoami
Find your UUID	/uuid
Advanced management	Install LuckPerms mod

---

Related Guides

• Server Commands Guide — full command reference
• Whitelist & Password Setup — restrict server access
• How to Install Mods — for LuckPerms installation