完整版BedrockWiki镜像！
This commit is contained in:
boybook
357
docs/wiki/entities/village-mechanic.md
Normal file
357
docs/wiki/entities/village-mechanic.md
Normal file
@@ -0,0 +1,357 @@
|
||||
---
|
||||
title: 村庄机制
|
||||
category: 巧思案例
|
||||
mentions:
|
||||
- AeroForta
|
||||
- MedicalJewel105
|
||||
- stirante
|
||||
- SmokeyStack
|
||||
- SirLich
|
||||
- Ciosciaa
|
||||
- ThomasOrs
|
||||
---
|
||||
|
||||
# 村庄机制
|
||||
|
||||
<!--@include: @/wiki/bedrock-wiki-mirror.md-->
|
||||
|
||||
本文适用于想要为自定义实体实现村庄机制的开发者
|
||||
|
||||
## 导航行为
|
||||
|
||||
首先从基本导航行为开始。
|
||||
|
||||
::: code-group
|
||||
```json [BP/entities/custom_villager.json#components]
|
||||
"minecraft:preferred_path":{
|
||||
"max_fall_blocks":1,
|
||||
"jump_cost":5,
|
||||
"default_block_cost":1.5,
|
||||
"preferred_path_blocks":[
|
||||
{
|
||||
"cost":0,
|
||||
"blocks":[
|
||||
"grass_path"
|
||||
]
|
||||
},
|
||||
{
|
||||
"cost":1,
|
||||
"blocks":[
|
||||
"cobblestone",
|
||||
"stone"
|
||||
]
|
||||
},
|
||||
{
|
||||
"cost":50,
|
||||
"blocks":[
|
||||
"bed",
|
||||
"lectern"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
允许实体进行随机移动。
|
||||
|
||||
::: code-group
|
||||
```json [BP/entities/custom_villager.json#components]
|
||||
"minecraft:behavior.random_stroll":{
|
||||
"priority":9,
|
||||
"speed_multiplier":0.55,
|
||||
"xz_dist":10,
|
||||
"y_dist":5
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
使实体返回居所范围（在此案例中即村庄边界）。需要下文将解释的`minecraft:dweller`组件。
|
||||
|
||||
::: code-group
|
||||
```json [BP/entities/custom_villager.json#components]
|
||||
"minecraft:behavior.move_towards_dwelling_restriction": {
|
||||
"priority": 4,
|
||||
"speed_multiplier": 1.0
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
通过创建巡逻路径让实体在村庄周围移动。铁傀儡使用的机制。
|
||||
|
||||
::: code-group
|
||||
```json [BP/entities/custom_villager.json#components]
|
||||
"minecraft:behavior.move_through_village": {
|
||||
"priority": 3,
|
||||
"speed_multiplier": 0.6,
|
||||
"only_at_night": true
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
允许实体进入建筑物并在下雨时寻找庇护所。需要开门能力。
|
||||
|
||||
::: code-group
|
||||
```json [BP/entities/custom_villager.json#components]
|
||||
"minecraft:behavior.move_indoors":{
|
||||
"priority":5
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
使实体在日落时留在室内。
|
||||
|
||||
::: code-group
|
||||
```json [BP/entities/custom_villager.json#components]
|
||||
"minecraft:behavior.restrict_open_door":{
|
||||
"priority": 5
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
需搭配使用：
|
||||
|
||||
::: code-group
|
||||
```json [BP/entities/custom_villager.json#components]
|
||||
"minecraft:annotation.open_door":{
|
||||
"priority": 5
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
::: code-group
|
||||
```json [BP/entities/custom_villager.json#components]
|
||||
"minecraft:navigation.walk":{
|
||||
"can_pass_doors":true,
|
||||
"can_open_doors":true
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
::: code-group
|
||||
```json [BP/entities/custom_villager.json#components]
|
||||
"minecraft:behavior.open_door":{
|
||||
"priority":6,
|
||||
"close_door_after":true
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
## 核心行为
|
||||
|
||||
::: code-group
|
||||
```json [BP/entities/custom_villager.json#components]
|
||||
"minecraft:dweller": {
|
||||
"dwelling_type": "village",
|
||||
"dweller_role": "inhabitant",
|
||||
"preferred_profession": "farmer",
|
||||
"update_interval_base": 60,
|
||||
"update_interval_variant": 40,
|
||||
"can_find_poi": true,
|
||||
"can_migrate": true,
|
||||
"first_founding_reward": 5
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
- `dweller_role: inhabitant`\
|
||||
允许实体认领床和钟，需搭配`minecraft:behavior.sleep`。
|
||||
- `preferred_profession: farmer`\
|
||||
为`minecraft:behavior.work`的可选参数
|
||||
- `can_find_poi`\
|
||||
启用后实体可寻找兴趣点。已知兴趣点类型：
|
||||
|
||||
```
|
||||
bed // 床
|
||||
jobsite // 工作站点
|
||||
meeting_area // 聚集点
|
||||
```
|
||||
|
||||
- `can_migrate`\
|
||||
定义实体是否能在不同村庄间迁移
|
||||
|
||||
### 睡眠行为
|
||||
|
||||
可参考[睡眠实体指南](/wiki/entities/sleeping-entities)实现实体睡眠
|
||||
|
||||
### 工作行为
|
||||
|
||||
需要设置"dweller_role"为"inhabitant"，若未设置"preferred_profession"则实体将移动到最近的工作站点。
|
||||
|
||||
::: code-group
|
||||
```json [空值]
|
||||
"minecraft:behavior.work": {
|
||||
"priority": 4,
|
||||
"active_time": 250,
|
||||
"speed_multiplier": 0.5,
|
||||
"goal_cooldown": 200,
|
||||
"sound_delay_min": 100,
|
||||
"sound_delay_max": 200,
|
||||
"can_work_in_rain": false,
|
||||
"work_in_rain_tolerance": 1000,
|
||||
"on_arrival": {
|
||||
"event": "minecraft:resupply_trades",
|
||||
"target": "self"
|
||||
}
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
### 社交行为
|
||||
|
||||
允许实体进行社交活动。
|
||||
需要设置"dweller_role"为"inhabitant"。
|
||||
|
||||
```json
|
||||
"minecraft:behavior.mingle": {
|
||||
"priority": 4,
|
||||
"speed_multiplier": 0.5,
|
||||
"duration": 30,
|
||||
"cooldown_time": 10,
|
||||
"mingle_partner_type": "my:custom_entity",
|
||||
"mingle_distance": 2.0
|
||||
}
|
||||
```
|
||||
|
||||
## 日程系统
|
||||
|
||||
现在将所有机制整合到"minecraft:scheduler"中。
|
||||
首先创建简单配置。
|
||||
将工作行为放入组件组：
|
||||
|
||||
::: code-group
|
||||
```json [空值]
|
||||
"component_groups":{
|
||||
"work_schedule":{
|
||||
"minecraft:behavior.work":{
|
||||
"priority":4,
|
||||
"active_time":250,
|
||||
"speed_multiplier":0.5,
|
||||
"goal_cooldown":200,
|
||||
"sound_delay_min":100,
|
||||
"sound_delay_max":200,
|
||||
"can_work_in_rain":true,
|
||||
"work_in_rain_tolerance":1000,
|
||||
"on_arrival":{
|
||||
"event":"minecraft:resupply_trades",
|
||||
"target":"self"
|
||||
}
|
||||
}
|
||||
},
|
||||
"gather_schedule":{
|
||||
"minecraft:behavior.mingle":{
|
||||
"priority": 5,
|
||||
"speed_multiplier": 0.8,
|
||||
"cooldown_time":10.0,
|
||||
"duration": 30.0,
|
||||
"mingle_dist": 1.5,
|
||||
"mingle_partner_type": "my:custom_entity"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
配置工作日程：
|
||||
|
||||
::: code-group
|
||||
```json [空值]
|
||||
"minecraft:scheduler":{
|
||||
"min_delay_secs":0,
|
||||
"max_delay_secs":10,
|
||||
"scheduled_events":[
|
||||
{
|
||||
"filters":{
|
||||
"all_of":[
|
||||
{
|
||||
"test":"hourly_clock_time",
|
||||
"operator":">=",
|
||||
"value":0 // 早晨
|
||||
},
|
||||
{
|
||||
"test":"hourly_clock_time",
|
||||
"operator":"<",
|
||||
"value":12000 // 傍晚
|
||||
}
|
||||
]
|
||||
},
|
||||
"event":"work"
|
||||
},
|
||||
{
|
||||
"filters":{
|
||||
"all_of":[
|
||||
{
|
||||
"test":"hourly_clock_time",
|
||||
"operator":">=",
|
||||
"value":21000
|
||||
},
|
||||
{
|
||||
"test":"hourly_clock_time",
|
||||
"operator":"<",
|
||||
"value":24000
|
||||
}
|
||||
]
|
||||
},
|
||||
"event":"gather"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
事件部分配置示例：
|
||||
|
||||
::: code-group
|
||||
```json [空值]
|
||||
"events":{
|
||||
"work":{
|
||||
"remove":{
|
||||
"component_groups":[
|
||||
"gather_schedule"
|
||||
]
|
||||
},
|
||||
"add":{
|
||||
"component_groups":[
|
||||
"work_schedule"
|
||||
]
|
||||
}
|
||||
},
|
||||
"gather":{
|
||||
"remove":{
|
||||
"component_groups":[
|
||||
"work_schedule"
|
||||
]
|
||||
},
|
||||
"add":{
|
||||
"component_groups":[
|
||||
"gather_schedule"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
进入游戏生成实体后放置床，应可见绿色粒子效果。
|
||||
|
||||
## 其他行为
|
||||
|
||||
以下行为可供自定义实体使用：
|
||||
- `minecraft:behavior.move_to_village`\
|
||||
劫掠者使用该机制来留在村庄
|
||||
- `minecraft:behavior.stroll_towards_village`\
|
||||
狐狸使用该机制寻找并前往村庄
|
||||
- `minecraft:behavior.inspect_bookshelf`\
|
||||
管理员村民用于查看书架
|
||||
- `minecraft:behavior.explore_outskirts`\
|
||||
允许实体在村庄外探索（需搭配日程系统组件组保证返回）
|
||||
- `minecraft:behavior.defend_village_target`\
|
||||
用于近战攻击。远程攻击可能误伤具有"inhabitant" role的实体
|
||||
|
||||
可用行为对照表：
|
||||
| 行为名称 | 用途 | 备注 |
|
||||
| ----------------------------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
|
||||
| `minecraft:behavior.defend_village_target` | 允许实体攻击伤害村民的敌人 | 建议仅用于近战攻击型实体 |
|
||||
| `minecraft:behavior.hide` | 村民用于在特定POI隐藏停留 | 当前POI类型文档不完整，建议保持`"poi_type": "bed"` |
|
||||
| `minecraft:behavior.move_to_village` | 劫掠者和女巫用于在村庄范围内随机移动 | - |
|
||||
| `minecraft:behavior.nap` | 狐狸用于小憩 | 类似睡眠但更灵活，内置感知特定实体自动唤醒系统 |
|
||||
Reference in New Issue
Block a user