Skip to content

运行时标识符

本页面镜像自
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_grazingq.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

  • 死亡时爆炸