Hytale server commands list (admin and console)
Hytale server commands for admins, including /help, /stop, /op add, /auth, /maxviewradius, /spectate, /update, /discovery link, and the whitelist. Covers what works in Console vs in-game chat and how to find the commands your build supports.
Run /help in the server Console to list every command your build
supports, and /help <family> (for example /help whitelist) for a family's
subcommands and the permission each one needs. The commands admins use most
are /op add, /stop, /auth status, /maxviewradius, and /update status.
Commands can change between updates, and Chapter 1 (October 12) may change
some. If one isn't recognized, run /help in Console to see what your
build supports, and recheck after you
update your server.
Command reference
| Command | What it does |
|---|---|
/help | Lists the commands your build supports, with usage |
/stop | Shuts the server down cleanly. berrybyte's Stop button sends it |
/op add, /op remove | Grants or revokes operator access (how to add an admin) |
/maxviewradius | Reports or sets the maximum view distance (see below) |
/spectate | Opt-in spectator feature: toggle, watch, target, free, exit, plus an admin set. Has its own permissions |
/discovery link | Links the server to a Server Discovery listing. Copy the full command from the listing card |
| Whitelist commands | Grant or revoke hytale.server.join (enable a whitelist) |
Console runs commands as the server itself, so use it for the first grant,
/auth, /stop, and whitelist changes. In-game chat needs the matching
permission group or node, so it suits day-to-day moderation once you have
rights.
Auth commands
Run these from Console. Walkthrough: Authenticate a Hytale server.
| Command | What it does |
|---|---|
/auth login device | Device-code login (headless and berrybyte) |
/auth login browser | Browser PKCE login (needs a desktop session) |
/auth status | Shows whether the server is authenticated |
/auth cancel | Cancels an in-progress login |
/auth logout | Clears credentials and ends the session |
/auth persistence | Shows or sets credential storage (Memory or Encrypted) |
/auth select | Chooses a game profile when you have more than one |
View distance
/maxviewradius works in Console and counts in chunks. With no argument
it reports the cap, with a number from 1 to 512 it sets it, and reset
restores the official default of 32.
/maxviewradius 12
View distance is the main driver of RAM use, and the
Server Manual
recommends 12 chunks (384 blocks) or less. The same limit is MaxViewRadius in
server settings. For lag, see
fix Hytale server lag.
Update commands (self-hosted)
From the Server Manual, for the official wrapper:
| Command | What it does |
|---|---|
/update check | Checks for an update |
/update download | Downloads it to staging (--force re-downloads the current version) |
/update apply --confirm | Applies the staged update, then shuts down so the wrapper can swap files |
/update cancel | Deletes the staged update |
/update status | Shows the current version and update status |
/update patchline | Shows or sets the patchline |
/update setup | Writes the wrapper scripts to the parent directory |
On berrybyte, leave Auto Update on and restart instead. The host already pulls the jar and assets on boot.
Don't run /update apply --confirm on berrybyte unless support asks you to.
Kick, ban, and unban
The manual lists bans.json for banned players, but official notes don't
publish a fixed kick, ban, or unban signature. Run /help, find the family
your build ships, and copy the usage line it prints. If /help doesn't list
one, your build doesn't have it.
Older builds (Update 5)
Update 5 added in-game tab-complete with a suggestion UI (Tab and
Shift+Tab) and named /op the old full-access shortcut, with roles
preferred for friends. Update 6 added Console tab-complete, a formatted
Console /help, /spectate, and /maxviewradius, and migrates an
existing whitelist.json to whitelist.json.migrated.
Related guides
Frequently asked questions
Where is the full list of Hytale admin commands?
On your running server. Type /help in Console for the commands your build supports, or /help followed by a family such as whitelist for its subcommands. Commands change between updates, so run /help again after updating.
Why does a Hytale command work in Console but not in-game?
Console runs commands as the server itself. In-game chat needs the matching permission group or node, which the first owner doesn't have until someone grants it from Console with /op add.
How do I kick or ban a player on a Hytale server?
Run /help, find the kick, ban, and unban commands your build ships, and copy the usage line it prints. Official notes don't publish a fixed signature. Banned players are stored in bans.json.
How do I stop a Hytale server from the console?
Type /stop in Console. On berrybyte, the Stop button in the dashboard sends /stop for you.
How do I change view distance on a Hytale server with a command?
In Console, run /maxviewradius with a number from 1 to 512 to set the maximum view distance in chunks. With no argument it reports the cap, and reset restores the official default of 32. The Server Manual recommends 12 chunks or less.