How to make yourself admin (op) on a Hytale server
Make a player admin on a Hytale server by having them join once, then running /op add with their identifier in the server Console. In-game chat only works after the first grant. Covers permission groups, permissions.json, and failed grants.
To make a player admin on a Hytale server, have them join once, then run
/op add with their identifier in the server Console. /op remove takes
the access back. Use Console for the first grant, because in-game chat only
works for accounts that already have the permission.
/op add <player>
/op remove <player>
<player> is the identifier your build expects (a name or a UUID). Run
/help op to check, and copy it from the join line in Console.
Commands can change between updates, and Chapter 1 (October 12) may change
permissions. If one isn't recognized, run /help in Console to see what
your build supports, and recheck after you
update your server.
Steps
Authenticate the server
A dedicated server accepts players only after authentication.
Join with the account you want to promote
Its name or ID now shows in Console, so you don't have to guess which identifier the command wants. Need the address? See Join your Hytale server.
Run the grant from Console
On berrybyte, open the Console tab (self-hosters use the
dedicated-server console). Run /help op, then /op add with that
identifier. Have the player try an admin command in chat to confirm.
/op is the full-access shortcut. If /help shows a way to assign a
permission group, give the smallest group that covers the job instead.
Groups and permissions.json
Permissions are groups (roles) built from namespaced nodes, and groups can
inherit from each other. /help shows the permission each command needs.
permissions.json holds this configuration, next to config.json,
whitelist.json, and bans.json. Per the
Hytale Server Manual,
the server reads these files on startup and writes them when in-game actions
occur, so manual edits while it's running are likely overwritten. Use Console
commands while the server runs, or stop it before editing the file.
If the grant fails
| Symptom | Likely cause | Fix |
|---|---|---|
| Command unknown | Your build uses a different command family | Run /help and use what it lists |
| Player not found | They haven't joined, or the identifier doesn't match | Have them join, copy the ID from Console, retry |
| Works in Console, refused in chat | The in-game account lacks the permission | Grant from Console first |
Rights gone after a restart usually mean permissions.json was edited while
the server was online. Grant again from Console. Still stuck? Open a
support ticket with the Console
/help lines attached.
Older builds (Update 5 and 6)
Update 5 replaced gamemode-tied rights with groups, inheritance, and
namespaced nodes. It named /op the old full-access shortcut and said to
give friends a role instead. It also added in-game tab-complete and a
suggestion UI, which help once you have rights but don't bypass a missing
permission. Update 6 notes say Console /help prints a formatted list with
per-command usage. Official notes don't publish a fixed /op add
signature, so /help op is the source for arguments.
Related guides
Frequently asked questions
How do I op a player on a Hytale server?
Have the player join once so Console shows their identifier, then run /op add with it in the server Console. /op remove undoes it. Run /help op for the exact arguments.
How do I make myself admin on my own Hytale server?
Join the server, then run /op add with your own identifier from the Console. The first grant has to come from Console, because in-game chat only works for accounts that already have the permission.
Why did my Hytale admin command fail?
Usually the player hasn't joined, the name or ID doesn't match, your build doesn't ship the command, or the in-game account lacks the permission. Retry from Console once the player is online.
What is permissions.json on a Hytale server?
It's the permission configuration file next to config.json. The server reads it on startup and writes it when permission commands run, so edits made while it's running are likely overwritten. Stop the server first.
Should I give every trusted player full op on Hytale?
No. Permissions are groups with namespaced nodes, so you can grant only the commands someone needs. Use the smallest group that covers the job, and check /help for the exact permission names.