Struct SectionWriteGuard 

pub struct SectionWriteGuard<'a> {
    guard: RwLockWriteGuard<'a, ChunkSection>,
    randomly_ticking_sections: &'a RandomTickSectionBits,
    section_index: usize,
    was_randomly_ticking: bool,
}

A chunk-section write guard that republishes derived lock-free metadata.

Fields

guard: RwLockWriteGuard<'a, ChunkSection>

randomly_ticking_sections: &'a RandomTickSectionBits

section_index: usize

was_randomly_ticking: bool

Implementations

impl<'a> SectionWriteGuard<'a>

fn new( guard: RwLockWriteGuard<'a, ChunkSection>, randomly_ticking_sections: &'a RandomTickSectionBits, section_index: usize, ) -> Self

Methods from Deref<Target = ChunkSection>

pub fn is_empty(&self) -> bool

Returns true if this section contains no non-air blocks.

pub fn is_randomly_ticking(&self) -> bool

Returns true if this section contains any randomly-ticking blocks or fluids.

pub fn is_randomly_ticking_blocks(&self) -> bool

Returns true if this section contains any randomly-ticking blocks.

pub fn is_randomly_ticking_fluids(&self) -> bool

Returns true if this section contains any randomly-ticking fluids.

pub fn maybe_has_block_light_sources(&self) -> bool

Returns true if this section’s palette may contain block-light sources.

pub fn append_block_light_sources( &self, chunk_min_x: i32, section_min_y: i32, chunk_min_z: i32, sources: &mut Vec<BlockPos>, )

Appends block-light source positions in ScalableLux local-index order.

pub fn non_empty_block_count(&self) -> u16

Returns the number of non-air blocks in this section.

pub fn fluid_count(&self) -> u16

Returns the number of fluid-containing blocks in this section.

pub fn has_fluid(&self) -> bool

Returns if the chunk has fluid.

pub fn ticking_block_count(&self) -> u16

Returns the number of randomly-ticking blocks in this section.

pub fn ticking_fluid_count(&self) -> u16

Returns the number of randomly-ticking fluids in this section.

pub fn recalculate_counts(&mut self)

Recalculates cached counters from extracted per-state metadata.

Iterates the palette (O(palette_size)) rather than every cube cell (O(4096)): each block-state appears at most once in the palette and carries its own occurrence count, so we just classify each unique state and multiply by its count. Mirrors Moonrise’s BlockCountingBitStorage. For a Homogeneous section that’s a single classify; for typical Heterogeneous sections palette is well under 16 entries.

fn recalculate_counts_from_palette( &mut self, counts_for_state: impl FnMut(BlockStateId) -> BlockStateSectionCounts, )

pub fn contains_poi(&self) -> bool

Whether this section’s palette contains any POI-type block state.

Lets the Full-stage POI populate skip the full 4096-block scan_and_populate for the overwhelming majority of sections (stone/dirt/air) that hold no POI blocks — a palette scan of O(≤16) instead of O(4096). Mirrors vanilla’s LevelChunkSection.maybeHas.

pub fn set_block_state( &mut self, x: usize, y: usize, z: usize, new_state: BlockStateId, ) -> BlockStateId

Sets a block state and updates the cached counters.

Returns the old block state.

pub(crate) fn set_block_state_for_generation( &mut self, x: usize, y: usize, z: usize, new_state: BlockStateId, ) -> BlockStateId

Sets a block state through the raw worldgen building path.

Returns the old block state. Cached counters are intentionally not updated; callers must recount before light, promotion, save, or packet serialization.

pub(crate) fn finalize_generation_counts_if_needed(&mut self)

fn ensure_counter_ready_for_delta(&mut self)

fn apply_count_change( &mut self, old_counts: BlockStateSectionCounts, new_counts: BlockStateSectionCounts, )

pub fn write(&self, writer: &mut Cursor<Vec<u8>>)

Writes the chunk section to a writer.

Panics

• If the writer fails to write.

Trait Implementations

impl Deref for SectionWriteGuard<'_>

type Target = ChunkSection

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for SectionWriteGuard<'_>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Drop for SectionWriteGuard<'_>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.