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.

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

Server Installation

Step 1: Download Server Files

Download the official Hytale dedicated server 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.zip

The 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:

1. Type /auth login device in the server console
2. A device code (e.g., ABCD-1234) will be displayed
3. Go to accounts.hytale.com/device and enter the code
4. Once validated, your server is officially authorized

Port Configuration

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:25565

Firewall Configuration (Windows)

New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

Firewall Configuration (Linux)

# UFW
sudo ufw allow 5520/udp

# iptables
sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

Server Launch Options

Option	Description	Default
--assets <path>	Path to Assets.zip file	Required
--bind <address:port>	Address and port to listen on	0.0.0.0:5520
--auth-mode <mode>	Authentication mode (authenticated/offline)	authenticated
--backup	Enable automatic backups	Disabled
--backup-frequency <minutes>	Backup interval in minutes	30

Console Commands

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 <player>	Grant operator (admin) status to a player
/deop <player>	Remove operator status from a player
/kick <player> [reason]	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 <block>	Fill selection with specified block
/setblocks <block>	Replace blocks in selection
/clearblocks	Clear all blocks in 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	Return to previous location
/tp forward <distance>	Teleport forward by distance

Environment Commands

Command	Description
/time set <value>	Set world time (day, night, noon, etc.)
/time freeze	Stop time progression
/environment <preset>	Change environment settings

Server Directory Structure

server/
├── HytaleServer.jar          # Main server executable
├── Assets.zip                # Game assets
├── config/                   # Server configuration files
│   └── config.json          # Main configuration
├── plugins/                  # Java plugins (.jar files)
├── mods/                     # Content packs
├── universe/
│   └── worlds/              # World data
│       └── world1/
│           └── config.json  # World-specific settings
└── logs/                     # Server logs

World Configuration

Each world has its own config.json under universe/worlds/ with settings for:

• Seed: World generation seed
• PvP: Enable/disable player vs player
• Fall Damage: Toggle fall damage
• Gameplay Config: Custom gameplay rules

Performance Optimization

View Distance

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.zip

Common 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 with /op <your_username>
• 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

Need a hassle-free Hytale server? Get a Hytale server from Supercraft with automatic setup, DDoS protection, and 24/7 support.