Minecraft:Ore (feature)

An ore<ref>Template:Snap</ref><ref>Template:Snap</ref><ref>Template:Mcnet</ref> is a Minecraft:feature consisting of a natural deposit of Minecraft:ores or other blocks in the ground.

Generation

The ore feature has two types: ore blobs and scatter ores.

An ore blob is an ellipsoidal cluster of blocks. In the overworld, underground deposits of Minecraft:dirt and Minecraft:gravel are generated in this form, followed by the more precious ores, like Minecraft:coal, Minecraft:copper, Minecraft:iron, Minecraft:gold, Minecraft:redstone, Minecraft:diamond, Minecraft:emerald (in mountains biomes), and Minecraft:lapis lazuli. They can form only in stone, deepslate, Minecraft:andesite, Minecraft:diorite, Minecraft:granite, and Minecraft:tuffTemplate:Only (also in their polished variants Template:In, replacing parts of structures). Two or more ores can form next to each other and appear as an ore made of more than one material.

Each ore blob has a spawn size. The maximum number of generated blocks in a blob each spawn size corresponds to is shown in the table below:Template:Note

Spawn size	Max number of blocks
0	0
1	0
2	0
3	4
4	5
5	8
6	9
7	10
8	10
9	13
10	16
11	17
12	23
13	24
14	24
15	29
16	32
17	37
18	46
19	52
20	52
21	60
22	68
23	68
24	74
25	82
26	94
27	104
28	106
29	120
30	128
31	135
32	149
33	160
34	180
35	190
36	204
37	212
38	228
39	246
40	262
41	276
42	292
43	308
44	324
45	344
46	360
47	381
48	403
49	429
50	452
51	480
52	500
53	530
54	558
55	584
56	616
57	634
58	664
59	694
60	730
61	760
62	790
63	826
64	864

A scatter ore is a slightly dispersed cluster of blocks. Currently only ancient debris is generated in this form. Scatter ores also have a spawn size value. The maximum number of generated blocks in a scatter ore is just the spawn size.

There was also a deprecated ore type, which generates only one block in each generation attempt. It was used by emerald ore before 1.18.

List

Dimension	Block	Can replace
Overworld	Template:BlockLink Template:BlockLink (Only in Minecraft:lush caves) Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink (Only in Minecraft:mountains and Minecraft:windswept hills biomes) Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink (Only in Minecraft:mountains and Minecraft:windswept hills biomes) Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink	Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLinkTemplate:Only Template:BlockLinkTemplate:Only Template:BlockLinkTemplate:Only Template:BlockLink
	Template:BlockLinkTemplate:Only Template:BlockLinkTemplate:Only (Only in Minecraft:lush caves) Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLinkTemplate:Only Template:BlockLinkTemplate:Only Template:BlockLink (Only in Minecraft:mountain biomes and Minecraft:windswept hills biomes) Template:BlockLink Template:BlockLinkTemplate:Only Template:BlockLink Template:BlockLink (Only in Minecraft:mountain biomes and Minecraft:windswept hills biomes) Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink	Template:BlockLink Template:BlockLinkTemplate:Only
The Nether	Template:BlockLink	Template:BlockLinkTemplate:Only Template:BlockLinkTemplate:Only Template:BlockLink
	Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink	Template:BlockLink
	Template:BlockLink	Template:BlockLink Template:BlockLinkTemplate:Only

Overworld

Blocks	Spawn size	Spawn tries per chunk	Minimum height	Maximum height	Ore concentrate<ref group="note" name="distributionType">Ores generate using either uniform distribution, or triangle distribution. Uniform distribution have all ores spread in same frequency at any height, while triangle generate more frequent in center height.</ref>	Skipped when air exposed<ref group="note" name="exposeAir">When an ore block is about to be placed, if it is exposed to air then it has this chance of being skipped instead.</ref>	Biomes
Template:BlockLink	33	7	0	160	Template:Tc	0	All
Template:BlockLink	33	46	-64	256	Template:Tc	0	Template:BiomeLink
Template:BlockLink	33	14	-64	320	Template:Tc	0	All
Template:BlockLink	64	2	0	60	rowspan="2" Template:Tc	0	All
		Template:Frac	64	128
Template:BlockLink	64	2	0	60	rowspan="2" Template:Tc	0	All
		Template:Frac	64	128
Template:BlockLink	64	2	0	60	rowspan="2" Template:Tc	0	All
		Template:Frac	64	128
Template:BlockLink	64	2	-64	0	Template:Tc	0	All
Template:BlockLink Template:BlockLink	17	20	0	192	Template:Tc	0.5	All
		30	136	320	Template:Tc	0
		0Template:Only 20Template:Only	128	156	Template:Tc	0	Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink
Template:BlockLink Template:BlockLink	4	10	-64	72	Template:Tc	0	All
	9Template:Only 10Template:Only<ref>Template:Bug</ref>	10	-24	56	Template:Tc	0
		90	80	384	Template:Tc	0
Template:BlockLink Template:BlockLink	10	16	-16	112	rowspan="2" Template:Tc	0	Other
	20				Template:BiomeLink
Template:BlockLink Template:BlockLink	8	4	-64	15	Template:Tc	0	All
		8	-64	-32	Template:Tc
