Struct Sections 

pub struct Sections {
    pub sections: Box<[SectionHolder]>,
    randomly_ticking_sections: Arc<RandomTickSectionBits>,
}

A collection of chunk sections.

Fields

sections: Box<[SectionHolder]>

The sections in the collection.

randomly_ticking_sections: Arc<RandomTickSectionBits>

Implementations

impl Sections

pub fn from_owned(sections: Box<[ChunkSection]>) -> Self

Creates a new Sections from a box of owned ChunkSections.

pub(crate) const fn random_tick_sections(&self) -> &Arc<RandomTickSectionBits>

Returns the shared lock-free random-tick section index.

pub fn get_relative_block( &self, relative_x: usize, relative_y: usize, relative_z: usize, ) -> Option<BlockStateId>

Gets a block at a relative position in the chunk.

pub fn read_column_into(&self, x: usize, z: usize, buf: &mut Vec<BlockStateId>)

Reads an entire column at (x, z) across all sections into a caller-owned buffer.

Holds each section’s read lock once for 16 Y reads instead of acquiring a lock per block. Indexed by relative_y (0 = chunk min-y). The buffer is resized if needed and reused across calls to avoid allocation.

pub fn read_all_biomes(&self) -> Box<[u16]>

Reads all biome palette values into a flat array.

Indexed as [section_idx * 64 + qy * 16 + qz * 4 + qx]. Holds each section’s read lock once for all 64 biome reads.

pub fn for_each_biome_id(&self, visitor: impl FnMut(u16))

Visits every biome palette value in section order while holding each section’s read lock once.

pub fn section_emptiness_map(&self) -> Box<[bool]>

Returns whether each real chunk section contains no non-air blocks.

pub fn block_light_sources( &self, chunk_pos: ChunkPos, min_y: i32, ) -> Vec<BlockPos>

Returns block-light source positions in ScalableLux section/local-index order.

pub fn write_column_blocks( &self, x: usize, z: usize, blocks: &[(usize, BlockStateId)], )

Writes multiple blocks in one column, holding each section’s write guard across all writes to that section. Most efficient when blocks are grouped by section (e.g. descending relative_y from a top-to-bottom scan).

pub fn write_block_batch(&self, blocks: &[(usize, usize, usize, BlockStateId)])

Writes a batch of blocks at arbitrary positions, holding each section’s write guard across consecutive entries in the same section. Blocks should be roughly grouped by section index for best performance.

Each touched section enters worldgen Building mode (raw cube, no palette tracking) so writes are O(1) stores. Per-write goes through a flat &mut [V] view of the cube — bypasses the 3-arm set match and the unused old-value load. recalculate_counts finalizes.

pub(crate) fn write_tracked_block_batch( &self, blocks: &[(usize, usize, usize, BlockStateId)], )

Writes a batch of blocks while maintaining section counters and palette state.

Blocks should be grouped by section index so each touched section only needs one write guard.

pub fn set_relative_block( &self, relative_x: usize, relative_y: usize, relative_z: usize, value: BlockStateId, )

Sets a block at a relative position in the chunk and keeps section counters/palette serialization ready.

pub(crate) fn set_relative_block_for_generation( &self, relative_x: usize, relative_y: usize, relative_z: usize, value: BlockStateId, )

Sets a block during worldgen using the raw building palette path.

Callers must finalize by recounting touched sections before save, promotion, or packet serialization.

Trait Implementations

impl Debug for Sections

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.