Hytale World config.json Server Configuration

We continually strive to improve our knowledge base so that our customers have access to the most relevant and up-to-date information. We highly value your suggestions and feedback — if you feel something should be added or corrected, please let us know on our Discord server.

Open a support ticket on our Discord server to let us know how we can improve.

Warning

The server must be stopped while editing world files. Save your edits and restart the server for any changes to take effect.

Each world on your Hytale server has its own config.json file that controls how that world behaves independently of the main server settings. This guide covers every value in the world-level config.json that is currently safe to modify.

Editing your world configuration through the official NexLink Core admin dashboard is quick and easy. Follow the steps below to edit the file efficiently.

Open the File Manager tab inside your admin dashboard.
Navigate to universe/worlds/[world name]/ and open the config.json file for the world you want to edit.
Make your edits and click Save Content, then safely restart your server to apply the changes.

Default World config.json

The default file looks like this. Use it as a reference for structure and formatting:

{
  "Version": 4,
  "UUID": {
    "$binary": "UXud2lAwQ92OamDPRC1CjQ==",
    "$type": "04"
  },
  "Seed": 1776285926988,
  "WorldGen": {
    "Type": "Hytale",
    "Name": "Default",
    "Version": "0.0.0"
  },
  "WorldMap": {
    "Type": "WorldGen"
  },
  "ChunkStorage": {
    "Type": "Hytale"
  },
  "ChunkConfig": {},
  "IsTicking": true,
  "IsBlockTicking": true,
  "IsPvpEnabled": false,
  "IsFallDamageEnabled": true,
  "IsGameTimePaused": false,
  "GameTime": "0001-01-01T05:30:00Z",
  "ClientEffects": {
    "SunHeightPercent": 100.0,
    "SunAngleDegrees": 0.0,
    "BloomIntensity": 0.30000001192092896,
    "BloomPower": 8.0,
    "SunIntensity": 0.25,
    "SunshaftIntensity": 0.30000001192092896,
    "SunshaftScaleFactor": 4.0
  },
  "RequiredPlugins": {},
  "IsSpawningNPC": true,
  "IsSpawnMarkersEnabled": true,
  "IsAllNPCFrozen": false,
  "GameplayConfig": "Default",
  "IsCompassUpdating": true,
  "IsSavingPlayers": true,
  "IsSavingChunks": true,
  "SaveNewChunks": true,
  "IsUnloadingChunks": true,
  "IsObjectiveMarkersEnabled": true,
  "DeleteOnUniverseStart": false,
  "DeleteOnRemove": false,
  "DisabledFluidTickers": [],
  "ResourceStorage": {
    "Type": "Hytale"
  },
  "Plugin": {}
}

Tip

Only the settings documented below are currently safe to change. Any keys not listed either have no effect on the server yet or should be left at their default values.

World Identity

Config Name:	Description
`Seed`	The seed used to generate this world. Changing this on an already-generated world will have no effect on existing chunks.
`WorldGen` > `Name`	The display name of the world. This is the name shown in-game, for example when teleporting between worlds. It does not rename the folder.

World Simulation

Config Name:	Description
`IsTicking`	Enables or disables world ticks. Disabling this will effectively pause the world. Defaults to `true`.
`IsBlockTicking`	Enables or disables block ticks. Defaults to `true`.

Gameplay Rules

Config Name:	Description
`IsPvpEnabled`	Enables player-versus-player combat in this world. Defaults to `false`.
`IsFallDamageEnabled`	Enables or disables fall damage for players in this world. Defaults to `true`.

Time of Day

Config Name:	Description
`IsGameTimePaused`	If `true`, in-game time is frozen at the value set in `GameTime`. Defaults to `false`.
`GameTime`	The current time of day in the world, in ISO-8601 format — for example `0001-01-01T05:30:00Z`. `0001-01-01` is the in-game date (`YYYY-MM-DD`), the `T` separates the date from the time, `05:30:00` is the time (`HH:MM:SS`, 24-hour), and the trailing `Z` indicates Zulu / UTC (no offset).

NPCs

Config Name:	Description
`IsSpawningNPC`	Enables or disables NPC spawning in the world. Defaults to `true`.
`IsSpawnMarkersEnabled`	Enables or disables NPC spawn markers. Defaults to `true`.
`IsAllNPCFrozen`	If `true`, every NPC in the world is frozen in place. Defaults to `false`.

Saving & Persistence

Config Name:	Description
`IsSavingPlayers`	Enables or disables saving of player data for this world. Defaults to `true`. Disabling this is not recommended on a live server, as player progress will be lost.
`IsSavingChunks`	Enables or disables saving of modified chunks to disk. Defaults to `true`. Disabling this will cause all terrain edits to be lost on restart.
`SaveNewChunks`	Determines whether newly generated chunks are written to disk. Defaults to `true`. Disabling this keeps only pre-existing chunks persistent.
`IsUnloadingChunks`	Enables or disables chunk unloading when no players are nearby. Defaults to `true`. Disabling this will increase memory usage over time.

Markers

Config Name:	Description
`IsObjectiveMarkersEnabled`	Enables or disables the display of objective markers. Defaults to `true`.

World config.json Example

Tip

JSON does not support comments, so every key you do not want applied must be removed from the file rather than commented out however we do not recommend removing any entry in the config.json. Keep a backup before making large changes.

{
  "Version": 4,
  "UUID": {
    "$binary": "UXud2lAwQ92OamDPRC1CjQ==",
    "$type": "04"
  },
  "Seed": 1776285926988,
  "WorldGen": {
    "Type": "Hytale",
    "Name": "Default",
    "Version": "0.0.0"
  },
  "WorldMap": {
    "Type": "WorldGen"
  },
  "ChunkStorage": {
    "Type": "Hytale"
  },
  "ChunkConfig": {},
  "IsTicking": true,
  "IsBlockTicking": false,
  "IsPvpEnabled": false,
  "IsFallDamageEnabled": true,
  "IsGameTimePaused": false,
  "GameTime": "0001-01-01T05:30:00Z",
  "ClientEffects": {
    "SunHeightPercent": 100.0,
    "SunAngleDegrees": 0.0,
    "BloomIntensity": 0.30000001192092896,
    "BloomPower": 8.0,
    "SunIntensity": 0.25,
    "SunshaftIntensity": 0.30000001192092896,
    "SunshaftScaleFactor": 4.0
  },
  "RequiredPlugins": {},
  "IsSpawningNPC": true,
  "IsSpawnMarkersEnabled": true,
  "IsAllNPCFrozen": false,
  "GameplayConfig": "Default",
  "IsCompassUpdating": true,
  "IsSavingPlayers": true,
  "IsSavingChunks": true,
  "SaveNewChunks": true,
  "IsUnloadingChunks": true,
  "IsObjectiveMarkersEnabled": true,
  "DeleteOnUniverseStart": false,
  "DeleteOnRemove": false,
  "DisabledFluidTickers": [],
  "ResourceStorage": {
    "Type": "Hytale"
  },
  "Plugin": {}
}

Warning

The world config.json must remain valid JSON at all times. A single missing comma, quote, or brace will prevent the world from loading. If a world fails to load after an edit, validate the file with a JSON linter before contacting support.