This page assumes a running server - if you are still setting one up, start with how to make a Hytale server.
Hytale Server Setup and Console Commands Guide
This comprehensive guide covers everything you need to know about setting up and managing a Hytale dedicated server following the Early Access launch on January 13, 2026. Learn about server requirements, port configuration, console commands, and admin management.
Default Port
UDP 5520 - Hytale uses QUIC protocol over UDP, not TCP
Java Version
Java 25 required for running HytaleServer.jar
Minimum RAM
4 GB for small servers (up to 16 players)
Server Requirements
| Component | Minimum | Recommended (50+ players) |
|---|---|---|
| CPU | 2 GHz dual-core | 3.5 GHz quad-core or higher |
| RAM | 4 GB | 8-16 GB |
| Storage | 20 GB SSD | 50 GB NVMe SSD |
| Java | Java 25 | Java 25 |
| Architecture | x64 or arm64 | x64 or arm64 |
| Network | 10 Mbps upload | 100 Mbps+ upload |
Setting up a Hytale server gives you full control over your world. You can choose to run it on your own hardware (DIY) or rent a high-performance server from a hosting provider.
Managed Hosting
Benefits: Instant setup, DDoS protection, 24/7 uptime.
Browse Hytale Server Plans →
Self-Hosted (DIY)
Benefits: Free, complete access to hardware.
Cons: Requires high-end CPU, port forwarding, and maintenance.
Server Installation
Step 1: Download Server Files
If you are setting up a Hytale dedicated server manually, download the official files from the Hytale website. Verify that your download includes:
- HytaleServer.jar - The main server executable
- Assets.zip - Game assets required for the server
Step 2: First Launch
Run the server with the following command:
java -jar HytaleServer.jar --assets Assets.zipThe first launch will:
- Generate configuration files
- Create world directories under
universe/worlds/ - Trigger authentication prompts
Step 3: Server Authentication
Your server must be authenticated with Hytale to allow player connections:
- Type
/auth login devicein the server console - A device code (e.g., ABCD-1234) will be displayed
- Go to accounts.hytale.com/device and enter the code
- Once validated, your server is officially authorized
Port Configuration
Important: Hytale uses the QUIC protocol over UDP, not TCP. Forwarding only TCP ports will prevent players from connecting.
Default Port
The default Hytale server port is UDP 5520.
Custom Port
To use a custom port, use the --bind argument:
java -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:25565Firewall Configuration (Windows)
New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action AllowFirewall Configuration (Linux)
# UFW
sudo ufw allow 5520/udp
# iptables
sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPTServer Launch Options
| Option | Description | Default |
|---|---|---|
--assets <path> | Path to Assets.zip, or an asset directory | ../HytaleAssets |
--bind <address:port> | Address and port to listen on | 0.0.0.0:5520 |
--auth-mode <mode> | Authentication mode (authenticated, offline or insecure) | authenticated |
--backup | Enable automatic backups | Disabled |
--backup-frequency <minutes> | Backup interval in minutes | 30 |
Console Commands
Note: Command names are not case-sensitive, so /setBlocks and /setblocks are the same command. In the server console the leading slash is optional.
Basic Commands (All Players)
| Command | Description |
|---|---|
/help | Display all available commands for your permission level |
/ping | Display network latency information |
/who | List all players currently on the server |
/whoami | Show your player details and permissions |
/emote <emote> | Execute an emote animation |
Admin Commands
| Command | Description |
|---|---|
/op add <player or UUID> | Grant operator (admin) status to a player |
/op remove <player or UUID> | Remove operator status from a player |
/kick <player> | Kick a player from the server |
/ban <player> [reason] | Ban a player from the server |
/unban <player> | Remove a player's ban |
/whitelist add <player> | Add a player to the whitelist |
/whitelist remove <player> | Remove a player from the whitelist |
Creative Mode Commands
| Command | Description |
|---|---|
/pos1, /pos2 | Set selection corners for editing |
/copy | Copy selected blocks to clipboard |
/cut | Cut selected blocks to clipboard |
/paste | Paste clipboard contents |
/rotate <degrees> | Rotate clipboard selection |
/flip <axis> | Flip clipboard selection |
/fillBlocks <pattern> (alias /fill) | Fill the air in the selection with the given block types |
/setBlocks <pattern> (alias /set) | Set every block in the selection to the given block type |
/clearBlocks (alias /clear) | Clear all blocks in the selection |
/undo <count> | Undo recent actions |
/redo <count> | Redo undone actions |
Teleportation Commands
| Command | Description |
|---|---|
/tp <player> | Teleport to another player |
/tp <x> <y> <z> | Teleport to coordinates |
/tp home | Teleport to your home location |
/tp top | Teleport to highest block above you |
/tp back [--count <n>] | Return to the previous teleport location |
/tp forward [--count <n>] | Go forward in your teleport history |
Environment Commands
| Command | Description |
|---|---|
/time set <hour 0-24> | Set world time; /time dawn, midday, dusk, midnight (aliases day, noon, night) jump to a period |
/time pause | Stop time progression |
/environment <environment> | Change the environment |
Server Directory Structure
server/
├── HytaleServer.jar # Main server executable
├── Assets.zip # Game assets
├── config.json # Main server configuration
├── permissions.json # Operators, groups and permission nodes
├── bans.json, whitelist.json # Access control
├── mods/ # Plugins (.jar files) and content packs
├── universe/
│ └── worlds/ # World data
│ └── default/ # named after Defaults.World in config.json
│ └── config.json # World-specific settings
└── logs/ # Server logsWorld Configuration
Each world has its own config.json under universe/worlds/ with settings for:
Seed: world generation seed (a new world gets one from the clock)IsPvpEnabled: player vs player, off by defaultIsFallDamageEnabled: fall damage, on by defaultGameMode,DefaultPermissionGroup,IsSpawningNPC,IsTicking,IsGameTimePaused,DaytimeDurationSecondsandNighttimeDurationSecondsGameplayConfig: custom gameplay rules, andCrashRecoveryfor what the world does after a crash
Most of these can also be changed while the server runs with /world settings, for example /world settings pvp or /world settings timepaused, and /world config seed shows the seed.
Performance Optimization
View Distance
The server default for MaxViewRadius in config.json is 32 chunks, and it accepts 1 to 32. Limiting maximum view distance to 12 chunks (384 blocks) is recommended for both performance and gameplay. This is equivalent to approximately 24 Minecraft chunks.
Memory Allocation
# Recommended for 16-30 players
java -Xms4G -Xmx8G -jar HytaleServer.jar --assets Assets.zip
# Recommended for 50+ players
java -Xms8G -Xmx16G -jar HytaleServer.jar --assets Assets.zipCommon Issues
Players Cannot Connect
- Check port forwarding: Ensure UDP 5520 is forwarded (not TCP)
- Firewall: Verify UDP port is open in your firewall
- Authentication: Confirm server is authenticated via
/auth login device
Permission Errors
If you see "You do not have permission to use this command":
- Grant yourself operator status from the server console with
op add <your_username>(or your UUID) - Or configure admin status in the permission files
Server Not Starting
- Verify Java 25 is installed:
java -version - Ensure Assets.zip is present and not corrupted
- Check logs directory for error messages
Pro Tip: Hytale supports native server routing mechanisms, so no reverse proxy like BungeeCord is required for multi-server setups.
Need a hassle-free Hytale server? Get a Hytale server from Supercraft with automatic setup, DDoS protection, and 24/7 support.