How to Create a Hytale Server Guide: Difference between revisions

From Survival Servers
Jump to navigation Jump to search
No edit summary
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
Creating a Hytale game server is an easy process that can be done from either a dedicated server or your home computer. Alternatively, you can choose a [https://www.survivalservers.com/services/game_servers/hytale/ Hytale server host] that will fit your needs.
Creating a Hytale game server is an easy process that can be done from either a dedicated server or your home computer. Alternatively, you can choose a [https://www.survivalservers.com/services/game_servers/hytale/ Hytale server host] that will fit your needs.
'''Note:''' Hytale has not yet released its public dedicated server download at the time of writing. This guide explains the general process and will be updated with exact filenames and URLs once the official server package and documentation are live.


== Option #1: Renting a Hytale server (see example control panel below!) ==
== Option #1: Renting a Hytale server (see example control panel below!) ==
Line 16: Line 14:
* High-clock dedicated hardware (no VPS)
* High-clock dedicated hardware (no VPS)
* NVMe SSD storage
* NVMe SSD storage
* DDoS protection
* DDoS protection configured for UDP/QUIC traffic
* Full FTP / SFTP file access
* Full FTP / SFTP file access
* Multiple worldwide locations and the ability to switch locations at any time
* Multiple worldwide locations and the ability to switch locations at any time


== Option #2: Creating a Hytale Server From Your Home Computer or Dedicated Server ==
== Option #2: Host Your Own Hytale Server ==
 
This option is for advanced users who want to host Hytale directly on their own hardware.
 
=== Server Requirements (expected) ===
 
Hytale’s developers have confirmed that:
 
* The '''game client''' will launch on Windows first.
* The '''dedicated server''' runs wherever a supported Java runtime (Java 21+/25) is available (for example most Linux distros and Windows).
 
Exact minimum specs will be provided by Hypixel Studios, but for planning purposes you should assume at least:
 
; Operating System
: A 64-bit operating system. For example:
:* Windows 10/11 64-bit
:* A modern 64-bit Linux distribution (Ubuntu, Debian, etc.) – recommended for dedicated servers
 
; CPU
: 64-bit quad-core processor or better (modern Intel / AMD). Higher clock speed helps a lot for large or busy servers.
 
; Memory (RAM)
: For small private servers (friends & family):
:* 4 GB RAM dedicated to the Hytale server (plus extra for the OS)
: For public or heavily modded servers:
:* 6–8 GB+ dedicated to the Hytale server


; Disk space
Want to run your own Hytale server at home or on your own hardware? This guide will walk you through everything step by step.
: At least 10–20 GB free space is recommended to allow for world growth and backups.


; Java
{{#ev:youtube|VaU4HarMbp8|640|center}}
: A 64-bit Java runtime capable of running Java 21+/25 (for example a current OpenJDK build), unless the official Hytale dedicated server download bundles its own Java runtime.


When Hytale publishes official system requirements and server docs, update this section with their exact recommendations.
=== What You'll Need ===


== Step 1: Fetching Game Server Files ==
==== Computer Requirements ====


Once Hytale releases the dedicated server package, you will obtain it from the official Hytale website or launcher.
{| class="wikitable"
|-
! What !! Minimum !! Recommended
|-
| RAM || 4 GB || 6-8 GB
|-
| CPU || Modern 64-bit processor || Quad-core or better
|-
| Storage || 10 GB free space || 20+ GB SSD
|-
| Operating System || Windows 10/11 or Linux (64-bit) || Same
|}


A typical workflow will look like this:
==== Software Requirements ====


# Go to the official Hytale website (https://hytale.com) or follow the in-game / launcher instructions for downloading the dedicated server.
* '''Java 25''' - This is required to run the server. Download it free from [https://adoptium.net/ Adoptium]
# Download the '''Hytale dedicated server''' archive for your operating system (for example a .zip or .tar.gz file).
# Create a folder for your server. Example locations:
#: '''Windows:''' <code>C:\HytaleServer\</code>
#: '''Linux:''' <code>/home/hytale/server</code>
# Extract the downloaded server archive into this folder.
# Run the server once (for example by double-clicking the JAR or using a basic <code>java -jar</code> command) so it can generate its configuration and EULA files.
# If an EULA file is created (for example <code>eula.txt</code>), open it and change <code>eula=false</code> to <code>eula=true</code> after reading and agreeing to the terms.


'''Important:''' The actual filenames (for example <code>hytale-server.jar</code> vs <code>server.jar</code>) and folder structure will be defined by Hypixel Studios. Always follow the official documentation for the exact names.
To check if Java is installed correctly, open Command Prompt (Windows) or Terminal (Linux/Mac) and type:
<pre>java --version</pre>


== Step 2: Setting up a Hytale Dedicated Server Start Script ==
You should see something like:
<pre>openjdk 25.0.1 2025-10-21 LTS</pre>


To make starting the server easier, you can create a simple script.
=== Step 1: Get the Server Files ===


=== Windows (.bat file) ===
There are two ways to get the Hytale server files:


# In your Hytale server folder, create a new text file and name it something like <code>StartHytaleServer.bat</code>.
'''Method A: Copy from your Hytale game installation (easiest for beginners)'''
# Edit the file and add a line similar to:


<pre>
# Install and run the Hytale Launcher on your computer
@echo off
# Navigate to your Hytale installation folder:
java -Xms4096M -Xmx4096M -jar hytale-server.jar --nogui
#* '''Windows:''' <code>%appdata%\Hytale\install\release\package\game\latest</code>
pause
#* '''Linux:''' <code>~/.local/share/Hytale/install/release/package/game/latest</code>
</pre>
#* '''Mac:''' <code>~/Application Support/Hytale/install/release/package/game/latest</code>
# Copy the <code>Server</code> folder and <code>Assets.zip</code> to wherever you want to run your server


* Replace <code>hytale-server.jar</code> with the exact server JAR name from the official download.
'''Method B: Use the Hytale Downloader tool (best for keeping updated)'''
* Adjust <code>-Xms</code> / <code>-Xmx</code> to match the amount of RAM you want to allocate (for example 2048M for 2 GB).


Save the file and double-click it to start your server.
# Download the [https://downloader.hytale.com/hytale-downloader.zip Hytale Downloader] from the official download site
# Extract and run the downloader - it will prompt you to authenticate with your Hytale account
# The downloader fetches the latest server files and makes updating easy when new versions release


=== Linux (.sh file) ===
=== Step 2: Start the Server for the First Time ===


# In your Hytale server folder, create a new file named <code>start-hytale-server.sh</code>.
# Create a new folder for your server (example: <code>C:\HytaleServer</code>)
# Add:
# Place the server files (<code>Server</code> folder and <code>Assets.zip</code>) in this folder
# Open Command Prompt or Terminal in that folder
# Run this command:
<pre>java -jar Server\HytaleServer.jar --assets Assets.zip</pre>
On Linux/Mac, use forward slashes: <code>java -jar Server/HytaleServer.jar --assets Assets.zip</code>


<pre>
The server will start up and create all its configuration files. You'll see text scrolling in the window as it loads.
#!/bin/bash
java -Xms4096M -Xmx4096M -jar hytale-server.jar --nogui
</pre>


# Make it executable:
=== Step 3: Authenticate Your Server ===


<pre>
Before players can join, you need to link your server to your Hytale account:
chmod +x start-hytale-server.sh
</pre>


# Start the server with:
# In the server console, type: <code>/auth login device</code>
# You'll see a code and a link appear
# Open the link in your web browser and enter the code
# Log in with your Hytale account
# Once approved, you'll see "Authentication successful!" in the console


<pre>
Your server is now ready to accept players!
./start-hytale-server.sh
</pre>


Again, replace <code>hytale-server.jar</code> and memory flags as appropriate.
=== Step 4: Set Up Port Forwarding (Required for Friends to Join) ===


== Step 3: Port Forwarding and Firewall Rules ==
'''Important:''' Hytale uses '''UDP port 5520''' by default. This is different from many games that use TCP.


Hytale uses a modern networking stack (QUIC on top of UDP). The exact default port number will be documented by the developers in the server configuration.
==== If you're hosting at home: ====


General steps:
# Find your computer's local IP address (usually starts with 192.168)
# Log into your router's admin page (usually http://192.168.1.1 or http://192.168.0.1)
# Find the Port Forwarding section
# Add a new rule:
#* '''Protocol:''' UDP (not TCP!)
#* '''External Port:''' 5520
#* '''Internal Port:''' 5520
#* '''Internal IP:''' Your computer's local IP
# Save the settings


# Locate the '''port''' setting in the Hytale server configuration file (for example <code>server.yml</code> or <code>server.json</code>). Make note of the port number.
If you need help with your specific router, [https://portforward.com/ PortForward.com] has guides for most router models.
# On the server’s operating system firewall (Windows Firewall, ufw, firewalld, etc.), create an incoming rule to allow traffic on that port over UDP (and any other protocols Hytale requires, per the official docs).
# On your router, set up port forwarding from the internet to your server machine’s local IP address on the same port and protocol.
# If you are unsure how to port forward, [https://portforward.com/ PortForward.com] has guides for many router models.


If your players still cannot connect, check:
==== Firewall Settings ====


* That the server is actually running and listening on the expected port.
You may also need to allow the port through your firewall:
* That your ISP is not blocking inbound traffic on that port.
* That no additional firewall (for example antivirus firewall) is blocking the connection.


== Configuring your Hytale Game Server ==
'''Windows:'''
# Open Windows Defender Firewall
# Click "Advanced settings"
# Click "Inbound Rules" then "New Rule"
# Select "Port" > "UDP" > enter "5520"
# Allow the connection and give it a name like "Hytale Server"


Once your server is running, you will see configuration and world files generated in the server folder.
'''Linux (ufw):'''
<pre>sudo ufw allow 5520/udp</pre>


The exact names and formats (for example <code>server.yml</code>, <code>config.json</code>, etc.) will be provided by Hytale’s official documentation, but in general you can expect to configure:
=== Step 5: Allocate More RAM (Optional but Recommended) ===


* Server name / MOTD (how the server appears to players)
By default, Java might not use enough memory. To give your server more RAM, use these flags when starting:
* Maximum players
* World seed and world settings
* Difficulty and gameplay rules
* Logging, backups, and performance settings


Typical workflow:
{| class="wikitable"
|-
! Your Available RAM !! Command to Use
|-
| 4 GB || <code>java -Xms3G -Xmx3G -jar Server\HytaleServer.jar --assets Assets.zip</code>
|-
| 6 GB || <code>java -Xms5G -Xmx5G -jar Server\HytaleServer.jar --assets Assets.zip</code>
|-
| 8 GB || <code>java -Xms7G -Xmx7G -jar Server\HytaleServer.jar --assets Assets.zip</code>
|}


# Stop the server.
'''Tip:''' Always leave about 1 GB for Windows/Linux to use.
# Open the main configuration file in a text editor (for example Notepad++ or VS Code).
# Change your settings (server name, max players, etc.).
# Save the file and restart the server.


Survival Servers customers can edit most of these options directly via the web control panel without editing files by hand.
=== Create a Start Script (Makes Life Easier) ===


== Locating and Joining your Server ==
Instead of typing the command every time, create a script file:


Once Hytale’s multiplayer UI is finalized, there will generally be two ways to join:
'''Windows - Create <code>start.bat</code>:'''
<pre>@echo off
java -Xms4G -Xmx4G -jar Server\HytaleServer.jar --assets Assets.zip
pause</pre>


# '''Direct IP'''
'''Linux - Create <code>start.sh</code>:'''
#:* Start the Hytale client.
<pre>#!/bin/bash
#:* Select the option to join by IP / direct connect.
java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip</pre>
#:* Enter your server’s IP address or hostname (and port, if different from the default).
Then make it executable: <code>chmod +x start.sh</code>
#:* Connect.


# '''Server browser (after it is implemented)'''
Double-click the script to start your server!
#:* Open the in-game server browser.
#:* Search or filter by name, tags, or region to find your server.
#:* Click to join.


If you cannot find or join your server:
== Understanding Your Server Files ==


* Verify the server is running (no crash in the console).
After running the server, you'll see these folders and files:
* Double-check your IP/hostname and port.
* Ensure your firewall and router port-forwarding rules are correct.
* Ask a friend on a different network to test connecting to rule out local issues.


== Location of World Save Data ==
{| class="wikitable"
|-
! File/Folder !! What It Does
|-
| <code>Server/</code> || Contains HytaleServer.jar (the server executable)
|-
| <code>Assets.zip</code> || Game assets required by the server
|-
| <code>config.json</code> || Main server settings (server name, max players, etc.)
|-
| <code>universe/</code> || Your world saves and player data
|-
| <code>mods/</code> || Put mod files here to add them to your server
|-
| <code>logs/</code> || Server logs for troubleshooting
|-
| <code>bans.json</code> || List of banned players
|-
| <code>whitelist.json</code> || List of allowed players (if whitelist is enabled)
|-
| <code>permissions.json</code> || Player permissions and ranks
|}


Your world data will be stored in one or more folders inside your Hytale server directory. Common patterns in other games are folders named <code>world</code>, <code>worlds</code>, or similar.
'''Important:''' Always stop your server before editing configuration files!


After you have started the server at least once, check your server folder for:
=== Step 5: Changing any Server Settings ===


* A world save folder (for example <code>world/</code>)
You can find your server.json in the root directory as well as a server.json in the /universe/worlds/Orbis/server.json - more details here:
* Backups (if you or your hosting provider enable them)


Make regular backups of your world folder to avoid data loss in case of corruption or hardware failure.
* [[Hytale_Advanced_Server_Configuration|Hytale: Advanced Server Configuration]]


Survival Servers provides automated backup options directly from the control panel.
== Quick Reference ==


== Tools ==
{| class="wikitable"
|-
! Task !! Command
|-
| Start server (basic) || <code>java -jar Server\HytaleServer.jar --assets Assets.zip</code>
|-
| Start with 4GB RAM || <code>java -Xms4G -Xmx4G -jar Server\HytaleServer.jar --assets Assets.zip</code>
|-
| Use a different port || <code>java -jar Server\HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:25565</code>
|-
| See all options || <code>java -jar Server\HytaleServer.jar --help</code>
|}


Hytale is being built with powerful creator tools:
== Tips for Better Performance ==


* '''In-game world editing and prefabs''' for fast building and world design.
* '''Lower view distance''' - The default view distance uses a lot of RAM. Consider reducing it in your config if you have performance issues
* A '''Blockbench plugin''' for creating and animating models.
* '''Use an SSD''' - Solid state drives help the server load chunks faster
* Server-side modding via plugins and asset packs, with the server code planned to be shared-source after release.
* '''Monitor your resources''' - Watch CPU and RAM usage while players are online to understand what your server needs
* Official documentation and examples (GitBook, tutorials) planned by the Hytale team.
* '''Keep Java updated''' - Always use Java 25 as recommended by Hytale


As Hytale’s official modding and server documentation is released, this section will be expanded with:
== See Also ==


* Links to official docs and APIs
* [Hytale Advanced Server Configuration]
* Recommended tools and workflows for running modded Hytale servers
* [[How to Join a Hytale Server]]
* Best practices for backups, performance tuning, and security
* [[How to Install Mods on a Hytale Server]]
* [https://hytale.com/ Official Hytale Website]
* [https://support.hytale.com/ Hytale Support & Documentation]


__NOTOC__
__NOTOC__

Latest revision as of 06:39, 15 January 2026

Creating a Hytale game server is an easy process that can be done from either a dedicated server or your home computer. Alternatively, you can choose a Hytale server host that will fit your needs.

Option #1: Renting a Hytale server (see example control panel below!)

Renting from a professional game server provider is the fastest and easiest way to get online. Survival Servers handles hardware, network, DDoS protection, and updates for you.

Control panel.gif
Hytale game server.png

With a rented Hytale server from Survival Servers you get:

  • Custom control panel (start/stop/restart, config editor, backups)
  • High-clock dedicated hardware (no VPS)
  • NVMe SSD storage
  • DDoS protection configured for UDP/QUIC traffic
  • Full FTP / SFTP file access
  • Multiple worldwide locations and the ability to switch locations at any time

Option #2: Host Your Own Hytale Server

Want to run your own Hytale server at home or on your own hardware? This guide will walk you through everything step by step.

What You'll Need

Computer Requirements

What Minimum Recommended
RAM 4 GB 6-8 GB
CPU Modern 64-bit processor Quad-core or better
Storage 10 GB free space 20+ GB SSD
Operating System Windows 10/11 or Linux (64-bit) Same

Software Requirements

  • Java 25 - This is required to run the server. Download it free from Adoptium

To check if Java is installed correctly, open Command Prompt (Windows) or Terminal (Linux/Mac) and type: 

java --version

You should see something like: 

openjdk 25.0.1 2025-10-21 LTS

Step 1: Get the Server Files

There are two ways to get the Hytale server files:

Method A: Copy from your Hytale game installation (easiest for beginners)

  1. Install and run the Hytale Launcher on your computer
  2. Navigate to your Hytale installation folder:
    • Windows: %appdata%\Hytale\install\release\package\game\latest
    • Linux: ~/.local/share/Hytale/install/release/package/game/latest
    • Mac: ~/Application Support/Hytale/install/release/package/game/latest
  3. Copy the Server folder and Assets.zip to wherever you want to run your server

Method B: Use the Hytale Downloader tool (best for keeping updated)

  1. Download the Hytale Downloader from the official download site
  2. Extract and run the downloader - it will prompt you to authenticate with your Hytale account
  3. The downloader fetches the latest server files and makes updating easy when new versions release

Step 2: Start the Server for the First Time

  1. Create a new folder for your server (example: C:\HytaleServer)
  2. Place the server files (Server folder and Assets.zip) in this folder
  3. Open Command Prompt or Terminal in that folder
  4. Run this command:
java -jar Server\HytaleServer.jar --assets Assets.zip

On Linux/Mac, use forward slashes: java -jar Server/HytaleServer.jar --assets Assets.zip

The server will start up and create all its configuration files. You'll see text scrolling in the window as it loads.

Step 3: Authenticate Your Server

Before players can join, you need to link your server to your Hytale account:

  1. In the server console, type: /auth login device
  2. You'll see a code and a link appear
  3. Open the link in your web browser and enter the code
  4. Log in with your Hytale account
  5. Once approved, you'll see "Authentication successful!" in the console

Your server is now ready to accept players!

Step 4: Set Up Port Forwarding (Required for Friends to Join)

Important: Hytale uses UDP port 5520 by default. This is different from many games that use TCP.

If you're hosting at home:

  1. Find your computer's local IP address (usually starts with 192.168)
  2. Log into your router's admin page (usually http://192.168.1.1 or http://192.168.0.1)
  3. Find the Port Forwarding section
  4. Add a new rule:
    • Protocol: UDP (not TCP!)
    • External Port: 5520
    • Internal Port: 5520
    • Internal IP: Your computer's local IP
  5. Save the settings

If you need help with your specific router, PortForward.com has guides for most router models.

Firewall Settings

You may also need to allow the port through your firewall:

Windows:

  1. Open Windows Defender Firewall
  2. Click "Advanced settings"
  3. Click "Inbound Rules" then "New Rule"
  4. Select "Port" > "UDP" > enter "5520"
  5. Allow the connection and give it a name like "Hytale Server"

Linux (ufw): 

sudo ufw allow 5520/udp

Step 5: Allocate More RAM (Optional but Recommended)

By default, Java might not use enough memory. To give your server more RAM, use these flags when starting:

Your Available RAM Command to Use
4 GB java -Xms3G -Xmx3G -jar Server\HytaleServer.jar --assets Assets.zip
6 GB java -Xms5G -Xmx5G -jar Server\HytaleServer.jar --assets Assets.zip
8 GB java -Xms7G -Xmx7G -jar Server\HytaleServer.jar --assets Assets.zip

Tip: Always leave about 1 GB for Windows/Linux to use.

Create a Start Script (Makes Life Easier)

Instead of typing the command every time, create a script file:

Windows - Create start.bat: 

@echo off
java -Xms4G -Xmx4G -jar Server\HytaleServer.jar --assets Assets.zip
pause

Linux - Create start.sh: 

#!/bin/bash
java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip

Then make it executable: chmod +x start.sh

Double-click the script to start your server!

Understanding Your Server Files

After running the server, you'll see these folders and files:

File/Folder What It Does
Server/ Contains HytaleServer.jar (the server executable)
Assets.zip Game assets required by the server
config.json Main server settings (server name, max players, etc.)
universe/ Your world saves and player data
mods/ Put mod files here to add them to your server
logs/ Server logs for troubleshooting
bans.json List of banned players
whitelist.json List of allowed players (if whitelist is enabled)
permissions.json Player permissions and ranks

Important: Always stop your server before editing configuration files!

Step 5: Changing any Server Settings

You can find your server.json in the root directory as well as a server.json in the /universe/worlds/Orbis/server.json - more details here:

Quick Reference

Task Command
Start server (basic) java -jar Server\HytaleServer.jar --assets Assets.zip
Start with 4GB RAM java -Xms4G -Xmx4G -jar Server\HytaleServer.jar --assets Assets.zip
Use a different port java -jar Server\HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:25565
See all options java -jar Server\HytaleServer.jar --help

Tips for Better Performance

  • Lower view distance - The default view distance uses a lot of RAM. Consider reducing it in your config if you have performance issues
  • Use an SSD - Solid state drives help the server load chunks faster
  • Monitor your resources - Watch CPU and RAM usage while players are online to understand what your server needs
  • Keep Java updated - Always use Java 25 as recommended by Hytale

See Also


Retrieved from "https://www.survivalservers.com/wiki/index.php?title=How_to_Create_a_Hytale_Server_Guide&oldid=3279"