Struct CarvingContext 

pub struct CarvingContext<'a, N: DimensionNoises> {

    pub noises: &'a N,
    pub min_y: i32,
    pub gen_depth: i32,
    pub sea_level: i32,
    pub surface_system: &'a SurfaceSystem,
    pub aquifer: &'a mut Aquifer<N>,
    pub default_block_id: BlockStateId,
    pub psl_corners: PreliminarySurfaceCorners,
    pub chunk_min_x: i32,
    pub chunk_min_z: i32,
    pub material_ore_vein_values: Arc<[f32]>,
    pub ore_veinifier: Option<&'a OreVeinifier>,
    pub material_cache: N::ColumnCache,
}

Runtime context for a single apply_carvers invocation on one chunk.

Mirrors vanilla’s CarvingContext and borrows the Aquifer retained from Noise.

Fields

noises: &'a N

Density functions for material-rule evaluation.

min_y: i32

Dimension minimum Y (inclusive).

gen_depth: i32

Dimension vertical extent in blocks (max_y = min_y + gen_depth - 1).

sea_level: i32

Dimension sea level used by relative vertical anchors.

surface_system: &'a SurfaceSystem

Surface system (biome-specific surface noise + clay bands).

aquifer: &'a mut Aquifer<N>

Aquifer for this chunk, retained from Noise or reconstructed after a disk reload.

default_block_id: BlockStateId

Default solid block for this dimension (stone / netherrack / end_stone).

psl_corners: PreliminarySurfaceCorners

Preliminary surface levels at the 4 corners of this chunk, used for bilinear interpolation of min_surface_level during top-material lookup.

chunk_min_x: i32

Chunk NW block X — anchors psl_corners.

chunk_min_z: i32

Chunk NW block Z — anchors psl_corners.

material_ore_vein_values: Arc<[f32]>

Density/richness values prefilled for material ore rules during noise fill.

ore_veinifier: Option<&'a OreVeinifier>

Positional random source and block states for material ore rules.

material_cache: N::ColumnCache

Material-rule column cache for direct filler-gap sampling.

Implementations

impl<N: DimensionNoises> CarvingContext<'_, N>

pub fn min_surface_level(&self, block_x: i32, block_z: i32) -> i32

Bilinear interpolation of the 4 preliminary-surface-level corners at the given in-chunk position. Matches vanilla’s SurfaceRules.Context.updateXZ path.

pub fn top_material( &mut self, biome_id: u16, block_x: i32, block_y: i32, block_z: i32, steep: bool, under_fluid: bool, ) -> Option<BlockStateId>

Runs surface rules at a single position to pick the “top material” block (grass / podzol / mycelium / sand / …). Called by the carver when it uncovers dirt beneath a grass block so the exposed surface gets rewritten to the biome-appropriate surface block.

Mirrors vanilla’s SurfaceSystem.topMaterial (the @Deprecated carver-specific variant). Vanilla hardcodes stone_depth_above = stone_depth_below = 1 here, and the water height depends on whether the carved block was replaced with a fluid.