Skip to main content
A Hytale server keeps its main settings in Server/config.json and each world’s settings in Server/universe/worlds/<world>/config.json. On a FREAKHOSTING server you edit config.json in Files with the server stopped (name, message of the day, password, view distance, game mode and default world). Start-up, update and backup options are on the Startup page and in the Start-up and backups section of Game settings. Changes apply when the server starts.

Before you start

  • Your server must be logged in to a Hytale account once, so it can download the game. If it never has, see getting started.
  • Make a backup before larger changes.

Configuration File Locations

You see these files and folders in Files or over SFTP. The game itself lives in the Server folder.
Hytale reads its config files when it starts and rewrites them when something changes in game, for example when permissions change. Edits you make to a file while the server is running are likely to be overwritten. Stop the server before you edit a file by hand.

Server Configuration (config.json)

The Server section of Game settings is not available for Hytale servers yet; edit config.json in the Server folder instead.
These are the main keys in Server/config.json and their defaults on a new server. MaxPlayers is written from Max Players on Startup every time the server starts, so a change you make by hand is undone. To change your player slots, upgrade your plan or contact support.

How to change a setting in config.json

1

Stop the server

Stop the server and wait until it shows as offline.
2

Open config.json

Click Files, open the Server folder and click config.json.
3

Change the value

Edit the key. Keep the quotes, colons and commas exactly as they are.
4

Save

Click Save Content. If you make a mistake, the file’s History lets you restore the version from before your save.
5

Start the server

Start the server. It reads the new value as it starts.
Example: a new name, a welcome message and the default world MyWorld.

Game settings: Start-up and backups

The Start-up and backups section of Game settings works on Hytale servers. “These are Startup settings of your server; changes apply when it starts.” Click Show advanced settings to see the rows marked advanced.
Pre-authentication and Players can make themselves operator are marked CAREFUL. With pre-authentication off, players are not verified. With self-op on, every player can then give themselves full operator rights.
Hytale Game settings page in the FREAKHOSTING Game Panel with the Start-up and backups section expanded and the Server section collapsed

The Start-up and backups section of Game settings

How to change a Start-up and backups setting

1

Open Game settings

Open your server in the Game Panel and click Game settings under GAME SETTINGS. Use Search settings to find a setting fast, or Changed to see only what you changed.
2

Change the value

Edit the setting in Start-up and backups. The row gets a CHANGED badge, and the bar at the bottom counts your changes, for example 1 unsaved change. Default puts the row back to its default.
3

Review and save

Click Review and save. The Review your changes dialog shows exactly what changes: “Settings from the Startup page are saved there; the server reads them when it starts.” Passwords and other secrets are hidden. Click Save changes.
4

Restart

The server uses the new value the next time it starts. Restart it when it suits you.
Review your changes dialog in the Hytale Game settings page showing a Startup setting change before Save changes

Review your changes before they are saved

Hytale is in early access, so settings can change between versions. A setting your version does not have is shown disabled.
Game settings may show the check config.json does not exist yet, even when your server has a Server/config.json. You can ignore it. Edit the file in Files as shown above.

World Configuration (Per-World Settings)

Each world has its own config.json in Server/universe/worlds/<world>/. It holds PvP, fall damage, NPC spawning, time and saving. See world settings: PvP and fall damage for every key and its default.

Startup settings explained

The Startup page shows the Startup Command, the Docker Image and the Variables: “Everything this egg lets you change about how the server starts.” Change a value, click away to save it, and restart.
Hytale Startup page in the FREAKHOSTING Game Panel with the Startup Command, the Docker Image and the first variables

The Startup page of a Hytale server

Backup Directory, Auto Update, Patchline, Server Version, Compact Object Headers and Max Players are only on the Startup page. The other variables are also in Game settings > Start-up and backups.

What are the best Hytale server settings?

More tips: optimise performance.

Frequently asked questions

Where is the Hytale config.json file?

In the Server folder. Open Files in the Game Panel and click Server. Each world also has its own config.json in Server/universe/worlds/<world>/.

Why is the Server section greyed out on Game settings?

The Server section of Game settings is not available for Hytale servers yet. Edit the same values in Server/config.json instead, with the server stopped.

Do I need a proxy like BungeeCord for a Hytale network?

No. Hytale can move players between servers itself. See multiserver networks.

How do I allocate more RAM to my Hytale server?

Your server uses the memory in your plan. To get more memory, open a ticket and we help you move to a plan with more RAM.

What port does a Hytale server use?

UDP 5520 by default. Use the address shown in the panel. See port and firewall.

Hytale server guide

Every Hytale page in one place.

World settings

PvP, fall damage and NPCs per world.

Optimise performance

View distance and memory.

Server password

Make your server private.

Startup variables

How the Startup page works.

Checked against the official Hytale Server Manual on 3 November 2026; panel steps tested on our Game Panel on 4 November 2026 (Hytale server, Game settings and Startup pages). Steps may differ slightly if the game changes.

Need Extra Help?

If you encounter any issues, our support team is ready to assist:

Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!

Last Updated: November 2026