|
|
**2022年12月18日** **对应游戏版本v1.0.0** 皮蛋初版未完成
|
|
|
**2022年12月21日** **对应游戏版本v1.0.0** 皮蛋初版完成
|
|
|
# 根元素
|
|
|
<NPCCharacters>
|
|
|
|
|
|
# 类型名
|
|
|
```
|
|
|
<NPCCharacter id=""
|
|
|
元素1=""
|
|
|
元素2=""
|
|
|
……>
|
|
|
<face>
|
|
|
<face_key_template value="BodyProperty.fighter_vlandia" />
|
|
|
</face>
|
|
|
<skills>
|
|
|
<skill id="Athletics"
|
|
|
value="20" />
|
|
|
<skill id="Riding"
|
|
|
value="5" />
|
|
|
……
|
|
|
</skills>
|
|
|
<upgrade_targets>
|
|
|
<upgrade_target id="NPCCharacter.vlandian_levy_crossbowman" />
|
|
|
</upgrade_targets>
|
|
|
<Equipments>
|
|
|
<EquipmentRoster>
|
|
|
<equipment slot="Item0"
|
|
|
id="Item.vlandia_mace_1_t2" />
|
|
|
<equipment slot="Head"
|
|
|
id="Item.leather_cap" />
|
|
|
<equipment slot="Body"
|
|
|
id="Item.bandit_leather_water_flask" />
|
|
|
……
|
|
|
</EquipmentRoster>
|
|
|
<EquipmentSet id="vlandia_troop_civilian_template_t1"
|
|
|
civilian="true" />
|
|
|
</Equipments>
|
|
|
</NPCCharacter>
|
|
|
```
|
|
|
# 原版路径
|
|
|
Modules\SandBoxCore\ModuleData\spnpccharacters.xml
|
|
|
# 用途
|
|
|
## 兵种的信息
|
|
|
- 兵种的ID
|
|
|
- 兵种的默认分组
|
|
|
- 兵种的等级
|
|
|
- 兵种的名称
|
|
|
- 兵种的文化
|
|
|
- 兵种的脸部码
|
|
|
- 兵种的技能等级
|
|
|
- 该兵种的升级目标兵种
|
|
|
- 兵种的战斗装备和平民装备
|
|
|
# 特点
|
|
|
- 进入主菜单时不载入NPCCharacter角色的数据。只在载入存档的时候读取。
|
|
|
- 但如果存档中某部队中有A兵种，但在xml文件中删除了该兵种的id，游戏读取不到，就会导致存档无法进入。
|
|
|
- 所以，兵种id不可以改变，为了兼容老存档也不可以删除id。
|
|
|
- 下面未出现的元素，是做兵种时通常不出现的元素，NPCCharacter中有很多元素只在特定的情况给特定的角色用。
|
|
|
# 格式示范
|
|
|
```
|
|
|
<NPCCharacter id="vlandian_recruit"
|
|
|
default_group="Infantry"
|
|
|
level="6"
|
|
|
name="{=GEnwDYp1}Vlandian Recruit"
|
|
|
occupation="Soldier"
|
|
|
is_basic_troop="true"
|
|
|
is_hidden_encyclopedia="true"
|
|
|
culture="Culture.vlandia">
|
|
|
<face>
|
|
|
<face_key_template value="BodyProperty.fighter_vlandia" />
|
|
|
</face>
|
|
|
<skills>
|
|
|
<skill id="Athletics"
|
|
|
value="20" />
|
|
|
<skill id="Riding"
|
|
|
value="5" />
|
|
|
<skill id="OneHanded"
|
|
|
value="20" />
|
|
|
<skill id="TwoHanded"
|
|
|
value="10" />
|
|
|
<skill id="Polearm"
|
|
|
value="20" />
|
|
|
<skill id="Bow"
|
|
|
value="5" />
|
|
|
<skill id="Crossbow"
|
|
|
value="5" />
|
|
|
<skill id="Throwing"
|
|
|
value="5" />
|
|
|
</skills>
|
|
|
<upgrade_targets>
|
|
|
<upgrade_target id="NPCCharacter.vlandian_levy_crossbowman" />
|
|
|
<upgrade_target id="NPCCharacter.vlandian_footman" />
|
|
|
</upgrade_targets>
|
|
|
<Equipments>
|
|
|
<EquipmentRoster>
|
|
|
<equipment slot="Item0"
|
|
|
id="Item.vlandia_mace_1_t2" />
|
|
|
<equipment slot="Head"
|
|
|
id="Item.leather_cap" />
|
|
|
<equipment slot="Body"
|
|
|
id="Item.bandit_leather_water_flask" />
|
|
|
<equipment slot="Leg"
|
|
|
id="Item.empire_horseman_boots" />
|
|
|
</EquipmentRoster>
|
|
|
<EquipmentRoster>
|
|
|
<equipment slot="Item0"
|
|
|
id="Item.peasant_pitchfork_1_t1" />
|
|
|
<equipment slot="Body"
|
|
|
id="Item.bandit_leather_water_flask" />
|
|
|
<equipment slot="Leg"
|
|
|
id="Item.empire_horseman_boots" />
|
|
|
<equipment slot="Head"
|
|
|
id="Item.padded_cap" />
|
|
|
<equipment slot="Cape"
|
|
|
id="Item.scarf" />
|
|
|
</EquipmentRoster>
|
|
|
<EquipmentRoster>
|
|
|
<equipment slot="Item0"
|
|
|
id="Item.peasant_pickaxe_1_t1" />
|
|
|
<equipment slot="Body"
|
|
|
id="Item.sackcloth_tunic" />
|
|
|
<equipment slot="Leg"
|
|
|
id="Item.empire_horseman_boots" />
|
|
|
<equipment slot="Head"
|
|
|
id="Item.padded_cap" />
|
|
|
<equipment slot="Cape"
|
|
|
id="Item.hood" />
|
|
|
</EquipmentRoster>
|
|
|
<EquipmentSet id="vlandia_troop_civilian_template_t1"
|
|
|
civilian="true" />
|
|
|
</Equipments>
|
|
|
</NPCCharacter>
|
|
|
```
|
|
|
# 元素说明
|
|
|
- id
|
|
|
- 该兵种的ID
|
|
|
- 不可空
|
|
|
- default_group
|
|
|
- 该兵种的默认分组
|
|
|
- 可填
|
|
|
1. Infantry
|
|
|
步兵
|
|
|
2. Ranged
|
|
|
远程
|
|
|
3. Cavalry
|
|
|
骑兵
|
|
|
4. HorseArcher
|
|
|
骑射
|
|
|
- 影响部队移动速度。前两者为步行单位，可受到“骑行步兵”效果的加成；后两者为骑乘单位，直接增加部队移动速度。
|
|
|
- 影响特长Perk的判定，比如效果：*当部队中步行单位占比超过50%时……*；此效果即用分组来判断是否是步行单位。
|
|
|
- 影响野外战斗时模拟战斗（坐镇指挥）的战斗力，是骑乘单位时，战斗力乘以1.2。
|
|
|
- level
|
|
|
- 该兵种的等级
|
|
|
- 不可空
|
|
|
- 游戏中会根据等级计算得出兵的等阶Tier
|
|
|
- 可填
|
|
|
1. 1
|
|
|
零阶，对应原版的农民，在百科全书中显示为无标志。
|
|
|
2. 6
|
|
|
一阶，对应原版的新兵，在百科全书中显示标志是“一个拐”。
|
|
|
3. 11
|
|
|
二阶，对应原版的贵族兵的初始兵，在百科全书中显示标志是“两个拐”。
|
|
|
4. 16
|
|
|
三阶，在百科全书中显示标志是“三个拐”。
|
|
|
5. 21
|
|
|
四阶，在百科全书中显示标志是“三角”。
|
|
|
6. 26
|
|
|
五阶，对应原版的普通兵种顶级，在百科全书中显示标志是“三角加一横线”。
|
|
|
7. 31
|
|
|
六阶，对应原版的贵族兵种顶级，在百科全书中显示标志是“三角加两横线”。
|
|
|
8. 36
|
|
|
七阶，原版没有，并且代码被屏蔽，需要用代码重新开放，在百科全书中显示标志是“五星加一横线”。
|
|
|
- 实际上，1至5会计算为零阶，6至10会计算为二阶，11至15计算为三阶，以此类推。升级不升阶可能会产生Bug。
|
|
|
- 影响模拟战斗（坐镇指挥）的战斗力，等阶是多少，战斗力即多少。
|
|
|
- 升级前和升级后的等级差决定了升级所需经验值的多少。由公式计算得出。
|
|
|
- name
|
|
|
- 该兵种的名称。
|
|
|
- 加入火星人的强制读取英语翻译文件的功能后，才可以正常读取英语的翻译文件显示英文，否则英文语言设置下，游戏中显示名称只显示name中的字符。
|
|
|
- 格式
|
|
|
```
|
|
|
name="{=此处填写翻译的StringID}此处填写英文名称"
|
|
|
```
|
|
|
- occupation
|
|
|
- 该兵种的职业。
|
|
|
- 不可空
|
|
|
- 对于兵种，填写
|
|
|
1. Soldier
|
|
|
大部分兵种的职业。士兵。
|
|
|
2. CaravanGuard
|
|
|
商队护卫的兵种。
|
|
|
3. Bandit
|
|
|
强盗的兵种。
|
|
|
- is_basic_troop
|
|
|
- 该兵种是否是兵种树的起始。
|
|
|
- 可填参数:"true"
|
|
|
- 可空，空则默认为false
|
|
|
- 只有正确填写此项时，百科全书中显示的与之相关的兵种才能显示为正确的兵种树状态。
|
|
|
- is_hidden_encyclopedia
|
|
|
- 是否在百科全书中隐藏。
|
|
|
- 可填参数:"true"
|
|
|
- 可空，空则默认为false
|
|
|
- culture
|
|
|
- 该兵种的文化。
|
|
|
- 以"Culture.文化id"的格式填写
|
|
|
- 不可空，特殊情况可以考虑用neutral_culture
|
|
|
- [见文化xml文档wiki页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/93/SPCultures%E6%96%87%E5%8C%96)
|
|
|
- 子元素<face>
|
|
|
- 该兵种使用的脸部码。
|
|
|
- 不可空
|
|
|
- 决定了该兵种的肤色、发色、身高、胖瘦、捏脸、发型、胡子、文身或疤痕等外观的随机范围。
|
|
|
- 可填写三种格式
|
|
|
1. 标准的模板id
|
|
|
兵种应使用这种格式。[见脸部码xml文档wiki页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/97/BodyProperties%E6%8D%8F%E8%84%B8%E7%A0%81)
|
|
|
2. 单独的模板
|
|
|
通常不使用这种格式。[见脸部码xml文档wiki页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/97/BodyProperties%E6%8D%8F%E8%84%B8%E7%A0%81)
|
|
|
3. 单独的一个脸部码
|
|
|
兵种通常不使用这种格式。单独的一个码会使得该兵种长得完全一样。
|
|
|
```
|
|
|
格式1：
|
|
|
<face>
|
|
|
<face_key_template value="BodyProperty.此处填写脸部模板id" />
|
|
|
</face>
|
|
|
格式2：
|
|
|
<face>
|
|
|
<BodyProperties version="4"
|
|
|
age="32.64"
|
|
|
weight="0"
|
|
|
build="0.4547"
|
|
|
key="000B7408803C10046F90BC00B2977887957995866795A3633A86FFFF29AB7B4A00070274070F1018000000000000000000000000000000000000000000F04040" />
|
|
|
<BodyPropertiesMax version="4"
|
|
|
age="32.64"
|
|
|
weight="0"
|
|
|
build="0.4547"
|
|
|
key="000B7408803C10046F90BC00B2977887957995866795A3633A86FFFF29AB7B4A00070274070F1018000000000000000000000000000000000000000000F04040" />
|
|
|
</face>
|
|
|
|
|
|
格式3：
|
|
|
<face>
|
|
|
<BodyProperties version="4"
|
|
|
weight="0.3"
|
|
|
build="0.4"
|
|
|
key="0000900A10143006685D493BBC780A4686D18674A5379AA596B62D5A727BC485017776130799B93A000000000000000000000000000000000000000068FC4083" />
|
|
|
</face>
|
|
|
```
|
|
|
- 子元素<skills>
|
|
|
- 该兵种的技能等级
|
|
|
- 可空
|
|
|
- 通常范围0至300
|
|
|
- 可填技能
|
|
|
- OneHanded
|
|
|
单手
|
|
|
- TwoHanded
|
|
|
双手
|
|
|
- Polearm
|
|
|
长杆
|
|
|
- Bow
|
|
|
弓
|
|
|
- Crossbow
|
|
|
弩
|
|
|
- Throwing
|
|
|
投掷
|
|
|
- Riding
|
|
|
骑术
|
|
|
- Athletics
|
|
|
跑动
|
|
|
- 填写其他角色存在的技能也能读取，但没有效果。特殊的，像希绝大陆模组的程序，制作了读取兵种的医疗Medicine技能等级作为其血量上限的功能。
|
|
|
```
|
|
|
格式示范：
|
|
|
<skills>
|
|
|
<skill id="OneHanded" value="此处填写单手技能值" />
|
|
|
<skill id="TwoHanded" value="此处填写双手技能值" />
|
|
|
<skill id="Polearm" value="此处填写长杆技能值" />
|
|
|
<skill id="Bow" value="此处填写弓技能值" />
|
|
|
<skill id="Crossbow" value="此处填写弩技能值" />
|
|
|
<skill id="Throwing" value="此处填写投掷技能值" />
|
|
|
<skill id="Riding" value="此处填写骑术技能值" />
|
|
|
<skill id="Athletics" value="此处填写跑动技能值" />
|
|
|
</skills>
|
|
|
|
|
|
```
|
|
|
- 子元素<upgrade_targets>
|
|
|
- 该兵种可以升级到的兵种
|
|
|
- 可空
|
|
|
- 可填写多个
|
|
|
```
|
|
|
格式：
|
|
|
<upgrade_targets>
|
|
|
<upgrade_target id="NPCCharacter.升级到的兵种id一号" />
|
|
|
<upgrade_target id="NPCCharacter.升级到的兵种id二号" />
|
|
|
……
|
|
|
</upgrade_targets>
|
|
|
```
|
|
|
- 子元素<Equipments>
|
|
|
- 该兵种的装备
|
|
|
- 不可空
|
|
|
- 必须有一套战斗装备和一套日常装备；其中，带有"civilian="true"的是日常装备，反之是战斗装备。
|
|
|
- 骑砍2的随机装备并非是按照“一套”为单位进行随机，而是每个槽位slot都进行随机。
|
|
|
- 所以，当某个兵种有五套装备时，他会使用套装A的头盔，套装B的胸甲，套装C的单手剑，套装D的盾牌，和套装E的马匹。
|
|
|
- 如果某个槽位slot出现了空，那么随机时会作为空进行随机。
|
|
|
- 所以，当某个兵种有五套装备，武器槽位二号slot Item1有两套是盾牌，有三套是空时，该兵种随机到装备盾牌的概率为五分之二；随机到不带盾牌，即空的概率为五分之三。以此方法制作概率佩戴盾牌，概率佩戴头盔等设计的兵种。
|
|
|
- 容易产生的报错
|
|
|
- 当没有日常装备，没有读取到时，会崩溃。
|
|
|
- 当日常装备中填写了非日常装备的物品时，会崩溃。(可见Items的wiki文档页面)[https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/122/Items%E9%98%B2%E5%85%B7%E6%9C%8D%E8%A3%85]
|
|
|
- 当装备槽位slot填写的物品不是该部位的装备时，会崩溃。
|
|
|
- 特殊的，当填写的物品id找不到时，会以空为结果，但不会崩溃。发生该问题后，通常打开百科全书查看该兵种，即可发现该兵种没有佩戴该部位的装备。
|
|
|
- 可填写三种格式。三种格式可以共存。
|
|
|
1. 子元素<EquipmentRoster>
|
|
|
- 兵种的战斗装备常用格式。
|
|
|
- 可空。
|
|
|
- 可以有多个EquipmentRoster。
|
|
|
- 每个EquipmentRoster中包含一套装备。
|
|
|
- 士兵进入战场时，每个装备槽位slot，都会从所有在EquipmentRoster中读取到的slot中随机。
|
|
|
- 可填写的槽位slot
|
|
|
- Item0
|
|
|
武器栏的第一个武器
|
|
|
- Item1
|
|
|
武器栏的第二个武器
|
|
|
- Item2
|
|
|
武器栏的第三个武器
|
|
|
- Item3
|
|
|
武器栏的第四个武器
|
|
|
- Head
|
|
|
防具栏的头部装备
|
|
|
- Cape
|
|
|
防具栏的肩部装备
|
|
|
- Body
|
|
|
防具栏的胸部装备
|
|
|
- Gloves
|
|
|
防具栏的手部装备
|
|
|
- Leg
|
|
|
防具栏的腿部装备
|
|
|
- Horse
|
|
|
骑乘栏的骑乘装备
|
|
|
- HorseHarness
|
|
|
骑乘栏的骑乘防具装备
|
|
|
2. 子元素<EquipmentSet>
|
|
|
- 兵种的日常装备常用格式。
|
|
|
- 可空
|
|
|
- 填写装备模板的id，[见装备模板xml文档wiki页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/89/EquipmentRosters%E8%A3%85%E5%A4%87%E6%A8%A1%E6%9D%BF)
|
|
|
3. 直接填写equipment
|
|
|
- 不推荐使用。
|
|
|
- 会将填写的装备应用至所有的套装中的对应槽位slot。
|
|
|
```
|
|
|
格式示范：
|
|
|
<Equipments>
|
|
|
<!-- 此处开始格式1 -->
|
|
|
<EquipmentRoster>
|
|
|
<equipment slot="Item0"
|
|
|
id="Item.此处填写武器装备id" />
|
|
|
<equipment slot="Body"
|
|
|
id="Item.此处填写防具装备id" />
|
|
|
<equipment slot="Leg"
|
|
|
id="Item.此处填写防具装备id" />
|
|
|
<equipment slot="Horse"
|
|
|
id="Item.此处填写骑乘装备id" />
|
|
|
</EquipmentRoster>
|
|
|
<EquipmentRoster civilian="true">
|
|
|
<equipment slot="Body"
|
|
|
id="Item.此处填写日常装备可用的防具装备id" />
|
|
|
<equipment slot="Item0"
|
|
|
id="Item.此处填写日常装备可用的武器装备id" />
|
|
|
</EquipmentRoster>
|
|
|
<!-- 此处格式1结束 -->
|
|
|
<!-- 此处开始格式2 -->
|
|
|
<EquipmentSet id="此处填写装备模板id" />
|
|
|
<!-- 此处格式2结束 -->
|
|
|
<!-- 此处开始格式3 -->
|
|
|
<equipment slot="Horse"
|
|
|
id="Item.此处填写骑乘装备id" />
|
|
|
<equipment slot="HorseHarness"
|
|
|
id="Item.此处填写骑乘防具装备id" />
|
|
|
<!-- 此处格式3结束 -->
|
|
|
</Equipments>
|
|
|
``` |