How to Configure Advanced Server Settings in Hytale

Master Your Hytale Server

This complete guide covers everything from basic configuration to advanced multi-server architectures. Whether you are setting up your first server or optimizing a production environment, you will find expert-level instructions here.

Difficulty

Intermediate

Time

15 Minutes

Configuration File Locations

Your Hytale server uses several JSON configuration files to manage its behavior. Understanding where these files are located is the first step toward effective server management.

Server Root Directory

File	Purpose	When to Edit
`config.json`	Main server settings	Server name, slots, view distance
`permissions.json`	Player permissions & admin groups	Adding admins, setting roles
`bans.json`	Banned player list	Banning/unbanning players
`whitelist.json`	Allowed players (if enabled)	Private server access

World-Specific Configuration

Location	Purpose
`universe/worlds/[WorldName]/config.json`	Individual world settings (PvP, spawning, effects)

Editing Your Configuration

Follow these steps to safely modify your server files.

Safety First

Always create a backup of your server files before making changes.
Stop your server completely before editing any configuration files. Changes made while the server is running will be overwritten.

How to Edit Files

Game Panel (Recommended)
Manual Editing

The easiest way to manage your files is through the FREAKHOSTING Game Panel.

Stop Server

Navigate to the Console and click Stop.

Open File Manager

Go to the Files tab in the sidebar.

Edit File

Locate the JSON file you wish to modify, click on it to open the editor, make your changes, and click Save Content.

Start Server

Return to the Console and click Start.

Server Configuration (config.json)

The main config.json controls your server core behavior. This is the primary file for customization.

Settings Overview

Setting	Description
`ServerName`	The name displayed in the server browser.
`MaxPlayers`	The maximum number of simultaneous players.
`MaxViewRadius`	Controls how many chunks are sent to players (impacts performance).

Advanced Architecture

Multi-Server Support

Hytale features built-in multi-server support, meaning you do not need an external proxy like BungeeCord or Velocity.

Network Protocol

Hytale uses the QUIC protocol over UDP instead of traditional TCP. Ensure your firewall is configured to allow UDP traffic on your server ports.

Performance Tuning: JVM Flags

For high-traffic servers, adjusting launch arguments can improve stability.

-XX:+UseG1GC: Recommended garbage collector for Hytale.
-Xms and -Xmx: Set your minimum and maximum RAM allocation.

World Pre-Generation

Eliminate exploration lag by pre-generating your world chunks before players join. This significantly reduces CPU strain during gameplay.

Need Extra Help?

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

Live Chat: Quick assistance via our website.
Support Ticket: Open a Ticket
Discord: Join our Community
Email: support@freakhosting.com

Save on Your Hosting

Ready to get a new server? Use code KB20 at checkout for 20% off your first month!

Last Updated: January 2026 | Hytale: Advanced Configuration Guide.

World Configuration (Per-World Settings)

Each world has independent settings stored in universe/worlds/[WorldName]/config.json. These allow you to customize gameplay mechanics per dimension or world instance.

Gameplay Settings

Setting	Default	Description
`Seed`	Random	The world generation seed.
`IsPvpEnabled`	false	Enables or disables player combat.
`IsFallDamageEnabled`	true	Controls if players take damage from falling.
`IsGameTimePaused`	false	Freezes the day/night cycle.
`IsSpawningNPC`	true	Enables natural NPC spawning.
`IsAllNPCFrozen`	false	Freezes all NPC AI.

Performance & Save Settings

Setting	Default	Description
`IsTicking`	true	Controls if world physics are active.
`IsBlockTicking`	true	Controls if block updates are active.
`IsSavingPlayers`	true	Enables saving of player data.
`IsSavingChunks`	true	Enables saving of terrain changes.
`SaveNewChunks`	true	Caches new terrain as it is generated.
`IsUnloadingChunks`	true	Frees unused memory by unloading distant chunks.
`DeleteOnUniverseStart`	false	Wipes the world on every restart (use with extreme caution).

Visual Effects (ClientEffects)

Effect	Default	Description
`SunIntensity`	0.25	Adjusts the brightness of the sun.
`BloomIntensity`	0.3	Controls the strength of the glow effect.
`BloomPower`	8.0	Adjusts the sharpness of the bloom effect.
`SunshaftIntensity`	0.3	Controls the strength of “God rays”.

World Pre-Generation

Pre-generating terrain before players explore eliminates chunk generation lag during gameplay. This is highly recommended for production servers.

