Struct WorldGenContext 

pub struct WorldGenContext {
    pub generator: Arc<ChunkGeneratorType>,
    world: Weak<World>,
    min_y: i32,
    height: i32,
    sea_level: i32,
}

Context for world generation.

Similar to vanilla’s WorldGenContext, this provides access to the level/dimension and generation infrastructure.

Fields

generator: Arc<ChunkGeneratorType>

The chunk generator to use.

world: Weak<World>

Weak reference to the world (to avoid circular Arc reference). Use world() to get a strong reference when needed.

min_y: i32

Cached dimension minimum build Y. Immutable for the world’s lifetime; cached here so per-block queries avoid a Weak<World>::upgrade (a cross-thread atomic refcount round-trip) on every call.

height: i32

Cached dimension build height. See Self::min_y.

sea_level: i32

Cached dimension sea level. Immutable for the world’s lifetime. Read per-column by the freeze_top_layer feature (snow/ice placement); cached here so it avoids a Weak<World>::upgrade (cross-thread atomic on the shared Arc<World>) on every column. See Self::min_y.

Implementations

impl WorldGenContext

pub const fn new( generator: Arc<ChunkGeneratorType>, world: Weak<World>, min_y: i32, height: i32, sea_level: i32, ) -> Self

Creates a new WorldGenContext.

min_y/height are the dimension’s build bounds (DimensionType::min_y / ::height); they are cached rather than read from the world per call.

pub const fn sea_level(&self) -> i32

Returns the dimension’s sea level (cached; see Self::min_y).

pub fn world(&self) -> Arc<World>

Gets a strong reference to the world.

Panics

Panics if the world has been dropped.

pub fn weak_world(&self) -> Weak<World>

Gets a weak reference to the world.

This is useful for passing to chunks without creating a strong reference cycle.

pub const fn min_y(&self) -> i32

Returns the minimum Y coordinate of the world.

pub const fn height(&self) -> i32

Returns the total height of the world in blocks.

pub fn generation_min_y(&self) -> i32

Returns the minimum Y coordinate used by WorldGenerationContext.

pub fn generation_height(&self) -> i32

Returns the height used by WorldGenerationContext.

pub const fn section_count(&self) -> usize

How many sections this dimension has