Skip to main content

Hytale FAQ

General Information​

The basic configuration of a Hytale server differs from the solutions known from Minecraft. The Hytale engine was designed to be fully modular, and all options are stored in human-readable JSON text files.

On this page, we have compiled answers to the most important questions regarding Hytale server management. You will learn how to edit the main config.json file, manage worlds in the universe/worlds directory, and handle basic technical challenges.

How to change the render distance on the server?​

The MaxViewRadius parameter in the main configuration file determines the view distance.

  1. Stop the server in the Console tab.
  2. Go to the Files tab.
  3. Open the config.json file and locate the "MaxViewRadius": line.
  4. Change the value to your desired number of chunks, for example "MaxViewRadius": 12.
  5. Save the file and restart the server by clicking START in the Console.

How to grant yourself administrator privileges on the server?​

Server management privileges are granted directly through the text panel.

  • Use the command: op add [player_name] in the Console tab.

Important: Do not use a forward slash / before commands in the console.

How to change the number of player slots on the server?​

The maximum player count is defined in the server's main network configuration file.

  1. Stop the server in the Console tab.
  2. Go to the Files tab.
  3. Open the config.json file and locate the "MaxPlayers": parameter.
  4. Enter your desired value, for example "MaxPlayers": 50.
  5. Save the changes and click START in the Console.

What to do if the server fails to start?​

In the event of a startup crash, you should verify the server logs.

  • Contact us on our Discord server in the appropriate channel.
  • Open a ticket directly in the client panel.
TIP

Always attach the latest log file located in the logs folder to every ticket.

How to reset the world on the server?​

Deleting the current world will force the engine to generate a new, clean map.

  1. Stop the server.
  2. Go to the Files tab.
  3. Enter the universe/worlds/ directory.
  4. Delete the folder containing your map (the default name is default).
  5. Start the server again.
WARNING:

This process is completely irreversible and permanently deletes player structures and progress. Before performing this operation, make sure you have an up-to-date backup.

How to manage the whitelist?​

Managing the allowed players list is done using commands entered directly into the server console.

CommandAction Description
whitelist enableEnables the whitelist and blocks entry for players not on the list
whitelist disableDisables the whitelist and allows any player to enter
whitelist add [player_name]Adds the selected player to the trusted list
whitelist remove [player_name]Removes the player from the allowed list
whitelist clearCompletely resets the list, removing all players from it
whitelist statusDisplays information on whether the restriction is currently active
whitelist listDisplays a list of all whitelisted users on the screen

How to set a custom MOTD (server description)?​

The server description is the text displayed on the server list directly in the users' in-game browser.

  1. Stop the server.
  2. Go to the Files tab and open config.json.
  3. Find the "MOTD": "" line and enter your text between the quotation marks, for example: "MOTD": "Server hosted on IceHost!".
  4. Save the changes and start the server.

What happens after changing the server plan?​

Upgrading or downgrading your hosting plan in our panel is completely safe.

  • All configuration files, installed modifications, and worlds from the universe directory remain untouched.
  • Only the physical machine resources dedicated to your instance will change: allocated RAM, NVMe disk space, and vCPU core limits.
  • Before confirming the plan change, we recommend performing a manual file backup as a precaution.

How to upload files larger than 100MB?​

Use an SFTP (Secure File Transfer Protocol) connection. SFTP allows you to safely and quickly transfer large files from your computer directly to the Hytale server. See the guide:
How to connect to SFTP?