Struct PointOfInterestStorage 

pub struct PointOfInterestStorage {
    columns: FxHashMap<ChunkPos, FxHashMap<i32, PointOfInterestSet>>,
}

World-level storage for all points of interest.

Organized as a two-level map: ChunkPos -> section_y -> PointOfInterestSet. This structure mirrors chunk lifecycle (load/unload per column) and provides efficient spatial queries by narrowing to relevant columns first.

Fields

columns: FxHashMap<ChunkPos, FxHashMap<i32, PointOfInterestSet>>

Implementations

impl PointOfInterestStorage

pub fn new() -> Self

Creates an empty POI storage.

fn get_or_create_set( &mut self, chunk_pos: ChunkPos, section_y: i32, ) -> &mut PointOfInterestSet

pub fn add(&mut self, pos: BlockPos, poi_type_id: usize, max_tickets: u32)

Adds a POI at the given block position.

pub fn remove(&mut self, pos: BlockPos)

Removes the POI at the given block position.

pub fn get_type(&self, pos: BlockPos) -> Option<usize>

Returns the POI type ID at the given position, if any.

pub fn is_occupied(&self, pos: BlockPos) -> bool

Returns true if the POI at the given position has all tickets reserved.

pub fn reserve_ticket(&mut self, pos: BlockPos) -> bool

Reserves a ticket at the given position. Returns true if successful.

pub fn release_ticket(&mut self, pos: BlockPos) -> bool

Releases a ticket at the given position. Returns true if successful.

pub fn get_in_chunk( &self, type_predicate: &impl Fn(usize) -> bool, chunk_x: i32, chunk_z: i32, status: OccupationStatus, ) -> Vec<(BlockPos, usize)>

Returns all matching POIs in a specific chunk column.

pub fn get_in_square( &self, type_predicate: &impl Fn(usize) -> bool, center: BlockPos, radius: i32, status: OccupationStatus, ) -> Vec<(BlockPos, usize)>

Returns all matching POIs within a cubic region centered on center.

pub fn get_in_horizontal_square( &self, type_predicate: &impl Fn(usize) -> bool, center: BlockPos, radius: i32, status: OccupationStatus, ) -> Vec<(BlockPos, usize)>

Returns all matching POIs within a vanilla horizontal square centered on center.

Mirrors PoiManager.getInSquare: X/Z are constrained by radius, while Y is not.

pub fn count( &self, type_predicate: &impl Fn(usize) -> bool, pos: BlockPos, radius: i32, status: OccupationStatus, ) -> usize

Counts matching POIs within a spherical region.

fn count_in_square( &self, type_predicate: &impl Fn(usize) -> bool, center: BlockPos, radius: i32, status: OccupationStatus, filter: &impl Fn(BlockPos) -> bool, ) -> usize

Counts matching POIs within a cubic region, filtered by an additional predicate.

pub fn scan_and_populate( &mut self, section: &ChunkSection, section_pos: SectionPos, )

Scans a chunk section for POI block states and populates the storage.

Panics

Panics if the POI type registry contains an inconsistent state-to-type mapping.

pub fn on_block_state_change( &mut self, pos: BlockPos, old_state: BlockStateId, new_state: BlockStateId, )

Updates POI storage when a block state changes.

Panics

Panics if the POI type registry contains an inconsistent state-to-type mapping.

pub fn collect_for_chunk(&self, chunk_pos: ChunkPos) -> Vec<(BlockPos, u32)>

Collects all POI data in a chunk column for persistence.

Returns (BlockPos, free_tickets) for each POI.

pub fn restore_tickets( &mut self, chunk_pos: ChunkPos, tickets: &[(BlockPos, u32)], )

Restores ticket state for POIs after loading from disk.

Called after scan_and_populate has created fresh POIs from block states. Applies saved free_tickets values to matching positions.

pub fn remove_chunk(&mut self, chunk_pos: ChunkPos)

Removes all POI data for a chunk column. Called during chunk unload.

Trait Implementations

impl Default for PointOfInterestStorage

fn default() -> Self

Returns the “default value” for a type.