Feature generation/1.21.1-0.5 Alpha 2: Difference between revisions

Content deleted Content added

Inline

Latest revision as of 12:20, 15 October 2026

This page covers Voluminous Energy's feature generation for the 0.5 Alpha 2 releases: 1.21.1-0.5 Alpha 2, 26.1.2-0.5 Alpha 2 and 26.2-0.5 Alpha 2 (all NeoForge, released 12 October 2026). The tables show the 1.21.1-0.5 Alpha 2 data.

Alpha 2 adds:

Crude Oil and Natural Gas reservoirs: large underground bodies of oil or gas laid out like vanilla aquifers,
Crude Oil and Natural Gas caves: small cave systems completely filled with oil or gas,
Bituminous Sand, Bituminous Red Sand and Bituminous Gravel: the blocks that seal reservoirs, petroleum caves and oil lakes. They can be crushed for Bitumen.

It also changes the Crude Oil lakes:

Surface lakes are now ringed with bituminous blocks.
Underground lakes are now sealed pockets completely filled with Crude Oil (ve_fluid_deposit_feature). They are never placed where they would break into a cave or aquifer, and they only generate between Y -32 and 47 (previously anywhere from -64 to 320).

The ore blob and ore deposit settings are unchanged from 0.5 Alpha 1.

Release	Difference
1.21.1-0.5 Alpha 2	The petroleum cave carvers are added at the `air` carving step.
26.1.2-0.5 Alpha 2, 26.2-0.5 Alpha 2	Carvers no longer have a step in Minecraft 26.1+, so the modifier only lists the carvers.
26.2-0.5 Alpha 2	The core of Cinnabar deposits is vanilla's `minecraft:cinnabar` block (same as 26.2 Alpha 1).

Petroleum reservoirs

See Petroleum reservoir for how reservoirs work and how to find them.

Reservoir configured features (`voluminousenergy:ve_fluid_reservoir_feature`)
JSON entry	Fluid	Kind	Y range	Cell size (width × height)	Chance per cell	Biomes	Boundary wobble	Perimeter (shell) blocks
`crude_oil_reservoir`	Crude Oil	pool	-48 to 32	32 × 16	8.0%	`#minecraft:is_overworld`	4.0	Bituminous Sand in `c:ore_bearing_ground/sand/colorless_sand` Bituminous Red Sand in `c:ore_bearing_ground/sand/red_sand` Bituminous Gravel in anything else
`natural_gas_reservoir`	Natural Gas	cap	-56 to 16	32 × 16	6.0%	`#minecraft:is_overworld`	4.0	Bituminous Sand in `c:ore_bearing_ground/sand/colorless_sand` Bituminous Red Sand in `c:ore_bearing_ground/sand/red_sand` Bituminous Gravel in anything else

Petroleum caves

Each chunk has a small chance to start one of these cave systems, using vanilla's cave carving shape. The whole tunnel is filled with source blocks of the fluid, and every opening is sealed with bituminous blocks.

Fluid cave carvers (`voluminousenergy:ve_fluid_cave_carver`)
JSON entry	Fluid	Probability per chunk	Y range	Radius multipliers (horizontal / vertical)	Perimeter (shell) blocks
`crude_oil_cave`	Crude Oil	0.02	-40 to 30	0.5–0.9 / 0.5–0.9	Bituminous Sand in `c:ore_bearing_ground/sand/colorless_sand` Bituminous Red Sand in `c:ore_bearing_ground/sand/red_sand` Bituminous Gravel in anything else
`natural_gas_cave`	Natural Gas	0.015	-48 to 16	0.5–0.9 / 0.5–0.9	Bituminous Sand in `c:ore_bearing_ground/sand/colorless_sand` Bituminous Red Sand in `c:ore_bearing_ground/sand/red_sand` Bituminous Gravel in anything else

Biome modifiers

Reading the biome modifier table

Each biome modifier is a JSON file in data/voluminousenergy/neoforge/biome_modifier/ using Voluminous Energy's anded_biome_modifier:

Whitelisted biome tags: a biome must be in every listed tag.
Blacklisted biome tags: a biome in any listed tag is skipped.
Count: placement attempts per chunk.
Rarity: each attempt only goes ahead on average once every rarity chunks. 0 and 1 both mean every time.
Triangular placement: if enabled, heights between the anchors are biased towards the middle of the range, as with vanilla's diamond and redstone. Otherwise they are uniform.
Bottom/Top anchor: absolute Y levels.

