258 lines
20 KiB
Markdown
258 lines
20 KiB
Markdown
---
|
||
title: 投射物
|
||
mentions:
|
||
- SirLich
|
||
- stirante
|
||
- retr0cube
|
||
- SmokeyStack
|
||
- Luthorius
|
||
- ThomasOrs
|
||
---
|
||
|
||
# 投射物
|
||
|
||
<!--@include: @/wiki/bedrock-wiki-mirror.md-->
|
||
|
||
## 概述
|
||
|
||
本文档旨在记录`minecraft:projectile`实体行为组件中可使用的所有字段。
|
||
|
||
:::warning
|
||
_免责声明：该组件的文档主要基于游戏中存在的投射物或通过逆向工程获得。_
|
||
_最后测试版本为 **1.18.2**。_
|
||
:::
|
||
|
||
| 字段名称 | 类型 | 默认值 | 描述 |
|
||
| ------------------------- | ----------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| anchor | 整数 | | |
|
||
| angle_offset | 小数 | 0 | 决定投射物被抛射时的角度 |
|
||
| catch_fire | 布尔值 | false | 若为true，被击中的实体将被点燃 |
|
||
| crit_particle_on_hurt | 布尔值 | false | 若为true，投射物在造成暴击时会产生特殊粒子效果 |
|
||
| destroy_on_hurt | 布尔值 | false | 若为true，投射物在击中时会被销毁 |
|
||
| filter | 字符串 | | 此处定义的实体类型不会被投射物伤害 |
|
||
| fire_affected_by_griefing | 布尔值 | false | 若为true，投射物的引燃效果受游戏规则"mobGriefing"影响 |
|
||
| gravity | 小数 | 0.05 | 投射物抛射时应用的引力值。数值越大下坠越快 |
|
||
| hit_ground_sound | 字符串 | | 投射物击中地面时播放的音效 |
|
||
| hit_sound | 字符串 | | 投射物击中实体时播放的音效 |
|
||
| homing | 布尔值 | false | 若为true，投射物会自动追踪最近目标。**在1.18.2版本中不可用** |
|
||
| inertia | 小数 | 0.99 | 投射物在空气中飞行时每帧保留的速度比例 |
|
||
| is_dangerous | 布尔值 | false | 若为true，投射物将被视为对玩家具有威胁性 |
|
||
| knockback | 布尔值 | true | 若为true，投射物会击退被击中的实体 |
|
||
| lightning | 布尔值 | false | 若为true，被击中的实体将遭受雷击 |
|
||
| liquid_inertia | 小数 | 0.6 | 投射物在水中飞行时每帧保留的速度比例 |
|
||
| multiple_targets | 布尔值 | true | 若为true，投射物在飞行过程中可以击中多个实体 |
|
||
| offset | 三维向量 [a,b,c] | [0, 0.5, 0] | 投射物生成时相对于实体锚点的偏移量 |
|
||
| on_fire_time | 小数 | 5 | 被击中实体持续燃烧的时间（秒） |
|
||
| on_hit | 对象 | | 投射物击中时的行为。详见[下方说明](#on_hit) |
|
||
| particle | 字符串 | iconcrack | 碰撞时使用的粒子效果 |
|
||
| potion_effect | 整数 | -1 | 定义箭矢击中实体时施加的药水效果 |
|
||
| power | 小数 | 1.3 | 决定投射物的初速度 |
|
||
| reflect_on_hurt | 布尔值 | false | 若为true，投射物被击中时会反弹 |
|
||
| semi_random_diff_damage | 布尔值 | false | 若为true，伤害值将基于基础伤害和速度进行随机计算 |
|
||
| shoot_sound | 字符串 | | 投射物发射时播放的音效 |
|
||
| shoot_target | 布尔值 | true | 若为true，投射物将朝向发射者的目标方向射出 |
|
||
| should_bounce | 布尔值 | false | 若为true，投射物击中时会反弹 |
|
||
| splash_potion | 布尔值 | false | 若为true，投射物将被视为喷溅药水 |
|
||
| splash_range | 小数 | 4 | '溅射'效果的半径（方块） |
|
||
| stop_on_hurt | 布尔值 | | |
|
||
| uncertainty_base | 小数 | 0 | 基础精准度。实际精准度计算公式为：uncertaintyBase - difficultyLevel \* uncertaintyMultiplier |
|
||
| uncertainty_multiplier | 小数 | 0 | 难度对精准度的影响系数。实际精准度计算公式为：uncertaintyBase - difficultyLevel \* uncertaintyMultiplier |
|
||
| hit_water | 布尔值 | false | 若为true，液态方块将被视为固体。**需要启用"教育版"功能** |
|
||
|
||
## on_hit
|
||
|
||
该对象包含投射物击中目标时可执行的所有行为。
|
||
|
||
### arrow_effect
|
||
|
||
_具体作用未知_
|
||
|
||
### teleport_owner
|
||
|
||
将发射者传送到击中位置。
|
||
|
||
### catch_fire
|
||
|
||
_具体作用未知_
|
||
点燃目标
|
||
|
||
### ignite
|
||
|
||
_具体作用未知_
|
||
点燃目标
|
||
|
||
### remove_on_hit
|
||
|
||
击中目标后移除投射物。
|
||
|
||
### douse_fire
|
||
|
||
_具体作用未知_
|
||
|
||
### impact_damage
|
||
|
||
造成碰撞伤害。
|
||
|
||
| 字段名称 | 类型 | 描述 |
|
||
| ------------------------------ | --------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
|
||
| damage | 整数/整数数组 [min, max] | 对实体造成的伤害值 |
|
||
| semi_random_diff_damage | 布尔值 | |
|
||
| max_critical_damage | 小数 | |
|
||
| min_critical_damage | 小数 | |
|
||
| power_multiplier | 小数 | |
|
||
| channeling | 布尔值 | |
|
||
| set_last_hurt_requires_damage | 布尔值 | |
|
||
| destroy_on_hit_requires_damage | 布尔值 | |
|
||
| filter | 字符串 | 受影响的实体类型。此过滤器较为基础，只能通过标识符进行匹配 |
|
||
| destroy_on_hit | 布尔值 | |
|
||
| knockback | 布尔值 | |
|
||
| catch_fire | 布尔值 | 控制是否点燃目标 |
|
||
|
||
### definition_event
|
||
|
||
触发击中事件。
|
||
|
||
| 字段名称 | 类型 | 描述 |
|
||
| ---------------------- | -------- | ------------------------------------------- |
|
||
| affect_projectile | 布尔值 | 为投射物实体触发事件 |
|
||
| affect_shooter | 布尔值 | 为发射者实体触发事件 |
|
||
| affect_target | 布尔值 | 为被击中实体触发事件 |
|
||
| affect_splash_area | 布尔值 | 为区域内所有实体触发事件 |
|
||
| splash_area | 小数 | 实体作用范围半径 |
|
||
| event_trigger | 对象 | 要触发的事件。结构如下： |
|
||
|
||
| 字段名称 | 类型 | 描述 |
|
||
| ----------- | -------- | ----------------------------- |
|
||
| event | 字符串 | 要触发的事件名称 |
|
||
| target | 字符串 | 事件目标 |
|
||
| filters | 对象 | 触发事件所需的过滤条件 |
|
||
|
||
### stick_in_ground
|
||
|
||
将投射物插入地面。
|
||
|
||
| 字段名称 | 类型 | 描述 |
|
||
| -------------- | -------- | ---- |
|
||
| shake_time | 小数 | |
|
||
|
||
### spawn_aoe_cloud
|
||
|
||
生成药水效果的区域云。
|
||
|
||
| 字段名称 | 类型 | 描述 |
|
||
| ----------------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| radius | 小数 | 云效果半径 |
|
||
| radius_on_use | 小数 | |
|
||
| potion | 整数 | 滞留药水ID |
|
||
| particle | 字符串 | 区域云的[原版粒子效果](/wiki/particles/vanilla-particles)。仅接受原版粒子。**dragonbreath**允许使用瓶子收集龙息 |
|
||
| duration | 整数 | 云效果持续时间（秒） |
|
||
| color | 整数数组 [r, g, b] | 粒子颜色 |
|
||
| affect_owner | 布尔值 | 药水效果是否影响发射者（对玩家无效） |
|
||
| reapplication_delay | 整数 | 药水效果重复施加的时间间隔（刻） |
|
||
|
||
#### 药水ID
|
||
|
||
| 药水名称 | 普通 | 延长版 | 强化版（II级） |
|
||
| ------------------------ | ------- | ------- | ------------- |
|
||
| 水瓶 | 0 | | |
|
||
| 平凡药水 | 1 | 2 | |
|
||
| 浓稠药水 | 3 | | |
|
||
| 粗制药水 | 4 | | |
|
||
| 夜视药水 | 5 | 6 | |
|
||
| 隐身药水 | 7 | 8 | |
|
||
| 跳跃药水 | 9 | 10 | 11 |
|
||
| 抗火药水 | 12 | 13 | |
|
||
| 迅捷药水 | 14 | 15 | 16 |
|
||
| 迟缓药水 | 17 | 18 | |
|
||
| 水肺药水 | 19 | 20 | |
|
||
| 治疗药水 | 21 | | 22 |
|
||
| 伤害药水 | 23 | | 24 |
|
||
| 剧毒药水 | 25 | 26 | 27 |
|
||
| 再生药水 | 28 | 29 | 30 |
|
||
| 力量药水 | 31 | 32 | 33 |
|
||
| 虚弱药水 | 34 | 35 | |
|
||
| 衰变药水 | 36 | | |
|
||
| 神龟药水 | 37 | 38 | 39 |
|
||
| 缓降药水 | 40 | 41 | |
|
||
| 迟缓IV药水 | 42 | | |
|
||
| 跳跃提升IV药水 | 43+ | | |
|
||
|
||
### spawn_chance
|
||
|
||
击中时生成实体。
|
||
|
||
| 字段名称 | 类型 | 描述 |
|
||
| ------------------------------- | -------- | ------------------------------- |
|
||
| first_spawn_percent_chance | 小数 | |
|
||
| second_spawn_percent_chance | 小数 | |
|
||
| first_spawn_count | 整数 | |
|
||
| second_spawn_count | 整数 | |
|
||
| spawn_definition | 字符串 | 要生成的实体ID |
|
||
| spawn_baby | 布尔值 | 生成的实体是否为幼体 |
|
||
|
||
### particle_on_hit
|
||
|
||
击中时生成粒子效果。
|
||
|
||
| 字段名称 | 类型 | 描述 |
|
||
| ----------------- | -------- | ----------------------------------------------- |
|
||
| particle_type | 字符串 | 使用的[原版粒子效果](/wiki/particles/vanilla-particles) |
|
||
| num_particles | 整数 | 粒子数量 |
|
||
| on_entity_hit | 布尔值 | 是否在击中实体时生成粒子 |
|
||
| on_other_hit | 布尔值 | 是否在其他碰撞时生成粒子 |
|
||
|
||
### mob_effect
|
||
|
||
对目标施加生物状态效果。
|
||
|
||
| 字段名称 | 类型 | 描述 |
|
||
| ------------------ | -------- | ------------------------------- |
|
||
| effect | 字符串 | 效果类型 |
|
||
| duration | 整数 | 效果持续时间 |
|
||
| durationeasy | 整数 | 简单难度下的持续时间 |
|
||
| durationnormal | 整数 | 普通难度下的持续时间 |
|
||
| durationhard | 整数 | 困难难度下的持续时间 |
|
||
| amplifier | 整数 | 效果等级 |
|
||
| ambient | 布尔值 | |
|
||
| visible | 布尔值 | |
|
||
|
||
### grant_xp
|
||
|
||
尽管名称如此，该行为实际上是生成指定数量的经验球。
|
||
|
||
| 字段名称 | 类型 | 描述 |
|
||
| --------- | -------- | ------------------------------------------- |
|
||
| minXP | 整数 | 给予的最小经验值 |
|
||
| maxXP | 整数 | 给予的最大经验值 |
|
||
| xp | 整数 | 固定经验值。设置后将覆盖min和max值 |
|
||
|
||
### freeze_on_hit
|
||
|
||
_具体作用未知_
|
||
|
||
_需要启用教育版功能_
|
||
冻结命中点周围的水。
|
||
|
||
| 字段名称 | 类型 | 描述 |
|
||
| ----------------- | -------- | --------------------- |
|
||
| shape | 字符串 | "sphere" 或 "cube" |
|
||
| snap_to_block | 布尔值 | |
|
||
| size | 整数 | 冻结效果的范围大小 |
|
||
|
||
### hurt_owner
|
||
|
||
_具体作用未知。当前版本可能导致游戏崩溃（可能参数错误）_
|
||
|
||
| 字段名称 | 类型 | 描述 |
|
||
| ---------------- | -------- | ---- |
|
||
| owner_damage | 整数 | |
|
||
| knockback | 布尔值 | |
|
||
| ignite | 布尔值 | |
|
||
|
||
### thrown_potion_effect
|
||
|
||
_具体作用未知。当前版本可能导致游戏崩溃（可能仅适用于投掷药水）_
|
||
|
||
## 补充说明
|
||
|
||
在创建自定义投射物（如箭矢变体或全新物品）时，建议定义[运行时标识符](/wiki/entities/runtime-identifier)来确保预期行为。未正确设置可能导致异常表现，包括显示错误、击退方向异常，甚至出现可用徒手摧毁的箭矢等问题。 |