Hytale’s dedicated server runs as a Java .jar (for example, HytaleServer.jar) and includes a built-in command system for server administration, moderation, world control, and creative building tools.
This guide focuses on the commands you’ll actually use when hosting a server: authentication, whitelist, password (private servers), operator/permissions, kick/ban, teleport, and the most common selection/build commands.
Early Access note: command names and subcommands can change between builds. If a command works differently on your server, run
/helpor append--helpto the command to see the exact syntax available on your version.
How to run Hytale commands (chat vs server console)
All Hytale server commands can be run from either place:
-
In-game chat: open chat and type commands starting with a slash.
- Example:
/help
- Example:
-
Server console commands: type commands directly into your hosting panel's console or the server terminal. Hytale server console commands work with or without a leading
/. If you're unsure, include the/.
Get help (the most important command)
/help– list available commands/help <command>or<command> --help– show usage for a specific command
Example:
/tp --help
Server authentication (required for players to join)
Dedicated servers need to be authenticated before players can connect.
- Start the server.
- In the console, run:
/auth login device
Follow the on-screen device link/code to authorise the server.
Some hosting panels then prompt you to persist authentication so it survives restarts, for example:
/auth persistence Encrypted
If you see different options, follow your panel’s prompt or run /auth --help.
Operator access and permissions (admin commands)
Most Hytale server admin commands require operator access (OP) or permission nodes.
OP commands
Common patterns:
/op self– give yourself operator permissions/op add <player>– grant OP to another player/op remove <player>– revoke OP
Permissions
Hytale supports a permissions system (stored in permissions.json). The exact subcommands can vary, so use:
/perm --help
Useful checks:
/whoami– prints your player info (often includes permission/operator state)
Whitelist commands
A whitelist restricts who can join your server.
Enable / disable the whitelist
From console (or in-game as OP):
whitelist on(or/whitelist on) – enable whitelistwhitelist off(or/whitelist off) – disable whitelist
Add / remove players
whitelist add <username>(or/whitelist add <username>) – add a playerwhitelist remove <username>(or/whitelist remove <username>) – remove a player
Check the list
whitelist list(or/whitelist list) – list whitelisted playerswhitelist status(if available) – show whether the whitelist is currently enabled
Whitelist file
Whitelist data is also stored in whitelist.json.
- If you edit
whitelist.jsonmanually, stop the server first. Changes made while the server is running may be overwritten.
Password (private server) – how it really works
There is no standard /password set or /password remove command for Hytale dedicated servers.
To password-protect a server, set the password in server configuration (usually config.json or your hosting panel’s “Server Password” field), then restart the server.
Typical config.json example:
"Password": "YourPasswordHere"
To remove the password requirement, set it to an empty string (or clear the field in your panel), then restart.
Moderation commands (kick, ban, unban)
These are the commands most admins use day-to-day:
/who– list online players/kick <player> [reason]– kick a player/ban <player> [reason]– ban a player/unban <player>– unban a player
Bans are stored server-side (commonly in bans.json).
Server control commands (stop, save, restart)
These commands control the server itself:
/stop– stop the server gracefully (saves and shuts down)/saveor/save-all– force a world save without stopping the server/restart– restart the server (availability depends on your hosting setup)
Most hosting panels provide Restart and Stop buttons that are easier to use than console commands. If
/restartdoesn't work on your server, use your panel's restart button instead.
Player utility commands
These are handy for support, troubleshooting, and quick checks:
/whereami– prints your current location/ping– shows network ping information/tps– shows server TPS (performance)/seed– prints the world seed/gamemode <mode> [player]– change game mode (if enabled on your server)
Teleport and travel commands
Hytale teleport commands are extremely useful for admins and builders.
Teleport command (/tp)
The /tp command is the main Hytale teleport command:
/tp <x> <y> <z>– teleport yourself to coordinates/tp <player>– teleport yourself to another player/tp <player> <x> <y> <z>– teleport a player to coordinates/tp <player1> <player2>– teleport player1 to player2
Relative coordinates use ~:
/tp ~ ~10 ~– teleport 10 blocks upward/tp ~50 ~ ~– teleport 50 blocks in the X direction
Other teleport commands
/tpall– teleport all players to a location/top– teleport to the highest block above you/spawn– teleport to world spawn
How to set spawn in Hytale
To set the world spawn point (where players spawn when joining or after death):
/setspawn– set world spawn to your current location/setworldspawn– alternative command (check/helpfor availability)
Home commands (/sethome and /home)
Homes let players save personal teleport locations:
/sethome– set your home at your current location/sethome <name>– set a named home (e.g.,/sethome base)/home– teleport to your default home/home <name>– teleport to a named home (e.g.,/home base)/delhome <name>– delete a named home
Warp commands
Warps are server-wide teleport points set by admins:
/warp– manage named warp points
Warp syntax can vary by build (for example add, remove, list, go). Use:
/warp --help
World and environment commands
These commands affect time, weather, lighting, and world management.
Time
/time– show current world time/time <value>or/time set <value>– set time (depends on build)
Weather
/weather– manage weather
Lighting
/lighting– manage world lighting (and related debug/updates)
Worlds
/world– world-related management commandsworld setdefault <worldName>(or/world setdefault <worldName>) – set the default world
World storage is kept under the server’s universe/ folder. Each world typically has its own config file under universe/worlds/<WorldName>/config.json.
Building and selection commands (creative/admin tools)
Hytale includes powerful selection tools for building and editing structures.
Make a selection
Most selection-based tools use two corners:
/pos1– set first corner/pos2– set second corner
Clipboard and undo
/copy– copy selection/cut– cut selection/paste– paste clipboard/undo– undo last edit/redo– redo last undone edit
Fill / replace / clear
/fillblocks <pattern>– fill the selection with a block pattern/replace <from> <to>– replace one block type with another/clear– clear selection (often sets to Empty)
Resize / move the selection
/expand– expand selection/contract– shrink selection/move– move selection contents/shift– shift selection
Rotate / flip
/rotate– rotate clipboard/flip– flip clipboard
Prefabs
/prefab– save/load/list prefabs/editprefab– prefab editing commands
Because these commands can be destructive, it’s smart to test on a copy world or keep backups.
Complete Hytale server commands list
This is a quick reference list of the most-used Hytale commands for server administration:
| Category | Commands |
|---|---|
| Help | /help, /help <cmd>, <cmd> --help |
| Auth | /auth login device, /auth persistence Encrypted (if prompted) |
| OP & perms | /op self, /op add <player>, /op remove <player>, /perm --help, /whoami |
| Whitelist | /whitelist on, /whitelist off, /whitelist add <player>, /whitelist remove <player>, /whitelist list |
| Password | Set Password in config.json or panel (restart required) |
| Moderation | /who, /kick <player> [reason], /ban <player> [reason], /unban <player> |
| Server control | /stop, /save, /restart |
| Teleport | /tp, /tpall, /spawn, /setspawn, /sethome, /home, /top, /warp --help |
| World | /time, /weather, /lighting, /world, /world setdefault <world> |
| Building | /pos1, /pos2, /copy, /cut, /paste, /undo, /redo, /fillblocks, /replace, /clear, /expand, /contract |
Troubleshooting (when commands "don't work")
- "Unknown command": run
/helpand confirm the command exists on your build. - "You do not have permission to use this command": this means you need operator access or a specific permission node. Fix it by:
- Run
/op selffrom the server console to give yourself OP - Or have an existing admin run
/op add <yourname> - Or assign the specific permission node in
permissions.json
- Run
- "No permission": same as above – give yourself OP (
/op self) or assign the correct permission node with/perm. - Console vs chat mismatch: try adding or removing the leading
/depending on where you're running the command. - Edits not saving: if you manually edited
config.json,whitelist.json, orpermissions.json, make sure the server was stopped, then restart to apply changes.
About permissions.json
Hytale stores permission settings in permissions.json in your server directory. This file controls which players or groups can use specific commands. If you need fine-grained control beyond simple OP access, edit this file (with the server stopped) or use /perm commands in-game.