Struct ChunkManager 

pub struct ChunkManager { /* private fields */ }

Resource for managing all chunks in the world.

Provides methods to query chunks by position and convert between world positions and chunk positions.

Example

use bevy::prelude::*;
use chunky_bevy::prelude::*;

fn check_chunk(
    chunk_manager: Res<ChunkManager>,
    player_pos: Vec3,
) {
    // Get the chunk position the player is in
    let chunk_pos = chunk_manager.get_chunk_pos(&player_pos);
     
    // Check if that chunk is loaded
    if chunk_manager.is_loaded(&chunk_pos) {
        println!("Player is in a loaded chunk!");
    }
}

Implementations

impl ChunkManager

pub fn new(chunk_size: Vec3) -> ChunkManager

Creates a new chunk manager with the specified chunk size.

pub fn get_size(&self) -> Vec3

Returns the size of chunks in world units.

pub fn insert(&mut self, pos: IVec3, id: Entity) -> Option<Entity>

Inserts a new chunk into the manager.

Returns the previous chunk entity if one already existed at this position.

Note: Called automatically when a Chunk component is added.

pub fn remove(&mut self, pos: &IVec3) -> Option<Entity>

Removes a chunk from the manager.

Returns the chunk’s entity if it existed.

Note: Called automatically when a Chunk component is removed.

pub fn get_chunk_pos(&self, pos: &Vec3) -> IVec3

Converts world coordinates into chunk position.

Example

use bevy::prelude::*;
use chunky_bevy::prelude::*;

fn example(chunk_manager: Res<ChunkManager>) {
    let world_pos = Vec3::new(15.0, 5.0, 23.0);
    let chunk_pos = chunk_manager.get_chunk_pos(&world_pos);
    // With default 10x10x10 chunks, this returns IVec3(1, 0, 2)
}

pub fn get_chunk(&self, chunk_pos: &IVec3) -> Option<Entity>

Gets the chunk entity at the specified chunk position if it exists.

pub fn get_chunk_form_pos(&self, pos: &Vec3) -> Option<Entity>

Gets the chunk entity at the specified world position if it exists.

pub fn is_loaded(&self, chunk_pos: &IVec3) -> bool

Checks if a chunk is loaded at the specified chunk position.

Trait Implementations

impl Default for ChunkManager

fn default() -> ChunkManager

Returns the “default value” for a type.

impl Resource for ChunkManager

where ChunkManager: Send + Sync + 'static,