Block Types

Block Types

Complete reference of all block types implemented in ZigCraft.

---

Overview

ZigCraft currently features 40 block types spanning terrain, vegetation, ores, and decorative blocks. Each block has properties that define its behavior in the world.

Property	Description
Solid	Blocks player/entity movement
Transparent	Allows light and visibility through
Light Emission	Brightness level emitted (0-15)

---

All Block Types

Terrain Blocks

ID	Block	Solid	Transparent	Light	Color
1	stone	✅	❌	0	Gray
2	dirt	✅	❌	0	Brown
3	grass	✅	❌	0	Green
4	sand	✅	❌	0	Tan
8	cobblestone	✅	❌	0	Dark Gray
9	bedrock	✅	❌	0	Black
10	gravel	✅	❌	0	Gray-Brown
12	snow_block	✅	❌	0	White
17	clay	✅	❌	0	Blue-Gray
19	mud	✅	❌	0	Dark Brown
30	terracotta	✅	❌	0	Orange
31	red_sand	✅	❌	0	Orange-Red
32	mycelium	✅	❌	0	Purple-Gray

---

Liquids & Air

ID	Block	Solid	Transparent	Light	Color
0	air	❌	✅	0	—
5	water	❌	✅	0	Blue

---

Ores

ID	Block	Solid	Transparent	Light	Color
14	coal_ore	✅	❌	0	Black
15	iron_ore	✅	❌	0	Orange-Brown
16	gold_ore	✅	❌	0	Yellow

---

Trees & Logs

ID	Block	Solid	Transparent	Light	Color
6	wood	✅	❌	0	Brown
7	leaves	✅	✅	0	Green
20	mangrove_log	✅	❌	0	Red-Brown
21	mangrove_leaves	✅	✅	0	Green
22	mangrove_roots	✅	✅	0	Brown
23	jungle_log	✅	❌	0	Dark Brown
24	jungle_leaves	✅	✅	0	Green
27	acacia_log	✅	❌	0	Gray-Brown
28	acacia_leaves	✅	✅	0	Green
29	acacia_sapling	✅	✅	0	Green

---

Mushrooms

ID	Block	Solid	Transparent	Light	Color
33	mushroom_stem	✅	❌	0	Off-White
34	red_mushroom_block	✅	❌	0	Red
35	brown_mushroom_block	✅	❌	0	Brown

---

Vegetation & Foliage

ID	Block	Solid	Transparent	Light	Color
13	cactus	✅	✅	0	Dark Green
25	melon	✅	✅	0	Light Green
26	bamboo	✅	✅	0	Bright Green
36	tall_grass	✅	✅	0	Green
37	flower_red	✅	✅	0	Red
38	flower_yellow	✅	✅	0	Yellow
39	dead_bush	✅	✅	0	Tan

---

Utility & Decorative

ID	Block	Solid	Transparent	Light	Color
11	glass	✅	✅	0	Light Blue
18	glowstone	✅	❌	15	Yellow-White

Note: glowstone is the only light-emitting block in the game.

---

Block Properties API

Defined in src/world/block.zig:

pub const BlockType = enum(u8) {
    // ... block definitions

    pub fn isSolid(self: BlockType) bool;
    pub fn isTransparent(self: BlockType) bool;
    pub fn isOpaque(self: BlockType) bool;
    pub fn getColor(self: BlockType) [3]f32;
    pub fn getLightEmission(self: BlockType) u4;
    pub fn getFaceColor(self: BlockType, face: Face) [3]f32;
};

---

Adding New Blocks

To add a new block type:

1. Add entry to BlockType enum in src/world/block.zig
2. Register properties in isSolid(), isTransparent(), getLightEmission(), getColor()
3. Add textures to src/engine/graphics/texture_atlas.zig
4. Update src/world/chunk_mesh.zig for special rendering logic

See Contributing for detailed instructions.

---

_{Source: src/world/block.zig | Last updated: January 2026}