Feature generation/1.21.1-0.5 Alpha 2

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