CarrotS 方块

CarrotS 包中的方块定义 · 基于 blocks.json 数据驱动

CarrotS 是长夜项目的一个基础资源包，该项目以此资源包为核心资源构建。 每个方块通过 JSON 配置其属性，包括硬度、透明度、纹理、掉落物、声音等。 所有方块都继承自 CarrotS:default 中的默认值，仅有差别的字段需要显式覆盖。

方块列表

目前 CarrotS 中定义了以下方块：

空气 Air

空气（Air）是构成世界中空白空间的方块。它完全透明，硬度为 0， 碰撞箱为 Empty（无体积），可被替换，物态为气体。 在游戏中不可被选中或破坏。

草方块 Grass

草方块（Grass）是覆盖在大多数陆地生物群系表面的方块。 使用锹采集可获得 CarrotS:grass_block 物品。 具有独立的破坏、放置和行走音效。

石头 Stone

石头（Stone）是地下最常见的固体方块。使用镐采集可获得 CarrotS:stone_block 物品。具有独立的破坏、放置和行走音效。

水 Water

水（Water）是覆盖世界海洋、河流和湖泊的液体方块。 它完全透明，硬度为 0，碰撞箱为 Half_full，可被替换。 行走和跳跃速度减半（0.5 倍率），重力减半。

默认模板 CarrotS:default

CarrotS:default 是一个特殊的条目（numeric_id: 0），它不是可放置的方块， 而是为所有方块提供默认属性值。 当某个方块未定义特定字段时，游戏会回退使用此处的值。

默认声音配置

模板示例

以下展示 blocks.json 中各方块的实际 JSON 定义，帮助理解继承覆写机制。

完整默认模板 CarrotS:default

这是所有方块的基础模板，定义了 21 个默认属性值。 每个显式定义的方块只需写出与以下值不同的字段即可。

最小覆写示例 CarrotS:grass

草方块只覆写了 6 个字段（纹理、地图色、3 种声音、工具类型、掉落物）， 其余 15+ 个属性全部继承自 CarrotS:default。

大量覆写示例 CarrotS:water

水方块覆写了 14 个字段，包括物态、碰撞箱、重力、速度等物理属性， 以及纹理、地图色和全部三种声音。这是目前覆写最多的方块。

属性详解

以下按照 blocks.json 的实际结构，分 physics、sources、interaction 三个分组逐一说明。

name — 名称（顶层字段）

方块的标识名称，位于 JSON 根层级。例如 "air"、"grass"、"stone"。
CarrotS:default 的 name 为 "CarrotS_NONE"，表示它仅作为默认模板。

▸ physics — 物理属性组

包含 10 个子字段，控制方块的硬度、透明度、可燃性、碰撞箱、可替换性、物态、重力、速度修正、跳跃修正、tick 更新。

physics.hardness — 硬度

数值越高，挖掘时间越长。计算公式参考 Minecraft：
挖掘时间 = hardness × 1.5 / 工具速度（待确认）。
空气的硬度为 0，可瞬间破坏。

physics.transparent — 透明度

若为 true，则光线可以穿过该方块，且方块侧面不会被渲染（类似玻璃、空气）。
目前只有 CarrotS:air 显式设置了 true。

physics.flammable — 可燃性

若为 true，该方块可被火焰点燃并蔓延。目前所有方块均不可燃（默认 false）。

physics.integrity — 完整性

控制方块的碰撞箱与外观形态。"A_full" 表示完整的 1×1×1 方块， "Half_full" 表示半格（如水），"Empty" 表示无碰撞箱（如空气）。 未来可能支持台阶 ("slab")、楼梯 ("stair") 等。

physics.replaceable — 可替换性

若为 true，该方块可被其他方块放置时直接替换（如空气可被任何方块替换， 水可被放置的方块替换）。默认 false，表示固体方块不被替换。

physics.state_of_matter — 物态

物理状态：solid（固体）、liquid（液体）、gas（气体）。影响方块的流动与碰撞行为。

physics.gravity — 重力

该方块的重力倍率，影响掉落中的实体或受重力影响的方块（如沙砾）的下落速度。

physics.speed_modifier — 速度修正

玩家在该方块上行走的速度倍率。1.0 为正常速度。可用来制作减速方块（如蛛网 < 1.0）或加速方块（如冰 > 1.0）。

physics.jump_modifier — 跳跃修正

玩家在该方块上跳跃的高度倍率。1.0 为正常跳跃高度。

physics.tickable — 周期性更新

若为 true，该方块每 tick 会收到更新事件（如植物生长、液体流动）。 默认 false，静态方块不需要 tick。

▸ sources — 视觉 & 声源组

包含 7 个子字段，控制纹理、地图颜色、光照等级、光线过滤、三种声音。

sources.texture — 纹理

方块使用的纹理文件路径（相对于 textures/ 目录）。默认值为 "missing.png"（缺失纹理占位图）。
各方块覆写：grass → "grass.png"，stone → "stone.png"。

sources.map_color — 地图颜色

在游戏地图上该方块所呈现的颜色（十六进制 RGB）。例如默认 "#888888" 为灰色。

sources.light_level — 光照等级

方块自身发出的光照强度，范围为 0–15。0 表示不发光。未来发光的方块（如荧石、火把）将使用此属性。

sources.light_filter — 光线过滤

光线穿过该方块后衰减的量，范围为 0–15。默认值 15 表示完全遮挡阳光。 透明方块（如空气、水）应设置较低的值以允许光线透过。

sources.sound_break — 破坏音效

破坏（挖掘）该方块时播放的声音。默认 "block_break"。

sources.sound_place — 放置音效

放置该方块时播放的声音。默认 "block_place"。

sources.sound_step — 行走音效

玩家在该方块上行走时播放的声音。默认 "block_step"。

▸ interaction — 交互属性组

包含 3 个子字段，控制工具类型、掉落物列表、方块实体。

interaction.tool_type — 工具类型

推荐的挖掘工具，"empty" 表示空手即可。未来可能扩展为 "pickaxe"（镐）、"shovel"（锹）、"axe"（斧）等。

interaction.drops — 掉落物

字符串数组，指定方块被破坏后掉落的物品 ID。默认值为空数组 []（不掉落）。
各方块覆写：CarrotS:grass → ["CarrotS:grass_block"]，
CarrotS:stone → ["CarrotS:stone_block"]。

interaction.tile_entity — 方块实体

如果此方块需要存储额外数据（如箱子中的物品、熔炉的进度），则在此指定绑定的 TileEntity 类名。当前所有方块均为 null。

未来规划

• 更多基础方块：泥土、木头、沙砾、沙子、熔岩等
• 多面纹理支持（侧面/顶部/底部使用不同的纹理）
• 方块状态（如方向、含水、年龄等）
• Loot Table 独立配置掉落物与条件
• 方块标签（Block Tags）系统
• 自定义声音资源（sounds/ 目录）
• 液体物理：流动、扩散、与实体交互