Skip to content

How to Configure Item Loss on Death on a Hytale Server ​

You can configure whether and how many items players lose when they die. This setting is configured per world.

Note

Stop your server before making changes to configuration files, otherwise they will be overwritten by the server.

How to Configure Item Loss ​

  1. Stop the Server
    Stop your server via the management panel.

  2. Open the World Configuration
    Connect to your server via SFTP and navigate to:

    /universe/worlds/<worldname>/config.json
    /universe/worlds/<worldname>/config.json

    Replace <worldname> with the name of your world (e.g., default).

  3. Add Death Block
    Find the "GameplayConfig" line and add the Death block below it:

    json
    "Death": {
      "RespawnController": {
        "Type": "HomeOrSpawnPoint"
      },
      "ItemsLossMode": "None",
      "ItemsAmountLossPercentage": 0.0,
      "ItemsDurabilityLossPercentage": 0.0
    }
    "Death": {
      "RespawnController": {
        "Type": "HomeOrSpawnPoint"
      },
      "ItemsLossMode": "None",
      "ItemsAmountLossPercentage": 0.0,
      "ItemsDurabilityLossPercentage": 0.0
    }
  4. Start the Server
    Start your server for the changes to take effect.

Warning

The Death block does not exist by default in the config.json and must be added manually.

Available Settings ​

SettingDescription
ItemsLossMode"None" = keep items, "All" = lose all items, "Configured" = use percentages
ItemsAmountLossPercentagePercentage of items lost (0.0-100.0)
ItemsDurabilityLossPercentagePercentage of durability lost (0.0-100.0)

Examples ​

Keep all items (relaxed):

json
"Death": {
  "RespawnController": {
    "Type": "HomeOrSpawnPoint"
  },
  "ItemsLossMode": "None",
  "ItemsAmountLossPercentage": 0.0,
  "ItemsDurabilityLossPercentage": 0.0
}
"Death": {
  "RespawnController": {
    "Type": "HomeOrSpawnPoint"
  },
  "ItemsLossMode": "None",
  "ItemsAmountLossPercentage": 0.0,
  "ItemsDurabilityLossPercentage": 0.0
}

Lose all items (hardcore):

json
"Death": {
  "RespawnController": {
    "Type": "HomeOrSpawnPoint"
  },
  "ItemsLossMode": "All",
  "ItemsAmountLossPercentage": 100.0,
  "ItemsDurabilityLossPercentage": 0.0
}
"Death": {
  "RespawnController": {
    "Type": "HomeOrSpawnPoint"
  },
  "ItemsLossMode": "All",
  "ItemsAmountLossPercentage": 100.0,
  "ItemsDurabilityLossPercentage": 0.0
}

Lose 50% of items (balanced):

json
"Death": {
  "RespawnController": {
    "Type": "HomeOrSpawnPoint"
  },
  "ItemsLossMode": "Configured",
  "ItemsAmountLossPercentage": 50.0,
  "ItemsDurabilityLossPercentage": 25.0
}
"Death": {
  "RespawnController": {
    "Type": "HomeOrSpawnPoint"
  },
  "ItemsLossMode": "Configured",
  "ItemsAmountLossPercentage": 50.0,
  "ItemsDurabilityLossPercentage": 25.0
}

Note

With ItemsLossMode: "None" or "All", the percentage settings are ignored. Use "Configured" to apply the percentages.