基岩版行为包 JSON 对照表
> 来源：Microsoft Learn 官方文档
> 更新时间：2026-03-04
---
目录
1. 方块组件 (Block Components)
2. 实体组件 (Entity Components)
3. 物品组件 (Item Components)
4. 通用格式说明
---
方块组件 (Block Components)
| 组件名称 | 描述 | 备注 |
|---|---|---|
| `minecraft:block_light_absorption` | 方块光照吸收（旧版 format_version < 1.19.40） | 已废弃 |
| `minecraft:block_light_emission` | 方块光照发射（旧版） | 已废弃 |
| `minecraft:chest_obstruction` | 箱子障碍物检测 | 实验性功能 |
| `minecraft:collision_box` | 定义方块的碰撞区域 | 用于实体碰撞 |
| `minecraft:connection_rule` | 定义与围栏、墙等方块的连接规则 | 实验性 |
| `minecraft:crafting_table` | 使方块成为自定义合成台 | |
| `minecraft:destroy_time` | 破坏时间（旧版） | 已废弃 |
| `minecraft:destructible_by_explosion` | 爆炸破坏属性 | |
| `minecraft:destructible_by_mining` | 挖掘破坏属性 | |
| `minecraft:destruction_particles` | 破坏粒子效果 | 实验性 |
| `minecraft:display_name` | 显示名称（语言文件键） | |
| `minecraft:embedded_visual` | 嵌入方块内的渲染几何和材质 | 如花盆里的花 |
| `minecraft:entity_fall_on` | 实体落在方块上的事件 | |
| `minecraft:explosion_resistance` | 爆炸抗性（旧版） | 已废弃 |
| `minecraft:flammable` | 可燃属性 | |
| `minecraft:flower_pottable` | 可放置在花盆中 | |
| `minecraft:friction` | 摩擦系数 (0.0-0.9) | |
| `minecraft:geometry` | 渲染几何描述符 | 重要：引用模型 |
| `minecraft:item_visual` | 物品形态的几何和材质 | |
| `minecraft:light_dampening` | 光照衰减 (0-15) | |
| `minecraft:light_emission` | 光照发射 (0-15) | |
| `minecraft:liquid_detection` | 液体检测行为 | |
| `minecraft:loot` | 战利品表路径 | 重要：方块掉落 |
| `minecraft:map_color` | 地图渲染颜色 | |
| `minecraft:material_instances` | 材质实例 | 重要：纹理设置 |
| `minecraft:movable` | 可移动属性 | 实验性 |
| `minecraft:placement_filter` | 放置过滤规则 | 重要：格式需 1.19.60+ |
| `minecraft:precipitation_interactions` | 雨雪交互 | 实验性 |
| `minecraft:random_offset` | 随机偏移 | |
| `minecraft:redstone_conductivity` | 红石传导 | |
| `minecraft:redstone_consumer` | 红石消耗 | |
| `minecraft:redstone_producer` | 红石发射 | |
| `minecraft:replaceable` | 可被替换 | 实验性 |
| `minecraft:selection_box` | 选取框 | |
| `minecraft:support` | 支持形状 | |
| `minecraft:tick` | 定时触发 | |
| `minecraft:transformation` | 平移、旋转、缩放 |
内部/废弃组件
| 组件名称 | 描述 |
|---|---|
| `bone_visibility` | 骨骼可见性 |
| `breathability` | 呼吸属性 |
| `custom_components` | 自定义组件（需脚本） |
| `queued_ticking` | 队列定时 |
| `random_ticking` | 随机定时 |
| `unit_cube` | 单位立方体 |
实体组件 (Entity Components)
> 完整列表包含 200+ 组件，以下为常用组件
基础属性
| 组件名称 | 描述 |
|---|---|
| `minecraft:health` | 生命值 |
| `minecraft:attack` | 攻击伤害 |
| `minecraft:scale` | 尺寸缩放 |
| `minecraft:variant` | 变体 |
| `minecraft:mark_variant` | 标记变体 |
| `minecraft:color` | 颜色 |
| `minecraft:type_family` | 类型家族 |
| `minecraft:nameable` | 可命名 |
移动与导航
| 组件名称 | 描述 |
|---|---|
| `minecraft:movement` | 基础移动速度 |
| `minecraft:movement.basic` | 基础移动 |
| `minecraft:movement.fly` | 飞行移动 |
| `minecraft:movement.swim` | 游泳移动 |
| `minecraft:movement.glide` | 滑翔移动 |
| `minecraft:navigation.walk` | 步行导航 |
| `minecraft:navigation.swim` | 游泳导航 |
| `minecraft:navigation.fly` | 飞行导航 |
| `minecraft:navigation.generic` | 通用导航 |
| `minecraft:jump.static` | 跳跃能力 |
| `minecraft:jump.dynamic` | 动态跳跃 |
行为 AI
| 组件名称 | 描述 |
|---|---|
| `minecraft:follow_range` | 追踪范围 |
| `minecraft:anger_level` | 愤怒等级 |
| `minecraft:angry` | 愤怒状态 |
| `minecraft:tameable` | 可驯服 |
| `minecraft:breedable` | 可繁殖 |
| `minecraft:ageable` | 可成长 |
| `minecraft:leashable` | 可栓绳 |
交互
| 组件名称 | 描述 |
|---|---|
| `minecraft:interact` | 交互行为 |
| `minecraft:rideable` | 可骑行 |
| `minecraft:equippable` | 可装备 |
| `minecraft:inventory` | 物品栏 |
| `minecraft:trade_table` | 交易表 |
| `minecraft:loot` | 掉落战利品 |
物理
| 组件名称 | 描述 |
|---|---|
| `minecraft:physics` | 物理属性 |
| `minecraft:collision_box` | 碰撞箱 |
| `minecraft:pushable` | 可推动 |
| `minecraft:fire_immune` | 火焰免疫 |
| `minecraft:burns_in_daylight` | 阳光下燃烧 |
状态效果
| 组件名称 | 描述 |
|---|---|
| `minecraft:healable` | 可治疗 |
| `minecraft:damage_over_time` | 持续伤害 |
| `minecraft:mob_effect` | 群体效果 |
| `minecraft:mob_effect_immunity` | 效果免疫 |
生命周期
| 组件名称 | 描述 |
|---|---|
| `minecraft:despawn` | 刷怪规则 |
| `minecraft:instant_despawn` | 立即消失 |
| `minecraft:persistent` | 持久存在 |
| `minecraft:transient` | 临时存在 |
物品组件 (Item Components)
| 组件名称 | 描述 |
|---|---|
| `minecraft:allow_off_hand` | 可放置副手 |
| `minecraft:block_placer` | 方块放置器 |
| `minecraft:bundle_interaction` | bundles 交互 |
| `minecraft:can_destroy_in_creative` | 创造模式破坏 |
| `minecraft:compostable` | 可堆肥 |
| `minecraft:cooldown` | 冷却时间 |
| `minecraft:damage` | 伤害值 |
| `minecraft:damage_absorption` | 伤害吸收 |
| `minecraft:digger` | 挖掘工具 |
| `minecraft:display_name` | 显示名称 |
| `minecraft:durability` | 耐久度 |
| `minecraft:dyeable` | 可染色 |
| `minecraft:enchantable` | 可附魔 |
| `minecraft:entity_placer` | 实体放置 |
| `minecraft:fire_resistant` | 防火 |
| `minecraft:food` | 食物 |
| `minecraft:fuel` | 燃料 |
| `minecraft:glint` | 附魔光泽 |
| `minecraft:hand_equipped` | 手持显示 |
| `minecraft:icon` | 图标 |
| `minecraft:item` | 物品定义 |
| `minecraft:max_stack_size` | 最大堆叠数 |
| `minecraft:projectile` | 投射物 |
| `minecraft:rarity` | 稀有度 |
| `minecraft:record` | 唱片音乐 |
| `minecraft:repairable` | 可修复 |
| `minecraft:seed` | 种子 |
| `minecraft:shooter` | 射击器 |
| `minecraft:throwable` | 可投掷 |
| `minecraft:wearable` | 可穿戴 |
通用格式说明
方块 JSON 基础格式
JSON
{
"format_version": "1.19.60",
"minecraft:block": {
"components": {
"minecraft:geometry": "geometry.你的模型",
"minecraft:material_instances": {
"*": {
"texture": "你的纹理"
}
}
},
"description": {
"identifier": "你的命名空间:方块名"
}
}
}format_version 说明
| 版本 | 说明 |
|---|---|
| 1.19.40 | 旧版格式，部分组件可能不可用 |
| 1.19.60+ | 新版格式，推荐使用 |
| 1.21+ | 最新实验性功能 |
常用几何引用（网易版内置）
- `geometry.grass` - 草方块
- `geometry.tall_grass` - 高草丛
- `geometry.flower` - 花
- `geometry.unit_cube` - 单位立方体
---
参考链接
- 方块组件文档
- 实体组件文档
- 物品组件文档