Struct BlockPosition 

pub struct BlockPosition {
    pub x: i32,
    pub y: i32,
    pub z: i32,
}

A block position using full 32-bit coordinates.

BlockPosition represents a block’s location in the world without the bit packing constraints of Position. It is used internally for world logic and converts to/from Position for protocol serialization.

Unlike Position, BlockPosition is not directly serialized on the wire — it converts through Position for encoding. This type exists to provide a more ergonomic API for working with block coordinates without worrying about bit packing limitations.

Fields

x: i32

y: i32

z: i32

Implementations

impl BlockPosition

pub fn new(x: i32, y: i32, z: i32) -> Self

Creates a new block position.

pub fn chunk_pos(&self) -> ChunkPosition

Returns the chunk position that contains this block.

Chunk coordinates are derived by dividing block coordinates by 16 (arithmetic right shift by 4). This matches the Minecraft convention where each chunk is a 16x16 column of blocks.

Trait Implementations

impl Clone for BlockPosition

fn clone(&self) -> BlockPosition

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BlockPosition

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

Formats the value using the given formatter.

impl From<BlockPosition> for ChunkPosition

Converts a BlockPosition to the ChunkPosition that contains it.

fn from(pos: BlockPosition) -> Self

Converts to this type from the input type.

impl From<BlockPosition> for Position

Converts a BlockPosition into a Position for wire serialization.

Coordinates outside the Position range (x/z: 26-bit signed, y: 12-bit signed) will be silently truncated during packing.

fn from(pos: BlockPosition) -> Self

Converts to this type from the input type.

impl From<Position> for BlockPosition

Converts a Position (packed wire format) into a BlockPosition (full i32 coordinates).

fn from(pos: Position) -> Self

Converts to this type from the input type.

impl Hash for BlockPosition

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BlockPosition

fn eq(&self, other: &BlockPosition) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for BlockPosition

impl Eq for BlockPosition

impl StructuralPartialEq for BlockPosition