Biome modifiers (`voluminousenergy:anded_biome_modifier`)
JSON entry	Feature	Whitelisted biome tags (all required)	Blacklisted biome tags (any excludes)	Triangular placement	Count	Bottom anchor	Top anchor	Rarity	Generation step
`bauxite_deposit_overworld`	`voluminousenergy:bauxite_deposit`	`minecraft:is_overworld`	None	Yes	1	10	60	64	Underground Decoration
`bauxite_ore_mountain_high`	`voluminousenergy:bauxite_ore_blob`	`minecraft:is_mountain`	`c:is_snowy`	Yes	9	208	256	0	Underground Ores
`bauxite_ore_mountain_low`	`voluminousenergy:bauxite_ore_blob`	`minecraft:is_mountain`	`c:is_snowy`	Yes	10	96	140	0	Underground Ores
`bauxite_ore_mountain_medium`	`voluminousenergy:bauxite_ore_blob`	`minecraft:is_mountain`	`c:is_snowy`	Yes	6	144	196	0	Underground Ores
`bauxite_ore_overworld`	`voluminousenergy:bauxite_ore_blob`	`minecraft:is_overworld`	None	No	10	10	60	0	Underground Ores
`bauxite_ore_shore`	`voluminousenergy:bauxite_ore_blob`	`c:is_shore/overworld`	None	Yes	8	62	92	0	Underground Ores
`cinnabar_deposit_overworld`	`voluminousenergy:cinnabar_deposit`	`minecraft:is_overworld`	None	Yes	1	-64	320	56	Underground Decoration
`cinnabar_ore_mountains`	`voluminousenergy:cinnabar_ore_blob`	`minecraft:is_mountain`	None	Yes	7	102	292	0	Underground Ores
`cinnabar_ore_overworld`	`voluminousenergy:cinnabar_ore_blob`	`minecraft:is_overworld`	None	No	9	-64	320	0	Underground Ores
`cinnabar_ore_shore`	`voluminousenergy:cinnabar_ore_blob`	`c:is_shore/overworld`	None	Yes	2	62	92	1	Underground Ores
`copper_deposit_overworld`	`voluminousenergy:copper_deposit`	`minecraft:is_overworld`	None	Yes	1	-16	112	26	Underground Decoration
`eighzo_deposit_end`	`voluminousenergy:eighzo_deposit`	`minecraft:is_end`	None	Yes	1	10	36	192	Underground Decoration
`eighzo_ore_end`	`voluminousenergy:eighzo_ore_blob`	`minecraft:is_end`	None	No	3	10	36	0	Underground Ores
`galena_deposit_overworld`	`voluminousenergy:galena_deposit`	`minecraft:is_overworld`	None	Yes	1	-48	12	78	Underground Decoration
`galena_ore_overworld`	`voluminousenergy:galena_ore_blob`	`minecraft:is_overworld`	None	No	3	-48	12	0	Underground Ores
`gold_deposit_overworld`	`voluminousenergy:gold_deposit`	`minecraft:is_overworld`	None	Yes	1	-64	-48	112	Underground Decoration
`iron_deposit_overworld`	`voluminousenergy:iron_deposit`	`minecraft:is_overworld`	None	Yes	1	-64	74	56	Underground Decoration
`oil_geyser_overworld`	`voluminousenergy:oil_geyser`	`minecraft:is_overworld`	None	No	1	-64	320	144	Fluid Springs
`rice_crop_overworld`	`voluminousenergy:rice_crop`	`minecraft:is_overworld`	`minecraft:is_ocean`	No	4	55	320	0	Vegetal Decoration
`rutile_deposit_overworld`	`voluminousenergy:rutile_deposit`	`minecraft:is_overworld`	None	Yes	1	-64	-48	128	Underground Decoration
`rutile_ore_overworld`	`voluminousenergy:rutile_ore_blob`	`minecraft:is_overworld`	None	No	3	-64	-32	0	Underground Ores
`saltpeter_ore_badlands`	`voluminousenergy:saltpeter_ore_blob`	`minecraft:is_badlands`	`minecraft:is_beach` `c:is_aquatic`	Yes	1	55	77	10	Underground Ores
`saltpeter_ore_hot_sandy`	`voluminousenergy:saltpeter_ore_blob`	`c:is_hot/overworld` `c:is_sandy`	`minecraft:is_beach` `c:is_aquatic`	No	4	55	320	0	Underground Ores
`surface_oil_lake_overworld`	`voluminousenergy:surface_oil_lake`	`minecraft:is_overworld`	None	No	1	-64	320	208	Lakes
`underground_oil_lakes_overworld`	`voluminousenergy:underground_oil_lake`	`minecraft:is_overworld`	None	No	1	-32	47	5	Lakes