Template:BlockLink Template:BlockLink	7	2	-32	32	Template:Tc	0	All
		4	-64	64	Template:Tc	1
Template:BlockLink Template:BlockLink	9	4	-64	32	Template:Tc	0.5	All
		Template:Frac	-64	-48	Template:Tc	0.5	All
		50	32	256	Template:Tc	0	Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLinkTemplate:Only(Unused) Template:BiomeLinkTemplate:Only(Unused) Template:BiomeLinkTemplate:Only(Unused)
Template:BlockLink Template:BlockLink	4	7	-64	16	rowspan="3" Template:Tc	0.5	All
	8	4			1
	12	Template:Frac			0.7
	8	2	-64	-4	Template:Tc	0.5
Template:BlockLink Template:BlockLink	3	100	-16	480	Template:Tc	0	Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLinkTemplate:Only(Unused) Template:BiomeLinkTemplate:Only(Unused)
Template:BlockLink Template:BlockLink	9Template:Only 8Template:Only	14	-64Template:Only 0Template:Only	63Template:Only 64Template:Only	Template:Tc	0	Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLinkTemplate:Only(Unused) Template:BiomeLinkTemplate:Only(Unused)

The Nether

Blocks	Spawn size	Spawn tries per chunk	Minimum height	Maximum height	Ore concentrate<ref group="note" name="distributionType">Ores generate using either uniform distribution, or triangle distribution. Uniform distribution have all ores spread in same frequency at any height, while triangle generate more frequent in center height.</ref>	Skipped when air exposed<ref group="note" name="exposeAir">When an ore block is about to be placed, if it is exposed to air then it has this chance of being skipped instead.</ref>	Biomes
Template:BlockLink	33Template:Only 28Template:Only	4Template:Only 9Template:Only	27Template:Only 23Template:Only	36	Template:Tc	0	All
Template:BlockLink	14	16	10	117	rowspan="2" Template:Tc	0	Others
		32Template:Only 16Template:Only			Template:BiomeLink
Template:BlockLink	10	10	10	117	rowspan="2" Template:Tc	0	Others
		20Template:Only 10Template:Only			Template:BiomeLink
Template:BlockLink	3	1Template:Only 2Template:Only	8	24Template:Only 23Template:Only	Template:TcTemplate:Only UniformTemplate:Only	1	All
	2	1Template:Only 3Template:Only	8	119	Template:Tc
Template:BlockLink	12	12	0	31Template:Only 32Template:Only	Template:Tc	0	Template:BiomeLink
Template:BlockLink	33	2	5	41Template:Only 36Template:Only	Template:Tc	0	Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink
Template:BlockLink	33	2	5	31Template:Only 36Template:Only	Template:Tc	0	Template:BiomeLink Template:BiomeLink Template:BiomeLink Template:BiomeLink

Data values

ID

Template:El: Template:ID table Template:ID table

Template:El: Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table Template:ID table

Config

Template:Main Template:El:

<section begin="config"/>

• Template:Nbt
  • Template:Nbt Value between 0 and 64 (inclusive). Determines the size of the ore vein. Further details on the relationship between 'size' and the actual number of blocks comprising the ore vein is available here.
  • Template:Nbt Value between 0 and 1 (inclusive). The chance for the entire ore vein to be discarded if any constituent block is adjacent to an air block. Other non-solid blocks such as water do not count.
  • Template:Nbt (required, but can be empty) A list of targets.
    • Template:Nbt A target.
      • Template:Nbt A rule test to check the block to replace.
      • Template:Nbt The block to use.
        • Template:Nbt inherit/block state

Note that ore features (if allowed to generate in air) will not generate without a solid block nearby to act as the starting point. The ore feature does not necessarily have to intersect with this point, but the required distance does seem to scale with the ore size.<section end="config"/>

Template:Collapse <syntaxhighlight lang="json"> {

 "type": "minecraft:ore",
 "config": {
   "discard_chance_on_air_exposure": 0.5,
   "size": 4,
   "targets": [
     {
       "state": {
         "Name": "minecraft:diamond_ore"
       },
       "target": {
         "predicate_type": "minecraft:tag_match",
         "tag": "minecraft:stone_ore_replaceables"
       }
     },
     {
       "state": {
         "Name": "minecraft:deepslate_diamond_ore"
       },
       "target": {
         "predicate_type": "minecraft:tag_match",
         "tag": "minecraft:deepslate_ore_replaceables"
       }
     }
   ]
 }

} </syntaxhighlight> Template:Collapse

Gallery

Renders

• A blob of Minecraft:iron ore.
  A blob of Minecraft:iron ore.

Screenshots

• Multiple ores generated above an underground Minecraft:lava lake.
  Multiple ores generated above an underground Minecraft:lava lake.
• A Minecraft:coal ore generated underwater.
  A Minecraft:coal ore generated underwater.
• Multiple ore blobs in a cave. Minecraft:Diamond ore and Minecraft:redstone ore as well as Minecraft:coal ore and Minecraft:gold ore are visible in the distance.
  Multiple ore blobs in a cave. Minecraft:Diamond ore and Minecraft:redstone ore as well as Minecraft:coal ore and Minecraft:gold ore are visible in the distance.
• Magma ores.
  Magma ores.