HytaleKit
OreGenerator

OreGenerator

by LYIVX

utility

OreGenerator is a data-driven ore generation framework for Hytale with per-zone and per-biome overrides. Add custom ores via JSON packs or Java plugins.

OreGenerator is a data-driven framework that lets you customize ore generation in Hytale. Whether you want to tweak existing ore distributions or add entirely new ores, this framework makes it possible through simple JSON configuration.

What Does This Mod Do?

OreGenerator provides a flexible system for controlling how ores spawn in your world. It supports per-zone and per-biome overrides, letting you fine-tune ore distribution for different areas of the map.

How It Works

  • The framework loads every Server/OreGeneration/*.json it finds in mods/packs
  • Each config maps replaceable rock blocks to ore variants
  • Zone/biome keys must match engine names (use /player zone to check)

Adding Ores via Pack (JSON Only)

  1. Create a pack with Server/OreGeneration/your_ore.json
  2. Drop the pack into mods/ and restart
  3. The framework auto-loads all configs from packs at startup

Adding Ores via Plugin (Java + JSON)

  1. Add the framework as a dependency in your plugin manifest: "LYIVX:OreGenerator": "*"
  2. Bundle your configs in src/main/resources/Server/OreGeneration/
  3. Optional: use config/OreGenerator/*.json to override configs at runtime

Configuration Example

{
  "defaults": {
    "surface": {
      "height": { "min": 60, "max": 120 },
      "veinsPerChunk": 2,
      "veinSize": { "min": 5, "max": 10 },
      "spawnChance": 0.8
    },
    "cave": {
      "height": { "min": 10, "max": 60 },
      "repeat": { "min": 15, "max": 20 },
      "veinSize": { "min": 5, "max": 10 },
      "spawnChance": 1.0
    }
  },
  "oreByBlock": {
    "Rock_Stone": "Ore_Coal_Stone",
    "Rock_Sandstone": "Ore_Coal_Sandstone"
  }
}

Height Distribution

  • height controls the min/max Y range
  • heightExponent controls vertical bias: 1.0 is uniform, > 1.0 skews lower, < 1.0 skews higher

Surface vs Cave Blocks

  • surface is the biome/overground pass (lower density, biome-tuned)
  • cave is the cave pass (repeat-style attempts, denser underground)

Who Is This Mod For?

OreGenerator is ideal for:

  • Mod developers adding custom ores to Hytale
  • Server admins wanting to adjust ore distribution
  • Pack creators building custom gameplay experiences