> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Configure Advanced Server Settings in Hytale

> Master your Hytale server with our complete guide. Learn about advanced configuration, performance tuning, and multi-server setups for your hosting.

## 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.

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Intermediate
  </Card>

  <Card title="Time" icon="15 Minutes">
    15 Minutes
  </Card>
</CardGroup>

***

## 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.

<Warning>
  ### 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.
</Warning>

### How to Edit Files

<Tabs>
  <Tab title="Game Panel (Recommended)">
    The easiest way to manage your files is through the FREAKHOSTING Game Panel.

    <Steps>
      <Step title="Stop Server">
        Navigate to the **Console** and click **Stop**.
      </Step>

      <Step title="Open File Manager">
        Go to the **Files** tab in the sidebar.
      </Step>

      <Step title="Edit File">
        Locate the JSON file you wish to modify, click on it to open the editor, make your changes, and click **Save Content**.
      </Step>

      <Step title="Start Server">
        Return to the **Console** and click **Start**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manual Editing">
    If you are self-hosting or using SFTP.

    <Steps>
      <Step title="Stop Service">
        Ensure the server process is fully stopped.
      </Step>

      <Step title="Edit Locally">
        Open the file in a text editor like Notepad++ or VS Code.
      </Step>

      <Step title="Validate JSON">
        Use a tool like [JSONLint](https://jsonlint.com) to ensure your syntax is correct.
      </Step>

      <Step title="Restart">
        Save the file and start your server.
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## 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.

***

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="World Pre-Generation">
    Eliminate exploration lag by pre-generating your world chunks before players join. This significantly reduces CPU strain during gameplay.
  </Accordion>
</AccordionGroup>

***

<Note>
  ### 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](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

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

***

<div align="center">
  **Last Updated:** January 2026 | **Hytale:** Advanced Configuration Guide.
</div>

***

## 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.

<AccordionGroup>
  <Accordion title="Method 1: Manual Exploration">
    Best for small maps or quick setups.

    1. Start your server and join as an admin.
    2. Enable fly mode.
    3. Fly around the map; chunks will save automatically as they are rendered.
  </Accordion>

  <Accordion title="Method 2: Pre-Generation Mods">
    Best for large worlds and automated generation.

    1. Download a pre-generation mod and place it in the `mods/` folder.
    2. Configure the radius and center coordinates.
    3. Execute the generation command provided by the mod.
  </Accordion>

  <Accordion title="Method 3: Built-in Command Line">
    Check for native options using:

    ```bash theme={null}
    java -jar HytaleServer.jar --help
    ```
  </Accordion>
</AccordionGroup>

***

## 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:

```java theme={null}
// Send a player to another server
PlayerRef.referToServer(host, port, payload)

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

<Warning>
  ### 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.
</Warning>

***

## 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.             |

***

<Note>
  ### 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](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

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

***

<div align="center">
  **Last Updated:** January 2026 | **Hytale:** Advanced Configuration Guide.
</div>