mc173 0.2.0

Minecraft beta 1.7.3 base data structures and logic for running a world
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

//! Various shortcut methods to directly check block materials.

use glam::IVec3;

use crate::block::material::Material;
use crate::block;

use super::World;


/// Shortcut methods for directly querying and checking a block material and properties.
impl World {

    /// Get the block material at given position, defaults to air if no chunk.
    pub fn get_block_material(&self, pos: IVec3) -> Material {
        self.get_block(pos).map(|(id, _)| block::material::get_material(id)).unwrap_or_default()
    }

    /// Return true if the block at given position can be replaced.
    pub fn is_block_replaceable(&self, pos: IVec3) -> bool {
        if let Some((id, _)) = self.get_block(pos) {
            block::material::get_material(id).is_replaceable()
        } else {
            false
        }
    }

    /// Return true if the block at position is opaque.
    /// 
    /// FIXME: A lot of calls to this function should instead be for "normal_cube". This
    /// is not exactly the same properties in the Notchian implementation.
    pub fn is_block_opaque_cube(&self, pos: IVec3) -> bool {
        if let Some((id, _)) = self.get_block(pos) {
            block::material::is_opaque_cube(id)
        } else {
            false
        }
    }

    /// Return true if the block at position is material solid.
    pub fn is_block_solid(&self, pos: IVec3) -> bool {
        if let Some((id, _)) = self.get_block(pos) {
            block::material::get_material(id).is_solid()
        } else {
            false
        }
    }

    /// Return true if the block at position is air.
    #[inline]
    pub fn is_block_air(&self, pos: IVec3) -> bool {
        if let Some((id, _)) = self.get_block(pos) {
            id == block::AIR
        } else {
            true
        }
    }

    /// Return true if the block at position is the given one. 
    #[inline]
    pub fn is_block(&self, pos: IVec3, id: u8) -> bool {
        if let Some((pos_id, _)) = self.get_block(pos) {
            pos_id == id
        } else {
            false  // TODO: id == block::AIR ? because non existing position are air
        }
    }

}