方块图鉴

按“它是怎么来的”分类。贴图直接来自游戏资源包 resourcePacks/Vanilla/block/，与游戏内完全一致 —— 换资源包，这一页跟着变。

地形生成 4 种矿脉 4 种矮树 2 种合成 2 种 mapper 共 15 个 block key

地形生成引擎自己的生成器

引擎的 BlockOutputter 只会造这 4 种方块；其余都是后加的。

$\text{[math]}$

草方块grass_block

地表最上层，挖掉掉泥土

$\text{[math]}$

泥土dirt

草方块下面几层

$\text{[math]}$

石头stone

深层主体，也是矿脉生长的母体

$\text{[math]}$

草grass_plant

地表装饰，不掉落

矿脉内核在区块生成末尾种入

只替换石头、只长在“埋着”的位置（正上方不是空气）。位置完全确定性：只由区块坐标决定，重进游戏不会变。

$\text{[math]}$

煤矿石coal_ore

每区块 6 处脉 · 半径 2 · 掉煤炭

$\text{[math]}$

铁矿石iron_ore

每区块 4 处脉 · 半径 2 · 掉铁

$\text{[math]}$

金矿石gold_ore

每区块 2 处脉 · 半径 1 · 掉金

$\text{[math]}$

钻石矿石diamond_ore

每区块 1 处脉 · 半径 1 · 掉钻石

实测（281 个区块）：煤 804、铁 303、金 75、钻石 14 —— 越贵越少；所有矿石快照都带碰撞矩形（oresWithoutCollision=0），不会穿模掉进地里。

矿石贴图是程序化生成的占位图（拿 stone.png 染色、加矿点，16×48 三变体），想换成美术图直接替换 resourcePacks/Vanilla/block/*_ore.png 即可。

矮树地形生成器不产木头，内核补的

区块只有 16 高、地表大约在 localY 11 附近，所以种的是矮树：2 格树干 + 一层树冠（放不下就跳过）。

$\text{[math]}$

原木log

树干，砍了掉原木

$\text{[math]}$

树叶leaves

树冠，不掉落

$\text{[math]}$

树干trunk

资源包里有的装饰方块（可由 mod 放置）

$\text{[math]}$

树根root

资源包里有的装饰方块

$\text{[math]}$

树枝branch

资源包里有的装饰方块

产物	配方	产出
$\text{[math]}$ 木板	原木 ×1（放进 3×3 任意格）	×4
$\text{[math]}$ 火把	木板 ×1 + 煤炭 ×1（无序）	×4

掉落总表

方块	掉落	说明
$\text{[math]}$ 煤矿石	煤炭	矿石掉材料，不掉方块本身
$\text{[math]}$ 铁矿石	铁	同上
$\text{[math]}$ 金矿石	金	同上
$\text{[math]}$ 钻石矿石	钻石	同上
$\text{[math]}$ 草方块	泥土	和 Minecraft 一致
$\text{[math]}$ 树叶 / 草	—	不掉东西
其余方块	掉自己	石头 / 泥土 / 原木 / 木板 / 火把 / 树干 / 树根 / 树枝

方块属性

属性	值	备注
贴图尺寸	16×48（3 个变体竖排）	火把是 16×144（9 个变体），木板只有 16×16
一个方块	16 像素	`config/constants.json → blockSize`
区块容量	16×16	`chunkBlockCapacity`
实体判定	`solid && !isBackground && collisionRect != null`	碰撞矩形用区块局部坐标，客户端自己加区块偏移
背景层	非实体、挖不掉	所以没有掉落 —— 判定“能不能挖”要看前景层
放置出来的方块	基础 `Block`（solid = true）	`BlockManager.setBlock` 不走方块注册表

方块注册表（BlockTypeRegistry）默认只注册 4 种；内核额外注册了 coal_ore / iron_ore / gold_ore / diamond_ore / log / leaves —— 未注册的类型会被 create() 静默退回草方块，所以生成前必须先注册。

方块图鉴

地形生成 引擎自己的生成器

矿脉 内核在区块生成末尾种入

矮树 地形生成器不产木头，内核补的

合成得到

掉落总表

方块属性

地形生成引擎自己的生成器

矿脉内核在区块生成末尾种入

矮树地形生成器不产木头，内核补的