完整版BedrockWiki镜像！

2025-03-20 11:52:46 +08:00
parent 1994c41f01
commit bf9aa4b056
214 changed files with 9042 additions and 8867 deletions
--- a/docs/wiki/entities/runtime-identifier.md
+++ b/docs/wiki/entities/runtime-identifier.md
@@ -0,0 +1,422 @@
+---
+title: 运行时标识符
+category: 文档
+mentions:
+    - MedicalJewel105
+    - aexer0e
+    - Luthorius
+    - SirLich
+    - TheDoctor15
+    - ChibiMango
+    - stirante
+    - epxzzy
+    - IlkinQafarov
+    - TheItsNameless
+    - SmokeyStack
+    - ThomasOrs
+    - Goatfu
+---
+
+# 运行时标识符
+
+<!--@include: @/wiki/bedrock-wiki-mirror.md-->
+
+`runtime_identifier` 是位于实体行为文件描述部分的可选参数，用于模拟原版实体的硬编码特性。
+它接受原版 Minecraft 标识符，例如 `minecraft:shulker`。
+
+::: code-group
+```json [行为实体描述]
+"description": {
+    "identifier": "wiki:my_box",
+    "runtime_identifier": "minecraft:shulker", // 此运行时标识符会将潜影贝的硬编码行为附加到当前实体
+    "is_spawnable": true,
+    "is_summonable": true,
+    "is_experimental": false
+}
+```
+
+:::tip 注意
+需要注意 `runtime_identifier` **仅解析实体的硬编码特性**。这意味着使用100%数据驱动的生物作为运行时标识符不会给实体添加新特性。此外，某些实体运行时可能会覆盖组件部分定义的属性，例如潜影贝实体的碰撞箱尺寸。
+:::
+
+:::warning 警告
+此处未列出所有运行时标识符效果。建议通过实验自行探索新效果，也欢迎在此补充发现。
+:::
+
+## 已知的运行时标识符效果：
+
+-   所有运行时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
+
+-   死亡时爆炸
+
+---