**2022年12月27日** **对应游戏版本v1.0.0** 皮蛋初版完成

# 根元素
<NPCCharacters>

# 类型名
```
<NPCCharacter id=""
              元素1=""
              元素2=""
              ……>
    <face>
     <BodyProperties version="4" age="28" weight="0.1829" build="0.5108"  key="001B8C0B00001408D97B47C768AE9A976D83A69588AA7449B83728B1A2A22D1B00A836030A8489540000000000000000000000000000000000000000234C5106"  />
    </face>
    <skills></skills>
    <Traits>
      <Trait id="Honor"
             value="1" />
      <Trait id="Calculating"
             value="-1" />     
    </Traits>
    <Equipments>
      <EquipmentRoster />
      <EquipmentSet id="cet_jdy_lord_02" />
      <EquipmentSet id="ase_civ_template_bedouin"
                    civilian="true" />
    </Equipments>
  </NPCCharacter>
```

# 原版路径
Modules\SandBox\ModuleData\lords.xml

# 用途
## 贵族领主的信息
- 领主的ID
- 领主的姓名
- 领主的性别
- 领主的默认分组
- 领主的年龄
- 领主的特质（性格）
- 领主的声音类型
- 领主的文化
- 领主的脸部码
- 领主的技能等级
- 领主的战斗装备和平民装备

# 特点
- 只在创建新存档时读取一次，并以此生成领主/贵族角色。必须配合[Heroes角色所属家族和亲缘关系wiki页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/55/Heroes%E8%A7%92%E8%89%B2%E6%89%80%E5%B1%9E%E5%AE%B6%E6%97%8F%E5%92%8C%E4%BA%B2%E7%BC%98%E5%85%B3%E7%B3%BB)文件才能正常生成。
- 下面未出现的元素，是做兵种时通常不出现的元素，NPCCharacter中有很多元素只在特定的情况给特定的角色用。

# 格式示范
```
  <NPCCharacter id="sika_lord_mgr_09_08"
                name="{=SikaLordNameMGRN08}Jibhaalig"
                age="42"
                voice="curt"               
                default_group="HorseArcher"
                is_hero="true"
                is_female="true"
                culture="Culture.khuzait"
                occupation="Lord"
                face_mesh_cache="true"
                skill_template="SkillSet.template_skills_a14_t3_a">
    <face>
     <BodyProperties version="4" age="42" weight="0.1481" build="0.4072"  key="0020C80AC0B420095626BC879B8921124E8B88B78AB7AB25A697ACAB2E779837004626030458D6AD0000000000000000000000000000000000000000307C4086"  />
    </face>
    <skills></skills>
    <Traits>
      <Trait id="valor"
             value="1" />
      <Trait id="Calculating"
             value="-1" />                  
    </Traits>
    <Equipments>
      <EquipmentRoster />
      <EquipmentSet id="cet_mgr_lord_07" />
      <EquipmentSet id="ase_civ_template_bedouin"
                    civilian="true" />
    </Equipments>
  </NPCCharacter>
```
# 元素说明
- id
  - 该领主的ID
  - 不可空
- name
  - 该角色的名称。
  - 加入火星人的强制读取英语翻译文件的功能后，才可以正常读取英语的翻译文件显示英文，否则英文语言设置下，游戏中显示名称只显示name中的字符。
  - 格式
```
name="{=此处填写翻译的StringID}此处填写英文名称"
```
- age
  - 该角色的年龄。
  - 角色会在18岁成年，成年后才可以参与领主的活动或互动。
  - 角色会在50岁以后开始有概率自然死亡，年龄越大，概率越高。
- voice
  - 该角色的语音声音类型。
  - 可填写
    1. earnest
       认真诚挚的
    2. ironic
       讽刺挖苦的
    3. softspoken
       温和善言的
    4. curt
       唐突失礼的
- default_group
  - 该领主的默认分组
  - 可填
    1. Infantry
       步兵
    2. Ranged
       远程
    3. Cavalry
       骑兵
    4. HorseArcher
       骑射
  - 影响战场上该角色的队伍分组。
- is_hero
  - 该角色是否是英雄。
  - 对于领主来说，应填是。
  - 可填参数:"true"
  - 可空，空则默认为false
- is_female
  - 该角色的性别是否是女。
  - 可填参数:"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)
