Easy Minerals
A configurable ore generation mod for Minetest Game

------------------------------------------------------------

DESCRIPTION

Easy Minerals modifies ore generation in Minetest Game to resemble a Minecraft-style distribution.

It adjusts how common ores are and the heights at which they generate, making mining progression feel more familiar and balanced.

Designed for:
Minetest (Minetest Game / default)

------------------------------------------------------------

FEATURES

- Coal is common and appears at most heights
- Iron is common below surface level
- Copper is moderately common
- Gold is rare and found deeper underground
- Diamond is very rare and found deep underground
- Mese is extremely rare and found very deep

All values are fully configurable inside init.lua.

------------------------------------------------------------

HOW IT WORKS

The mod:

1. Clears previously registered ore definitions.
2. Registers new ore generation rules.
3. Uses configurable variables grouped at the top of the file.

Ore generation uses the "scatter" type with adjustable:

- Scarcity (rarity)
- Cluster size
- Ores per cluster
- Height range (y_min / y_max)

Changes only affect newly generated map chunks.

------------------------------------------------------------

INSTALLATION

1. Download the mod.
2. Place the "easy_minerals" folder inside your mods directory.
3. Enable it in your world settings.
4. Create a new world (recommended).

------------------------------------------------------------

CONFIGURATION

Open init.lua and edit the values inside the ORES table.

Example:

scarcity = 10
num_ores = 15
size = 4
y_max = 54
y_min = -31000

------------------------------------------------------------

UNDERSTANDING SCARCITY

Scarcity is cubed internally:

clust_scarcity = scarcity * scarcity * scarcity

Lower number = more common
Higher number = rarer

Example:
8  = common
20 = rare
24 = very rare

------------------------------------------------------------

COMPATIBILITY

- Compatible with Minetest Game (default).
- May conflict with other mods that modify ore generation.
- Only affects new terrain generation.

------------------------------------------------------------