Other biome modifiers
JSON entry	Type	Biomes	Adds	Step
`petroleum_caves_overworld`	`neoforge:add_carvers`	`#minecraft:is_overworld`	`voluminousenergy:crude_oil_cave` `voluminousenergy:natural_gas_cave`	air
`petroleum_reservoirs_overworld`	`neoforge:add_features`	`#minecraft:is_overworld`	`voluminousenergy:crude_oil_reservoir` `voluminousenergy:natural_gas_reservoir`	lakes

Ore blob features

Ore blob configured features (`minecraft:ore`)
JSON entry	Targets (block placed in replaceable tag)	Size	Discard chance on air exposure
`bauxite_ore_blob`	Bauxite Ore in `minecraft:stone_ore_replaceables` Deepslate Bauxite Ore in `minecraft:deepslate_ore_replaceables`	8	0.0
`cinnabar_ore_blob`	Cinnabar Ore in `minecraft:stone_ore_replaceables` Deepslate Cinnabar Ore in `minecraft:deepslate_ore_replaceables`	6	0.0
`eighzo_ore_blob`	Eighzo Ore in `c:ore_bearing_ground/end_stone`	4	0.5
`galena_ore_blob`	Galena Ore in `minecraft:stone_ore_replaceables` Deepslate Galena Ore in `minecraft:deepslate_ore_replaceables`	6	0.0
`rutile_ore_blob`	Rutile Ore in `minecraft:stone_ore_replaceables` Deepslate Rutile Ore in `minecraft:deepslate_ore_replaceables`	4	0.75
`saltpeter_ore_blob`	Saltpeter Ore in `c:ore_bearing_ground/sand/colorless_sand` Red Saltpeter Ore in `c:ore_bearing_ground/sand/red_sand`	33	0.0

Ore deposit features

Ore deposits are lake-shaped pockets: the inside is the raw block of the resource, and the edge is the ore block where it meets stone. If "Disallow surface ore deposits" is enabled in the common config, deposits are not placed where they can see the sky.

Ore deposit configured features (`voluminousenergy:ve_ore_deposit_feature`)
JSON entry	Outer ore block	Core (raw) block
`bauxite_deposit`	Bauxite Ore	Raw Bauxite Block
`cinnabar_deposit`	Cinnabar Ore	Raw Cinnabar Block
`copper_deposit`	Copper Ore	Raw Copper Block
`eighzo_deposit`	Eighzo Ore	Raw Eighzo Block
`galena_deposit`	Galena Ore	Raw Galena Block
`gold_deposit`	Gold Ore	Raw Gold Block
`iron_deposit`	Iron Ore	Raw Iron Block
`rutile_deposit`	Rutile Ore	Raw Rutile Block

Crude Oil and Rice features

The perimeter blocks are chosen from what is under each edge position: sand becomes Bituminous Sand, red sand becomes Bituminous Red Sand, and anything else becomes Bituminous Gravel.

Fluid and plant configured features
JSON entry	Feature type	Fluid / block	Perimeter (shell) blocks
`oil_geyser`	`voluminousenergy:ve_geyser_feature`	Crude Oil	None
`rice_crop`	`voluminousenergy:ve_rice_feature`	Rice Crop	None
`surface_oil_lake`	`voluminousenergy:ve_bsc_surface_lake_feature`	Crude Oil	Bituminous Sand in `c:ore_bearing_ground/sand/colorless_sand` Bituminous Red Sand in `c:ore_bearing_ground/sand/red_sand` Bituminous Gravel in anything else
`underground_oil_lake`	`voluminousenergy:ve_fluid_deposit_feature`	Crude Oil	Bituminous Sand in `c:ore_bearing_ground/sand/colorless_sand` Bituminous Red Sand in `c:ore_bearing_ground/sand/red_sand` Bituminous Gravel in anything else

