Enum BiomeSourceKind 

#[non_exhaustive]
pub enum BiomeSourceKind {
    Overworld(OverworldBiomeSource),
    Nether(NetherBiomeSource),
    End(Box<EndBiomeSource>),
}

Dimension-specific biome source.

Each variant holds shared state (noise generators, parameter lists) and creates per-chunk samplers via chunk_sampler.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Overworld(OverworldBiomeSource)

Overworld biome source (multi-noise climate matching).

Nether(NetherBiomeSource)

Nether biome source (multi-noise temperature/vegetation matching).

End(Box<EndBiomeSource>)

End biome source (spatial distance + erosion threshold).

Boxed because EndIslands is ~2KB (simplex noise permutation table), while the other variants are pointer-sized.

Implementations

impl BiomeSourceKind

pub fn overworld(seed: u64) -> Self

Create an overworld biome source with the given world seed.

pub fn nether(seed: u64) -> Self

Create a nether biome source with the given world seed.

pub fn end(seed: u64) -> Self

Create an end biome source with the given world seed.

pub fn possible_biome_refs(&self) -> Vec<BiomeRef>

Every biome this source can produce, preserving the source’s parameter-list order.

Feature sorting depends on biome iteration order because vanilla assigns global feature order while walking all possible biomes. The set-returning possible_biomes is kept for callers that only need membership tests.

pub fn possible_biomes(&self) -> FxHashSet<Identifier>

Every biome this source can produce. Used to filter structure sets whose resolved allowed_biomes are from a different dimension.

pub fn chunk_sampler(&self) -> ChunkBiomeSampler<'_>

Create a per-chunk biome sampler.

The returned sampler holds per-chunk caches and should be dropped after the chunk’s biomes are fully populated.

pub fn find_biome_horizontal( &self, origin_x: i32, origin_z: i32, search_radius: i32, allowed: &dyn Fn(BiomeRef) -> bool, rng: &mut LegacyRandom, ) -> Option<(i32, i32)>

Vanilla’s BiomeSource.findBiomeHorizontal(findClosest=false, skipSteps=1). Reservoir-samples at y=0. Returns Some((block_x, block_z)) if found.

pub fn initial_spawn_search_origin(&self) -> BlockPos

Returns vanilla’s climate-based initial spawn search origin for dimensions that define one.

Trait Implementations

impl StructureBiomeProvider for BiomeSourceKind

fn possible_biomes(&self) -> FxHashSet<Identifier>

Every biome this provider can produce.

fn ring_position_cache_key(&self) -> Option<String>

Stable identity for every provider input that can affect ring snapping.

fn find_biome_horizontal( &self, origin_x: i32, origin_z: i32, search_radius: i32, allowed: &dyn Fn(&Identifier) -> bool, rng: &mut LegacyRandom, ) -> Option<(i32, i32)>

Vanilla’s BiomeSource.findBiomeHorizontal(findClosest=false, skipSteps=1).