00 The Nature of Blocks

1 Overview

Blocks are the basic building units of the Minecraft world. But the word "block" hides an important distinction: in the source code, Block and BlockState are two completely different concepts.

This chapter starts from that distinction, then introduces the design of block states, the full process of placement and breaking, and how they connect to chunk mechanics and the update system.

2 Structure

Blocks and Block States — the essential difference between Block and BlockState, the hard limits on properties and values, the subchunk palette storage model, the boundary between NBT format and block entities, and how fluid state is derived
Placing, Changing, and Breaking Blocks — the shared setBlockState entry point, the exact steps of the placement flow, the two breaking entry points, the meaning of each flag, and the chain of events triggered after a write

00 The Nature of Blocks

1 Overview

Blocks are the basic building units of the Minecraft world. But the word "block" hides an important distinction: in the source code, Block and BlockState are two completely different concepts.

This chapter starts from that distinction, then introduces the design of block states, the full process of placement and breaking, and how they connect to chunk mechanics and the update system.

2 Structure

Blocks and Block States — the essential difference between Block and BlockState, the hard limits on properties and values, the subchunk palette storage model, the boundary between NBT format and block entities, and how fluid state is derived
Placing, Changing, and Breaking Blocks — the shared setBlockState entry point, the exact steps of the placement flow, the two breaking entry points, the meaning of each flag, and the chain of events triggered after a write

#00 The Nature of Blocks

#1 Overview

#2 Structure

#00 The Nature of Blocks

#1 Overview

#2 Structure

00 The Nature of Blocks

1 Overview

2 Structure

00 The Nature of Blocks

1 Overview

2 Structure