Ore Tweaker Mod — Configuration

Configuration Guide

Ore Tweaker uses a decentralized configuration system. Instead of one massive file, it reads multiple JSON files located in a specific data folder.

File Location

All configuration files are stored in your Minecraft instance folder under: ../config/oretweaker/data/

Upon first launch, the mod will populate this folder with template JSON files for vanilla ores. You can create new .json files in this folder to add custom generation rules for modded blocks.

JSON Structure

Each JSON file follows a specific format. Below is an example of a configuration for Diamond Ore:

{
 "ore": "minecraft:diamond_ore",
 "filler": "minecraft:stone",
 "minY": -64,
 "maxY": 16,
 "maxVeinSize": 8,
 "spawnRate": 7,
 "placement_type": "triangle",
 "biomeWhitelist": [],
 "biomeBlacklist": []
}

A massive excavated pit showing custom ore generation

Commands & Debugging

Ore Tweaker includes commands to help manage configurations without restarting the game in certain versions.

/oretweaker reload: Reloads the JSON configuration files from the disk. (Note: Due to Minecraft's internal engine changes, some 1.17+ versions may require a full game restart for world-gen changes to take effect).

Recommended Debugging Tool: World Stripper

For the best experience when testing your ore distributions, it is highly recommended to use the World Stripper mod. This utility allows you to instantly remove common terrain blocks (like Stone, Dirt, and Grass) to visualize the underground ore veins and verify that your spawnRate and minY/maxY settings are working as intended.