Struct GenerationContext 

pub struct GenerationContext<'ctx, 'src, N: DimensionNoises>
where
    'src: 'ctx,
{

    seed: i64,
    chunk_x: i32,
    chunk_z: i32,
    chunk_min_x: i32,
    chunk_min_z: i32,
    center_block_x: i32,
    center_block_z: i32,
    sea_level: i32,
    surface_y_cache: &'ctx mut Option<i32>,
    height_cache_grid_ready: &'ctx mut bool,
    noises: &'src N,
    splitter: &'src RandomSplitter,
    template_pools: &'src FxHashMap<Identifier, TemplatePoolData>,
    templates: &'src FxHashMap<Identifier, TemplateData>,
    biome_sampler: &'ctx mut ChunkBiomeSampler<'src>,
    height_cache: &'ctx mut N::ColumnCache,
    aquifer: &'ctx mut LazyAquifer<'src, N>,
    terrain_height_cache: RefCell<FxHashMap<(i32, i32, bool), i32>>,
    terrain_opaque_cache: RefCell<FxHashMap<(i32, i32, i32, bool), bool>>,
    terrain_probes: RefCell<FxHashMap<(i32, i32), TerrainProbe<N>>>,
}

Per-chunk context shared by every structure’s findGenerationPoint.

Holds mutable per-chunk state (biome sampler, height cache, aquifer) so structures don’t each allocate their own. Wraps VanillaGenerator’s helpers.

Fields

seed: i64

World seed.

chunk_x: i32

Chunk being populated.

chunk_z: i32

Chunk being populated.

chunk_min_x: i32

chunk_x * 16.

chunk_min_z: i32

chunk_z * 16.

center_block_x: i32

chunk_min_x + 8.

center_block_z: i32

chunk_min_z + 8.

sea_level: i32

Sea level for this dimension.

surface_y_cache: &'ctx mut Option<i32>

Shared memoisation slot for the chunk-center surface Y.

height_cache_grid_ready: &'ctx mut bool

Whether height_cache’s 5×5 quart grid has been populated. Shared across per-structure contexts in the same chunk.

noises: &'src N

Dimension noise router.

splitter: &'src RandomSplitter

Positional splitter for per-chunk RNG.

template_pools: &'src FxHashMap<Identifier, TemplatePoolData>

Template pool registry for jigsaw assembly.

templates: &'src FxHashMap<Identifier, TemplateData>

Template data registry for jigsaw assembly.

biome_sampler: &'ctx mut ChunkBiomeSampler<'src>

Biome sampler scoped to this chunk.

height_cache: &'ctx mut N::ColumnCache

Column cache for height/density queries (grid-initialized on demand).

aquifer: &'ctx mut LazyAquifer<'src, N>

Aquifer built on first query; skipped on chunks where no structure needs it.

terrain_height_cache: RefCell<FxHashMap<(i32, i32, bool), i32>>

Cache for terrain height checks.

terrain_opaque_cache: RefCell<FxHashMap<(i32, i32, i32, bool), bool>>

Cache for terrain opacity checks.

terrain_probes: RefCell<FxHashMap<(i32, i32), TerrainProbe<N>>>

Probes for off-chunk height/opaque checks.

Implementations

impl<'ctx, 'src, N: DimensionNoises> GenerationContext<'ctx, 'src, N>

where 'src: 'ctx,

pub fn new( seed: i64, chunk_x: i32, chunk_z: i32, sea_level: i32, noises: &'src N, splitter: &'src RandomSplitter, template_pools: &'src FxHashMap<Identifier, TemplatePoolData>, templates: &'src FxHashMap<Identifier, TemplateData>, biome_sampler: &'ctx mut ChunkBiomeSampler<'src>, height_cache: &'ctx mut N::ColumnCache, aquifer: &'ctx mut LazyAquifer<'src, N>, surface_y_cache: &'ctx mut Option<i32>, height_cache_grid_ready: &'ctx mut bool, ) -> Self

Creates a per-chunk structure generation context.

pub fn base_height(&mut self, x: i32, z: i32, ocean_floor: bool) -> i32

getBaseHeight(WORLD_SURFACE_WG) — aquifer-aware, scans from preliminary_surface_level + 16.

ocean_floor=false → opaque is Solid+Fluid; true → opaque is Solid only.

In dimensions with a constant preliminary_surface_level (End), use base_height_full instead.

pub fn base_height_full(&mut self, x: i32, z: i32, ocean_floor: bool) -> i32

Full-column scan from chunk top. Matches vanilla’s iterateNoiseColumn.

pub fn biome_at(&mut self, block_x: i32, block_y: i32, block_z: i32) -> BiomeRef

Biome at a block position (quantized to quart).

pub fn column_state(&mut self, x: i32, y: i32, z: i32) -> ColumnBlock

Classify a single block in the base-noise column.

pub fn solid_block_below_air( &mut self, x: i32, z: i32, start_y: i32, min_solid_y: i32, ) -> Option<i32>

Highest solid base-terrain block directly below air in [min_solid_y, start_y).

pub fn surface_y(&mut self) -> i32

Surface Y at chunk center, memoised across per-structure contexts.

fn ensure_height_cache_grid(&mut self)

Trait Implementations

impl<N: DimensionNoises> StructureGenerationContext for GenerationContext<'_, '_, N>

fn seed(&self) -> i64

World seed.

fn chunk_x(&self) -> i32

Chunk X being populated.

fn chunk_z(&self) -> i32

Chunk Z being populated.

fn chunk_min_x(&self) -> i32

Minimum block X of the chunk.

fn chunk_min_z(&self) -> i32

Minimum block Z of the chunk.

fn center_block_x(&self) -> i32

Center block X of the chunk.

fn center_block_z(&self) -> i32

Center block Z of the chunk.

fn sea_level(&self) -> i32

Sea level for this generator/dimension.

fn min_y(&self) -> i32

Minimum build Y.

fn height(&self) -> i32

Total build height.

fn template_pools(&self) -> &FxHashMap<Identifier, TemplatePoolData>

Template pool registry for jigsaw assembly.

fn templates(&self) -> &FxHashMap<Identifier, TemplateData>

Structure templates (piece definitions + sizes).

fn base_height(&mut self, x: i32, z: i32, ocean_floor: bool) -> i32

Base height at a column.

fn base_height_full(&mut self, x: i32, z: i32, ocean_floor: bool) -> i32

Full-column base height scan.

fn biome_at(&mut self, block_x: i32, block_y: i32, block_z: i32) -> BiomeRef

Biome at a block position.

fn column_state(&mut self, x: i32, y: i32, z: i32) -> ColumnBlock

Classify a block in the generator’s base terrain.

fn solid_block_below_air( &mut self, x: i32, z: i32, start_y: i32, min_solid_y: i32, ) -> Option<i32>

Highest solid base-terrain block directly below air in [min_solid_y, start_y).

fn surface_y(&mut self) -> i32

Chunk-center surface Y, memoised by the concrete context.

fn terrain_surface_height(&self, x: i32, z: i32, ocean_floor: bool) -> i32

Surface height for off-chunk terrain queries used by piece placement.

fn terrain_is_opaque(&self, x: i32, y: i32, z: i32, ocean_floor: bool) -> bool

Opaque terrain test for off-chunk terrain queries used by piece placement.

fn max_y(&self) -> i32

One-past-maximum build Y.