Method 1: Manual Exploration

Best for small maps or quick setups.

Start your server and join as an admin.
Enable fly mode.
Fly around the map; chunks will save automatically as they are rendered.

Method 2: Pre-Generation Mods

Best for large worlds and automated generation.

Download a pre-generation mod and place it in the mods/ folder.
Configure the radius and center coordinates.
Execute the generation command provided by the mod.

Method 3: Built-in Command Line

Check for native options using:

java -jar HytaleServer.jar --help

Server Mesh Architecture

Hytale features built-in multi-server support, allowing you to transfer players between servers without an external proxy like BungeeCord.

Transferring Players

You can use the native Java API to move players smoothly:

// Send a player to another server
PlayerRef.referToServer(host, port, payload)

// Handle incoming player connections
PlayerSetupConnectEvent.referToServer(host, port)

Security Alert

Referral payloads pass through the client and can be modified. Always sign payloads using HMAC with a shared secret key so the receiving server can verify authenticity.

Launch Options & Performance

JVM Memory Flags

For optimal stability, allocate enough RAM to your Hytale instance. We recommend setting the initial and maximum RAM to the same value to prevent performance dips during allocation.

Flag	Example	Purpose
`-Xms`	`-Xms6G`	Initial RAM allocation.
`-Xmx`	`-Xmx6G`	Maximum RAM allocation.
`-XX:+UseG1GC`	â€”	G1 Garbage Collector (recommended for low-latency).

Server Launch Options

Flag	Description
`--assets <path>`	Game assets location (e.g., `Assets.zip`).
`--bind <ip:port>`	Bind to a specific network interface.
`--auth-mode <mode>`	`authenticated` (online) or `offline` (LAN).
`--backup`	Enables automatic world backups.
`--backup-frequency <mins>`	Time between backups in minutes.

Need Extra Help?

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

Live Chat: Quick assistance via our website.
Support Ticket: Open a Ticket
Discord: Join our Community
Email: support@freakhosting.com

Save on Your Hosting

Ready to get a new server? Use code KB20 at checkout for 20% off your first month!

Last Updated: January 2026 | Hytale: Advanced Configuration Guide.

Getting Started

Popular Games

Survival Games

GTA & RDR Multiplayer

Racing & Simulation

Shooters

Sandbox & Building

Other Games

How to Configure Advanced Server Settings in Hytale

Master Your Hytale Server

Difficulty

Time

Configuration File Locations

Server Root Directory

World-Specific Configuration

Editing Your Configuration

Safety First

How to Edit Files

Server Configuration (config.json)

Settings Overview

Advanced Architecture

Multi-Server Support

Network Protocol

Need Extra Help?

Save on Your Hosting

World Configuration (Per-World Settings)

Gameplay Settings

Performance & Save Settings

Visual Effects (ClientEffects)

World Pre-Generation

Server Mesh Architecture

Transferring Players

Security Alert

Launch Options & Performance

JVM Memory Flags

Server Launch Options

Need Extra Help?

Save on Your Hosting

​Master Your Hytale Server

Difficulty

Time

​Configuration File Locations

​Server Root Directory

​World-Specific Configuration

​Editing Your Configuration

​Safety First

​How to Edit Files

​Server Configuration (config.json)

​Settings Overview

​Advanced Architecture

​Multi-Server Support

​Network Protocol

​Need Extra Help?

​Save on Your Hosting

​World Configuration (Per-World Settings)

​Gameplay Settings

​Performance & Save Settings

​Visual Effects (ClientEffects)

​World Pre-Generation

​Server Mesh Architecture

​Transferring Players

​Security Alert

​Launch Options & Performance

​JVM Memory Flags

​Server Launch Options

​Need Extra Help?

​Save on Your Hosting

Master Your Hytale Server

Configuration File Locations

Server Root Directory

World-Specific Configuration

Editing Your Configuration

Safety First

How to Edit Files

Server Configuration (config.json)

Settings Overview

Advanced Architecture

Multi-Server Support

Network Protocol

Need Extra Help?

Save on Your Hosting

World Configuration (Per-World Settings)

Gameplay Settings

Performance & Save Settings

Visual Effects (ClientEffects)

World Pre-Generation

Server Mesh Architecture

Transferring Players

Security Alert

Launch Options & Performance

JVM Memory Flags

Server Launch Options

Need Extra Help?

Save on Your Hosting