- occupation
  - 该领主的职业。
  - 不可空
  - 对于领主，填写"Lord"
- face_mesh_cache
  - 该角色是否缓存脸部模型。
  - 具体作用未知。
  - 可填参数:"true"
  - 可空，空则默认为false
- skill_template
  - 该角色的技能模板。
  - 使用模板的办法的情况下，元素"skills"就可以空。反之亦然。
  - 以"SkillSet.技能模板id"的格式填写。
  - 可空
  - [见SkillSets技能模板wiki页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/87/SkillSets%E6%8A%80%E8%83%BD%E6%A8%A1%E6%9D%BF)
- 子元素<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： -->
     <BodyProperties version="4" age="42" weight="0.1481" build="0.4072"  key="0020C80AC0B420095626BC879B8921124E8B88B78AB7AB25A697ACAB2E779837004626030458D6AD0000000000000000000000000000000000000000307C4086"  />
</face>
```
- 子元素<skills>
  - 该角色的技能等级
  - 使用元素"skills"的办法的情况下，skill_template就可以空。反之亦然。
  - 可空
  - 通常范围0至300
  - 可填技能
    - OneHanded
      单手
    - TwoHanded
      双手
    - Polearm
      长杆
    - Bow
      弓
    - Crossbow
      弩
    - Throwing
      投掷
    - Riding
      骑术
    - Athletics
      跑动
    - Tactics
      战术
    - Scouting
      侦查
    - Roguery
      流氓习气
    - Charm
      魅力
    - Trade
      交易
    - Crafting
      锻造
    - Leadership
      统御
    - Steward
      管理
    - Medicine
      医术
    - Engineering
      工程
```
格式示范：
    <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>

```
- 子元素<Traits>
  - 该角色拥有的特质。在骑砍1里俗称性格，但是此处并非严格意义上的性格。
  - 可空，任意一项不填写即默认为零。
  - 每项特质的填写范围是-2至2的整数，会读取成该角色的对应项特质的初始等级。
  - 每项特质在游戏的过程中有经验值，以0位基准，特质经验值每上升或下降1000，就会改变特质等级1级。
  - 可填特质一共有五项
    1. Valor
       胆气
    2. Honor
       荣誉
    3. Generosity
       胸怀
    4. Mercy
       善恶
    5. Calculating
       谋略
  - 不同特质等级所展示的文本见：附表1
  - 特质组合后在百科全书页面的角色评价文本见：附表2
  - 当前骑砍2游戏中的角色特质影响三处：
    1. 玩家首次创建存档时，每个角色的初始好感度等于主角的每项特质与该角色对应特质的差，每差1，好感度下降1。
    2. 在说服系统中，不同特质的角色的说服选项会改变，需要主角具备的特质也不同。
    3. 该角色如果没有填写text，即没有百科全书的介绍，则会生成默认介绍展示，默认介绍中会介绍该角色的特质描述词。
  - 主角的特质经验会随着玩家的行为增加或减少，从而使得特质等级改变。但其他角色似乎不会。
```
格式示范：
    <Traits>
      <Trait id="valor"
             value="1" />
      <Trait id="Calculating"
             value="-1" />                  
    </Traits>
```
- 子元素<Equipments>
  - 该角色的装备
  - 不可空
  - 必须有一套战斗装备和一套日常装备；其中，带有"civilian="true"的是日常装备，反之是战斗装备。
  - 在创建新存档时，读取一次该元素，并将其中的装备穿戴给该领主角色，然后数据相关会保存在存档文件中。之后加载存档不会再读取此处的数据。
  - 如果一个领主有多套装备数据被读取，则会在创建存档时在其中随机一套装备给角色穿戴。
  - 容易产生的报错
    - 当没有日常装备，没有读取到时，会崩溃。
    - 当日常装备中填写了非日常装备的物品时，会崩溃。(可见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>
       - 装备独一无二的角色使用这种格式。
       - 可空。
       - 可填写的槽位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>
```

- 附表
   - 附表1
![QQ截图20221227095910.png](../assets/QQ截图20221227095910-84c8d4a3-ba74-4e22-a10a-36753dfae224.png)
   - 附表2
![QQ图片20221227100124.png](../assets/QQ图片20221227100124-ddfe653b-e4df-454a-b126-e8f59cbea732.png)