方块组件速查

本页汇总中国版自定义方块所有可用的 JSON 组件，按原版/中国版分组，标注 format_version 差异、可选参数和简要说明。

使用方法

• 方块定义写在行为包 netease_blocks/ 目录下
• 中国版基础方块使用 format_version: "1.10.0"
• 部分组件在 1.19.20+ 有新写法，标注了"新版替代"
• 贴图/声音配置在资源包的 blocks.json 和 terrain_texture.json 中

原版组件 — 物理属性（minecraft:）

组件	旧写法 (1.10.0)	新写法 (1.19.20+)	可选参数	说明
minecraft:destroy_time	{"value": 4.0}	4.0	value: float（0.0=瞬间，-1.0=不可破坏）	挖掘硬度
minecraft:destructible_by_mining	—	{"seconds_to_destroy": 4.0}	seconds_to_destroy: float, 或 true(默认)/false(不可破坏)	替代 destroy_time
minecraft:explosion_resistance	{"value": 6.0}	6.0	value: float（0=无抗性，-1=免疫爆炸）	爆炸抗性
minecraft:destructible_by_explosion	—	{"explosion_resistance": 20.0}	explosion_resistance: float, 或 true(默认)/false(免疫)	替代 explosion_resistance
minecraft:friction	{"value": 0.6}	—	value: 0.0~0.9，越小越滑	表面摩擦力
minecraft:block_light_emission	{"value": 1.0}	—	value: 0.0~1.0（1.0=光照15）	发光等级
minecraft:light_emission	—	15	0~15 整数	替代 block_light_emission
minecraft:block_light_absorption	{"value": 0}	—	value: 0~15，自定义模型必设为 0	光照吸收
minecraft:light_dampening	—	0	0~15 整数	替代 block_light_absorption
minecraft:loot	{"value": "loot_tables/..."}	—	value: str（掉落表相对路径）	掉落表路径
minecraft:map_color	"#4A90D9"	—	十六进制颜色字符串	地图颜色
minecraft:display_name	—	"tile.xxx.name"	语言文件键名字符串（1.19.60+）	物品栏显示名

原版组件 — 方块状态与几何

组件	写法示例	可选参数	说明
minecraft:crafting_table	{"table_name": "xxx", "crafting_tags": ["crafting_table"]}	table_name: str, crafting_tags: array(str)	自定义工作台界面

中国版组件 — 碰撞与渲染（netease:）

组件	类型	可选参数	说明	详细文档
netease:aabb	object	collision: {min:[x,y,z], max:[x,y,z]} 或 array(多盒), clip: 同 collision	碰撞盒，支持多盒组合	自定义基础方块
netease:face_directional	object	type: direction(四面向) / facing_direction(六面向)	多面向旋转	自定义基础方块
netease:render_layer	object	value: opaque / alpha / blend / optionalAlpha	渲染层	自定义基础方块
netease:solid	object	value: true(窒息) / false(不窒息，无阴影)	是否实心	自定义基础方块
netease:pathable	object	value: true(可穿过) / false(障碍物)	AI 寻路	自定义基础方块
netease:connection	object	blocks: array(str)（可连接的方块 identifier 列表）	连接属性	自定义基础方块

中国版组件 — 挖掘与工具（netease:）

组件	类型	可选参数	说明	详细文档
netease:tier	object	digger: shovel/pickaxe/hatchet/hoe, destroy_special: bool, level: 0~4	挖掘工具与等级	自定义基础方块
netease:fuel	object	duration: float（秒，如 10.0）	方块物品形式作为燃料	自定义基础方块
netease:fire_resistant	object	value: true / false	掉落物是否防火	自定义基础方块

中国版组件 — 方块实体与事件（netease:）

组件	类型	可选参数	说明	详细文档
netease:block_entity	object	tick: bool, client_tick: bool, movable: bool	方块实体	自定义方块实体
netease:random_tick	object	enable: bool, tick_to_script: bool	随机 tick	自定义基础方块
netease:redstone_property	object	value: none / break_on_push / block_push	红石/活塞属性	自定义基础方块
netease:neighborchanged_sendto_script	object	value: true / false	邻居变化事件开关	自定义基础方块
netease:listen_block_remove	object	value: true / false	监听 BlockRemoveServerEvent	自定义基础方块

中国版组件 — 交互事件（netease:）

组件	可选参数	说明	触发事件
netease:on_stand_on	send_python_event: true / false	实体站在方块上	OnStandOnBlockServerEvent / ClientEvent
netease:on_step_on	send_python_event: true / false	实体刚移动到方块上	OnStepOnBlockServerEvent / ClientEvent
netease:on_step_off	send_python_event: true / false	实体离开方块上方	OnStepOffBlockServerEvent / ClientEvent
netease:on_before_fall_on	—	实体下落至方块（伤害计算前）	OnBeforeFallOnBlockServerEvent
netease:on_after_fall_on	—	实体下落至方块后（弹跳等）	OnAfterFallOnBlockServerEvent
netease:on_entity_inside	send_python_event: true / false	实体碰撞盒在方块位置	OnEntityInsideBlockServerEvent / ClientEvent

中国版组件 — 放置与显示（netease:）

组件	类型	可选参数	说明	详细文档
netease:may_place_on	object	block: array(str), block_state: array(object), spawn_resources: bool	只能放置在指定方块上	自定义基础方块
netease:custom_tips	object	value: str（支持 § 颜色代码）	物品形式描述文本	自定义基础方块
netease:block_properties	object	properties: array，可选值: piston_block_grabber / slime / breaks_when_fallen_on_by_heavy	特殊属性	自定义基础方块

组件速写模板

基础实心方块

{
  "format_version": "1.10.0",
  "minecraft:block": {
    "description": {
      "identifier": "mymod:block_name",
      "register_to_create_menu": true,
      "category": "Construction"
    },
    "components": {
      "minecraft:destroy_time": { "value": 3.0 },
      "minecraft:explosion_resistance": { "value": 6.0 }
    }
  }
}

透明装饰方块

{
  "format_version": "1.10.0",
  "minecraft:block": {
    "description": {
      "identifier": "mymod:glass_block",
      "register_to_create_menu": true,
      "category": "Construction"
    },
    "components": {
      "minecraft:destroy_time": { "value": 0.3 },
      "minecraft:block_light_absorption": { "value": 0 },
      "netease:render_layer": { "value": "blend" },
      "netease:solid": { "value": false }
    }
  }
}

方块实体（带 tick）

{
  "format_version": "1.10.0",
  "minecraft:block": {
    "description": {
      "identifier": "mymod:machine_block",
      "register_to_create_menu": true,
      "category": "Construction"
    },
    "components": {
      "minecraft:destroy_time": { "value": 5.0 },
      "netease:block_entity": {
        "tick": true,
        "client_tick": false,
        "movable": false
      },
      "netease:neighborchanged_sendto_script": { "value": true }
    }
  }
}