概览
minecraft:despawn 是一个实体组件:写在自定义生物的 components 对象中,或其中某个组件组里。 当常规消失规则或你自己的过滤器满足时,把实体从世界中移除。可用来清理远离玩家的生物。
字段
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
despawn_from_chance | Boolean | "true" | 是否使用随机概率规则。 |
despawn_from_distance | JSON Object | 无 | 是否使用玩家最小和最大距离规则,以及具体距离。 |
despawn_from_inactivity | Boolean | "true" | 实体闲置一段时间后是否可以消失。 |
despawn_from_simulation_edge | Boolean | "true" | 实体到达模拟距离边缘时是否立刻消失。 |
filters | Minecraft Filter | 无 | 你自己的消失条件;设置后会跳过常规规则。 |
min_range_inactivity_timer | Integer | "30" | 实体必须闲置多少秒才能消失。 |
min_range_random_chance | Integer | "800" | 以 1/该数值 的概率消失。 |
remove_child_entities | Boolean | "false" | 同时移除与它关联的实体,比如被拴住的生物。 |
示例
写在 BP/entities/<name>.json 的 components 对象中(值为默认值或占位值):
BP/entities/<name>.json
{
"minecraft:despawn": {
"despawn_from_chance": "true",
"despawn_from_distance": {},
"despawn_from_inactivity": "true",
"despawn_from_simulation_edge": "true",
"filters": {},
"min_range_inactivity_timer": "30",
"min_range_random_chance": "800",
"remove_child_entities": "false"
}
}