View source for 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:
* '''[[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 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 (<code>ve_fluid_deposit_feature</code>). 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 [[Feature generation/1.20.2-0.5|0.5 Alpha 1]].

{| class="wikitable"
! Release !! Difference
|-
| 1.21.1-0.5 Alpha 2 || The petroleum cave carvers are added at the <code>air</code> 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 <code>minecraft:cinnabar</code> block (same as 26.2 Alpha 1).
|}

== Petroleum reservoirs ==
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>)
! JSON entry !! Fluid !! Kind !! Y range !! Cell size (width × height) !! Chance per cell !! Biomes !! Boundary wobble !! Perimeter (shell) blocks
|-
| <code>crude_oil_reservoir</code> || Crude Oil || pool || -48 to 32 || 32 × 16 || 8.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
|-
| <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.

<div class="ve-scroll">
{| class="wikitable" style="width:100%"
|+ Fluid cave carvers (<code>voluminousenergy:ve_fluid_cave_carver</code>)
! JSON entry !! Fluid !! Probability per chunk !! Y range !! Radius multipliers (horizontal / vertical) !! Perimeter (shell) blocks
|-
| <code>crude_oil_cave</code> || Crude Oil || 0.02 || -40 to 30 || 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
|-
| <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 ==
=== Reading the biome modifier table ===
Each biome modifier is a JSON file in <code>data/voluminousenergy/neoforge/biome_modifier/</code> using Voluminous Energy's <code>anded_biome_modifier</code>:
* '''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.

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

{| class="wikitable" style="width:100%"
|+ Other biome modifiers
! JSON entry !! Type !! Biomes !! Adds !! Step
|-
| <code>petroleum_caves_overworld</code> || <code>neoforge:add_carvers</code> || <code>#minecraft:is_overworld</code> || <code>voluminousenergy:crude_oil_cave</code><br><code>voluminousenergy:natural_gas_cave</code> || air
|-
| <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>)
! JSON entry !! Targets (block placed in replaceable tag) !! Size !! Discard chance on air exposure
|-
| <code>bauxite_ore_blob</code> || Bauxite Ore in <code>minecraft:stone_ore_replaceables</code><br>Deepslate Bauxite Ore in <code>minecraft:deepslate_ore_replaceables</code> || 8 || 0.0
|-
| <code>cinnabar_ore_blob</code> || Cinnabar Ore in <code>minecraft:stone_ore_replaceables</code><br>Deepslate Cinnabar Ore in <code>minecraft:deepslate_ore_replaceables</code> || 6 || 0.0
|-
| <code>eighzo_ore_blob</code> || Eighzo Ore in <code>c:ore_bearing_ground/end_stone</code> || 4 || 0.5
|-
| <code>galena_ore_blob</code> || Galena Ore in <code>minecraft:stone_ore_replaceables</code><br>Deepslate Galena Ore in <code>minecraft:deepslate_ore_replaceables</code> || 6 || 0.0
|-
| <code>rutile_ore_blob</code> || Rutile Ore in <code>minecraft:stone_ore_replaceables</code><br>Deepslate Rutile Ore in <code>minecraft:deepslate_ore_replaceables</code> || 4 || 0.75
|-
| <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>)
! JSON entry !! Outer ore block !! Core (raw) block
|-
| <code>bauxite_deposit</code> || Bauxite Ore || Raw Bauxite Block
|-
| <code>cinnabar_deposit</code> || Cinnabar Ore || Raw Cinnabar Block
|-
| <code>copper_deposit</code> || Copper Ore || Raw Copper Block
|-
| <code>eighzo_deposit</code> || Eighzo Ore || Raw Eighzo Block
|-
| <code>galena_deposit</code> || Galena Ore || Raw Galena Block
|-
| <code>gold_deposit</code> || Gold Ore || Raw Gold Block
|-
| <code>iron_deposit</code> || Iron Ore || Raw Iron Block
|-
| <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
! JSON entry !! Feature type !! Fluid / block !! Perimeter (shell) blocks
|-
| <code>oil_geyser</code> || <code>voluminousenergy:ve_geyser_feature</code> || Crude Oil || {{Unknown|None}}
|-
| <code>rice_crop</code> || <code>voluminousenergy:ve_rice_feature</code> || Rice Crop || {{Unknown|None}}
|-
| <code>surface_oil_lake</code> || <code>voluminousenergy:ve_bsc_surface_lake_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
|-
| <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]]