@@ Line 1: / Line 1: @@
 This page covers Voluminous Energy's feature generation for the '''0.5 Alpha 2''' releases: '''1.21.1-0.5 Alpha 2''', '''26.1.2-0.5 Alpha 2''' and '''26.2-0.5 Alpha 2''' (all NeoForge, released 12 October 2026). The tables show the 1.21.1-0.5 Alpha 2 data.
+Alpha 2 adds:
-Alpha 2 is the biggest change to Voluminous Energy's world generation since 1.18. It adds:
 * '''[[Petroleum reservoir|Crude Oil and Natural Gas reservoirs]]''': large underground bodies of oil or gas laid out like vanilla aquifers,
 * '''Crude Oil and Natural Gas caves''': small cave systems completely filled with oil or gas,
-* '''Bituminous Sand, Bituminous Red Sand and Bituminous Gravel''': the blocks that seal oil and gas in the ground. They can be crushed for [[Bitumen]].
+* '''Bituminous Sand, Bituminous Red Sand and Bituminous Gravel''': the blocks that seal reservoirs, petroleum caves and oil lakes. They can be crushed for [[Bitumen]].
 It also changes the Crude Oil lakes:
@@ Line 25: / Line 25: @@
 See [[Petroleum reservoir]] for how reservoirs work and how to find them.
+<div class="ve-scroll">
 {| class="wikitable" style="width:100%"
 |+ Reservoir configured features (<code>voluminousenergy:ve_fluid_reservoir_feature</code>)
@@ Line 33: / Line 34: @@
 | <code>natural_gas_reservoir</code> || Natural Gas || cap || -56 to 16 || 32 × 16 || 6.0% || <code>#minecraft:is_overworld</code> || 4.0 || Bituminous Sand in <code>c:ore_bearing_ground/sand/colorless_sand</code><br>Bituminous Red Sand in <code>c:ore_bearing_ground/sand/red_sand</code><br>Bituminous Gravel in anything else
 |}
+</div>
 == Petroleum caves ==
-Each chunk has a small chance to start one of these cave systems, using vanilla's cave carving shape. The whole tunnel is filled with source blocks of the fluid, and every opening is sealed with bituminous blocks so that the fluid doesn't spill.
+Each chunk has a small chance to start one of these cave systems, using vanilla's cave carving shape. The whole tunnel is filled with source blocks of the fluid, and every opening is sealed with bituminous blocks.
+<div class="ve-scroll">
 {| class="wikitable" style="width:100%"
 |+ Fluid cave carvers (<code>voluminousenergy:ve_fluid_cave_carver</code>)
@@ Line 45: / Line 48: @@
 | <code>natural_gas_cave</code> || Natural Gas || 0.015 || -48 to 16 || 0.5–0.9 / 0.5–0.9 || Bituminous Sand in <code>c:ore_bearing_ground/sand/colorless_sand</code><br>Bituminous Red Sand in <code>c:ore_bearing_ground/sand/red_sand</code><br>Bituminous Gravel in anything else
 |}
+</div>
 == Biome modifiers ==
@@ Line 56: / Line 60: @@
 * '''Bottom/Top anchor''': absolute Y levels.
+<div class="ve-scroll">
 {| class="wikitable sortable" style="width:100%"
 |+ Biome modifiers (<code>voluminousenergy:anded_biome_modifier</code>)
@@ Line 119: / Line 124: @@
 | <code>petroleum_reservoirs_overworld</code> || <code>neoforge:add_features</code> || <code>#minecraft:is_overworld</code> || <code>voluminousenergy:crude_oil_reservoir</code><br><code>voluminousenergy:natural_gas_reservoir</code> || lakes
 |}
+</div>
 == Ore blob features ==
+<div class="ve-scroll">
 {| class="wikitable sortable" style="width:100%"
 |+ Ore blob configured features (<code>minecraft:ore</code>)
@@ Line 137: / Line 144: @@
 | <code>saltpeter_ore_blob</code> || Saltpeter Ore in <code>c:ore_bearing_ground/sand/colorless_sand</code><br>Red Saltpeter Ore in <code>c:ore_bearing_ground/sand/red_sand</code> || 33 || 0.0
 |}
+</div>
 == Ore deposit features ==
 [[List of ore deposits|Ore deposits]] are lake-shaped pockets: the inside is the raw block of the resource, and the edge is the ore block where it meets stone. If "Disallow surface ore deposits" is enabled in the common config, deposits are not placed where they can see the sky.
+<div class="ve-scroll">
 {| class="wikitable sortable" style="width:100%"
 |+ Ore deposit configured features (<code>voluminousenergy:ve_ore_deposit_feature</code>)
@@ Line 161: / Line 170: @@
 | <code>rutile_deposit</code> || Rutile Ore || Raw Rutile Block
 |}
+</div>
 == Crude Oil and Rice features ==
 The perimeter blocks are chosen from what is under each edge position: sand becomes Bituminous Sand, red sand becomes Bituminous Red Sand, and anything else becomes Bituminous Gravel.
+<div class="ve-scroll">
 {| class="wikitable sortable" style="width:100%"
 |+ Fluid and plant configured features
@@ Line 177: / Line 188: @@
 | <code>underground_oil_lake</code> || <code>voluminousenergy:ve_fluid_deposit_feature</code> || Crude Oil || Bituminous Sand in <code>c:ore_bearing_ground/sand/colorless_sand</code><br>Bituminous Red Sand in <code>c:ore_bearing_ground/sand/red_sand</code><br>Bituminous Gravel in anything else
 |}
+</div>
 [[Category:Feature generation]]

Maintenance script (talk | contribs)