Server administration

Introduction

Hytale server settings can be managed in two ways:

  1. Easy Configurations – Adjust essential settings like server name, MOTD, and password directly via the Server Options page.

    Example of a few common settings you can change

    Example of a few common settings you can change


  2. Intermediate Configurations – Customize deeper server behaviour (game modes, player limits, view radius, etc.) by editing the config.json file via File Manager.

    Do not change the ServerName, MOTD or Password from the config.json directly. Use the “Easy Configurations” method for those.


    Example of settings you would change via the config.json directly

    Example of settings you would change via the config.json directly


Reading time: 5–10 min


Prerequisites / Disclaimers

  • Access to the Game Panel

  • Permission to modify server settings

  • Familiarity with JSON for intermediate configurations

Changes in Server Options usually take effect after a restart. Editing config.json requires careful attention to JSON syntax to avoid server startup errors.


Easy Configurations – Server Options

1. Open Startup Options

  1. Log in to your Game Panel

  2. Navigate to:

    Server Options → Startup Options

  3. You will see fields for Server Name, Message of the Day (MOTD), and Server Password.


2. Configure Server Name

  1. Locate Server Name

  2. Enter the desired name (e.g., My Cool Server)

  3. This is displayed to players in the server browser.


3. Configure Message of the Day (MOTD)

  1. Locate Message of the Day

  2. Enter a short welcome or info message (e.g., Welcome to my cool server!)

  3. This appears to players when they join the server.


4. Set Server Password

  1. Locate Server Password

  2. Enter a secure password if you want restricted access

  3. Leave blank for public access.


5. Apply Changes

  1. Click Save or Apply

  2. Restart the server to apply changes

Easy configurations are recommended for all admins for quick adjustments.


Intermediate Configurations – File Manager

For advanced control of server behaviour, you can edit the config.json file directly.

1. Open File Manager

  1. Log in to your Game Panel

  2. Navigate to:

    Tools → File Manager

  3. Locate the file:

/home/container/config.json

2. Open config.json

  1. Open config.json for editing

  2. This file contains settings such as TPS, view radius, garbage collection, and more


3. Key Configuration Options

MaxViewRadius is significant. If you are suffering from performance issues please reduce this from 32 to 10 in order to improve the player experience.

Editing these allows for fine-tuning performance and gameplay experience.

Setting

Value / Type

Description

MaxPlayers

6 (integer)

Maximum concurrent players allowed on the server. Higher values increase load. (Hytale Server Manual)

MaxViewRadius

10 (integer)

Maximum server‑side view (in chunks) each player sees; affects performance.

LocalCompressionEnabled

false (boolean)

Toggles compression for local connections; usually off by default.

Defaults.World

"default" (string)

Default world name new players spawn into.

Defaults.GameMode

"Adventure" (string)

Default game mode applied at player join.

ConnectionTimeouts.JoinTimeouts

{} (object)

Custom join timeouts per context (empty here).

RateLimit

{} (object)

Rate limiting config (empty so defaults apply; protects from flooding).

Modules.PathPlugin.Modules

{} (object)

Nested modules config; here no sub-modules defined.

LogLevels

{} (object)

Custom log level overrides; empty means use defaults.

Mods

{} (object)

Mod/plugin config; empty means no mods enabled.

DisplayTmpTagsInStrings

false (boolean)

Controls whether temporary tag values appear in output strings.

PlayerStorage.Type

"Hytale" (string)

Player data persistence provider type (default disk-based).


4. Save and Apply Changes

  1. Save config.json after editing

  2. Restart the server to apply your new settings

  3. Monitor server logs for errors — incorrect JSON syntax may prevent the server from starting


End

Use Easy Configurations for quick changes like server name, MOTD, or password. Use Intermediate Configurations when fine-tuning server performance, player limits, or view radius. Both methods together provide full control over your Hytale server.


See our offers!

Check out our offers today! - Click here


Need support?

Raise a support ticket for any enquiries or issues. - Click here