运行时标识符
本页面镜像自 BedrockWiki
根据原始项目协议授权。本文经过AI翻译处理,如有内容遗漏,可以提交PR进行补充。
runtime_identifier
是位于实体行为文件描述部分的可选参数,用于模拟原版实体的硬编码特性。 它接受原版 Minecraft 标识符,例如 minecraft:shulker
。
json
"description": {
"identifier": "wiki:my_box",
"runtime_identifier": "minecraft:shulker", // 此运行时标识符会将潜影贝的硬编码行为附加到当前实体
"is_spawnable": true,
"is_summonable": true,
"is_experimental": false
}
注意
需要注意 runtime_identifier
仅解析实体的硬编码特性。这意味着使用100%数据驱动的生物作为运行时标识符不会给实体添加新特性。此外,某些实体运行时可能会覆盖组件部分定义的属性,例如潜影贝实体的碰撞箱尺寸。
警告
此处未列出所有运行时标识符效果。建议通过实验自行探索新效果,也欢迎在此补充发现。
已知的运行时标识符效果:
- 所有运行时ID都会将实体名称更改为对应原版实体的名称
minecraft:area_effect_cloud
- 导致实体崩溃
minecraft:armor_stand
- 禁用实体阴影
- 击打时立即消失
- 允许装备穿戴/卸除
- 死亡时掉落盔甲架物品
minecraft:arrow
- 为抛射物添加朝向玩家的动画
- 禁用死亡动画/声音/粒子
- 缩小实体阴影(但不会消失)
- 不可交互
- 通过生成蛋或/summon生成时,玩家接触后获得箭矢同时实体消失
- 飞行物理特性和击退效果与箭矢一致
minecraft:axolotl
- 不影响游泳/移动/重力行为
- 类似热带鱼,不同变种值影响水桶名称(如"亮蓝色美西螈桶"或"幼年黄色美西螈桶") 年龄变种: 成年/幼年 颜色变种: 亮色/野生/黄色/青色/蓝色
minecraft:bee
- 添加蜜蜂音效
minecraft:blaze
- 添加烈焰人燃烧音效和粒子
- 实体将具有烈焰人飞行特性(即使未添加飞行行为)
minecraft:boat
- 骑乘时显示船型UI界面
- 禁止实体旋转
- 具有船形固体碰撞箱
minecraft:chest_minecart
- 导致实体崩溃
- 击打后立即消失
- 生成状态异常
- 掉落箱子和矿车
minecraft:chicken
- 部分动画失效
- 更新移动速度
- 实体下落减缓但仍受掉落伤害
- 生成时不携带装备(若原有)
minecraft:cod
- 脱离水体时扑腾
- 使用水桶交互获得鳕鱼桶(放置时生成当前实体而非鳕鱼)
- 赋予特殊游泳和重力特性
minecraft:command_block_minecart
- 导致实体崩溃
- 击打后立即消失
- 生成状态异常
- 掉落矿车
minecraft:cow
- 部分动画失效
- 更新移动速度
- 生成时不携带装备(若原有)
minecraft:dolphin
- 添加
minecraft:movement.dolphin
组件
minecraft:donkey
- 将纹理/模型/动画更换为驴子
minecraft:dragon_fireball
- 完全破坏实体
- 生成龙息火球尾迹粒子
minecraft:egg
- 为抛射物添加朝向玩家的动画
- 导致实体崩溃
- 使用生成蛋生成时会出现在玩家位置而非指定位置,且面朝天空
minecraft:elder_guardian
- 将纹理/模型/动画更换为远古守卫者
- 改变部分行为特性
minecraft:ender_crystal
- 实体将固定在生成方块的中央
- 除传送外始终保持位置不变
- 可放置于任何表面
- 其他实体可穿透
- 无法配置承受伤害
- 无法改变朝向
- 可复活末影龙
- 生成时带火焰效果
minecraft:ender_dragon
- 添加末影龙死亡特效
- 继承末影龙碰撞箱
- 破坏碰撞箱内所有方块(包括底部方块),建议在下方放置不可破坏方块/移除重力/禁用
mobGriefing
规则 - 对碰撞箱2格范围内的玩家造成伤害
- 增加渲染距离
- 只能通过/kill指令消除
minecraft:ender_pearl
- 破坏实体行为
- 受伤时生成粒子
minecraft:endermite
- 受伤时生成粒子
- 导致旋转异常
- 部分动画失效
minecraft:evocation_fang
- 对接触实体造成伤害
- 完全禁用碰撞
minecraft:falling_block
- 导致实体崩溃并下落
- 接触地面后无动画消失,掉落金合欢按钮
- 移除效果附着能力
minecraft:horse
- 将纹理/模型/动画更换为马匹
minecraft:iron_golem
- 允许发动攻击(击退效果垂直增强)
- 加速四肢动画(可手动修复为约1/4速度)
- 可能与村庄/村民逻辑冲突
minecraft:llama_spit
- 添加羊驼唾沫粒子
minecraft:minecart
- 禁用实体阴影
- 死亡时掉落矿车
- 禁止实体旋转
minecraft:panda
- 使
q.is_grazing
和q.sit_mount
能与minecraft:behavior.random_sitting
组件协同工作
minecraft:parrot
- 启用翅膀扇动动画
- 缓慢降落
- 跟随音乐唱片跳舞
minecraft:piglin
- 启用
minecraft:celebrate_hunt
功能(激活 q.is_celebrating)
minecraft:player
- 激活
q.movement_direction
minecraft:pufferfish
- 脱离水体时扑腾
- 使用水桶交互获得河豚桶(放置时生成当前实体而非河豚)
- 赋予特殊游泳和重力特性
minecraft:salmon
- 脱离水体时扑腾
- 使用水桶交互获得鲑鱼桶(放置时生成当前实体而非鲑鱼)
- 赋予特殊游泳和重力特性
minecraft:sheep
- 使
q.is_grazing
能与behavior.eat_block
组件协同工作
minecraft:shulker
冒险模式玩家的方块拟态神器
- 1x1x1固体碰撞箱
- 固定于生成方块的中央
- 附着方块被破坏后传送至附近可用位置
- 在非完整方块(床/台阶等)上生成时自动传送
- 无法修改碰撞箱尺寸
minecraft:shulker_bullet
- 生成潜影贝导弹尾迹粒子
minecraft:slime
- 下落时生成黏液粒子
- 根据变体值分裂(1-5为史莱姆常规尺寸,5以上视为中型)
- 允许攻击同时保持史莱姆跳跃机制(无此标识符时攻击状态无法转向)
minecraft:snowball
- 移除碰撞箱
- 不可交互
- 生成于玩家头部位置
- 无视重力
- 移除实体阴影
- 恒定面朝南方
- 无法发出踏步音效
minecraft:spider
- 蛛网减速失效
minecraft:skeleton
- 治疗效果造成伤害/瞬间伤害效果恢复生命
- 亡灵杀手附魔增伤
- 变体≥1时近战与远程攻击附加凋零效果
minecraft:stray
- 治疗效果造成伤害/瞬间伤害效果恢复生命
- 亡灵杀手附魔增伤
- 免疫冰冻伤害
minecraft:squid
- 支持特殊行为组件(参考squid.json)
- 受伤时生成墨汁粒子
minecraft:thrown_trident
- 为抛射物添加朝向玩家的动画
- 禁用死亡动画/声音/粒子
- 缩小实体阴影(但不会消失)
- 不可交互
- 飞行物理特性和击退效果与三叉戟一致
minecraft:tropicalfish
- 脱离水体时扑腾
- 赋予特殊游泳和重力特性
- 使用水桶获得热带鱼桶(若无variant/mark_variant/color定义则为白色考伯鱼规格,含相关组件时桶名与实体规格对应)
minecraft:wither_skull_dangerous
- 死亡时掉落凋零玫瑰
- 被击杀实体会在原地生成凋零玫瑰(僵尸类异常掉落)
- 持续生成基础烟雾粒子
- 无视重力(使projectile组件实体直线运动)
- 免疫所有伤害
- 仅对无AI目标的实体生效(适用于假人实体和弹射物)
minecraft:xp_orb
- 完全禁用碰撞
- 接触玩家增加经验值
minecraft:zombie
- 治疗效果造成伤害/瞬间伤害效果恢复生命
- 亡灵杀手附魔增伤
minecraft:wither
- 死亡时爆炸