Skip to content

World Config format

The worlds/.../config.json file contains global information about the world such as the time of day, the level generator used, and the seed.

JSON format

  • : Root object.
    • Version: The world config format used at the time of saving.
    • UUID: The worlds UUID stored in binary form encoded in base64.
      • $binary: The base64 encoded binary UUID value.
      • $type: The BSON binary type. Always 04 for UUID.
    • DisplayName: The name of this world as shown in-game.
    • Seed: The worlds seed.
    • SpawnProvider: Information for the world spawn point.
      • Id: Currently unknown. Always Global.
      • SpawnPoint: The players world spawn point and spawn rotation.
        • X: X position of the world spawn point.
        • Y: Y position of the world spawn point.
        • Z: Z position of the world spawn point.
        • Pitch: X rotation of the world spawn rotation.
        • Yaw: Y rotation of the world spawn rotation.
        • Roll: Z rotation of the world spawn rotation.
    • WorldGen: Information for the world generator used for this world.
      • Type: The id of the world generator to use. Either Hytale (v1) or HytaleGenerator (v2)
      • WorldStructure: The type of world/universe to generate. Doesn't exists if Type is Hytale.
      • Name: The type of world/universe to generate. Doesn't exists if Type is HytaleGenerator.
      • Version: Currently unknown. Always 0.0.0. Doesn't exists if Type is HytaleGenerator.
    • WorldMap: Currently unknown.
      • Type: Currently unknown. Always WorldGen.
    • ChunkStorage: The worlds chunk storage information.
      • Type: The worlds chunk storage type. Either Hytale or RocksDb.
    • ChunkConfig: Currently unknown.
    • IsTicking: true if the world ticks normally.
    • IsBlockTicking: true if blocks can get ticked. i.e: Crops growing.
    • IsPvpEnabled: true if PVP is enabled.
    • IsFallDamagedEnabled: true if fall damage is enabled.
    • IsGameTimePaused: true if the daynight cycle is paused.
    • GameTime: The current in-game date and time in the format: <yyyy>-<MM>-<dd>T<HH>:<mm>:<ss>Z. Example 0001-01-01T00:00:00Z.
    • ClientEffects: Information for different client effects.
      • SunHeightPercent: Controls how high the sun can get in the sky.
      • SunAngleDegrees: Controls the angle of the sun.
      • BloomIntensity: Controls the sun bloom effect intensity.
      • BloomPower: Controls the sun bloom effect power.
      • SunIntensity: Controls the brightness intensity of the sun.
      • SunshaftIntensity: Controls the brightness intensity of the sun shafts.
      • SunshaftScaleFactor: Controls the scale of the sun shafts.
    • RequiredPlugins: Currently unknown.
    • GameMode: The default gamemode for this world.
    • IsSpawningNPC: true if npcs can spawn in naturally.
    • IsSpawnMarkersEnabled: true if the world spawn point has a marker on the world map and compass.
    • IsAllNPCFrozen: true if all npcs have their AI paused.
    • GameplayConfig: Currently unknown. Always Default.
    • Death: Information for what happens when a player dies.
      • RespawnController: Controls where the player should respawn.
        • Type: The id of the respawn location type. Known types: HomeOrSpawnPoint.
      • ItemsLossMode: The inventory penalty on death mode. One of None = None, All = Drop All, or Configured = Partial Drop.
      • ItemsAmountLossPercentage: The percentage of the players resources loss on death. Only applies if ItemsLossMode is Configured.
      • ItemsDurabilityLossPercentage: The percentage of item durability loss on death. Only applies if ItemsLossMode is Configured.
    • DaytimeDurationSeconds: How long in seconds the day lasts. Doesn't exists if IsGameTimePaused is true.
    • NighttimeDurationSeconds: How long in seconds the night lasts. Doesn't exists if IsGameTimePaused is true.
    • IsCompassUpdating: true if the player's compass update.
    • IsSavingPlayers: true if changes to player data saves to disk.
    • IsSavingChunks: true if changes to chunks are saved to disk.
    • SaveNewChunks: true if newly generated chunks are saved to disk.
    • IsUnloadingChunks: true if chunks can be unloaded.
    • IsObjectiveMarkersEnabled: Currently unknown.
    • DeleteOnUniverseStart: true if this world should be deleted and regenerated when started.
    • DeleteOnRemove: Currently unknown.
    • ResourceStorage: Currently unknown.
      • Type: Currently unknown. Always Hytale.
    • Plugin: Information related to plugins, custom and built-in.
      • CreativeHub: Contains information related to the Creative mode hub.
        • StartupInstance: The initial instance used for the Creative mode hub. Always CreativeHub.

History

Early Access
2026.01.13-dcad8778f The world config format is introduced.