Ore Tweaker Mod — Guide
Features
Ore Tweaker offers a robust set of features for world-gen customization:
- Total Ore Control: Disable vanilla ore generation entirely or tweak existing ores to be more or less common.
- Custom Ore Creation: Turn any block (including modded blocks) into an "ore" that generates naturally in the world.
- Height Mapping: Define specific Y-levels for ore generation, fully supporting the expanded world height in 1.18+.
- Biome Filtering: Use whitelists or blacklists to restrict ores to specific biomes or biome categories (e.g., only in Mountains or Oceans).
- Dimension Support: Configure ores to generate in the Overworld, Nether, End, or any custom modded dimension.
- Template System: Automatically generates template files for all detected ores, making it easy to start tweaking immediately.
JSON Parameter Reference
The following table details every parameter available in the Ore Tweaker JSON files:
| Parameter | Type | Description |
|---|---|---|
ore |
String | The registry name of the block to generate (e.g., minecraft:iron_ore). |
filler |
String | The block that the ore replaces during generation (usually minecraft:stone or minecraft:deepslate). |
minY |
Integer | The minimum Y-level (height) where the ore can spawn. |
maxY |
Integer | The maximum Y-level (height) where the ore can spawn. |
maxVeinSize |
Integer | The maximum number of ore blocks in a single vein. |
spawnRate |
Float | The number of attempts the game makes to spawn a vein in each chunk. |
placement_type |
String | (1.18+ only) Determines the distribution pattern: uniform or triangle. |
biomeWhitelist |
List | A list of biome IDs or Forge BiomeDictionary tags where the ore is allowed to spawn. |
biomeBlacklist |
List | A list of biome IDs or Forge BiomeDictionary tags where the ore is forbidden from spawning. |
Distribution Types (1.18+)
In Ore Tweaker 3 (Minecraft and higher), the mod supports the new vanilla distribution mechanics. You must specify a placement_type to define how ores are spread across the Y-levels.
Uniform Distribution
Ores have an equal chance of spawning at any height between minY and maxY. This is the classic distribution style used in older versions of Minecraft.
Triangle (Trapezoid) Distribution
Ores are most common at the center of the minY and maxY range, with the spawn frequency tapering off as you move toward the edges. This is used in vanilla 1.18 for ores like Diamond and Lapis Lazuli to create "sweet spots" for mining.