Wiki/pages/NPCCharacters兵种.md

2022年12月18日 对应游戏版本v1.0.0 皮蛋初版未完成 2022年12月21日 对应游戏版本v1.0.0 皮蛋初版完成

根元素

类型名

<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页面
• 子元素
  • 该兵种使用的脸部码。
  • 不可空
  • 决定了该兵种的肤色、发色、身高、胖瘦、捏脸、发型、胡子、文身或疤痕等外观的随机范围。
  • 可填写三种格式
    1. 标准的模板id 兵种应使用这种格式。见脸部码xml文档wiki页面
    2. 单独的模板 通常不使用这种格式。见脸部码xml文档wiki页面
    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>

• 子元素
  • 该兵种的技能等级
  • 可空
  • 通常范围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>

• 子元素
  • 该兵种的装备
  • 不可空
  • 必须有一套战斗装备和一套日常装备；其中，带有"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中包含一套装备。
       • 士兵进入战场时，每个装备槽位slot，都会从所有在EquipmentRoster中读取到的slot中随机。
       • 可填写的槽位slot
         • Item0 武器栏的第一个武器
         • Item1 武器栏的第二个武器
         • Item2 武器栏的第三个武器
         • Item3 武器栏的第四个武器
         • Head 防具栏的头部装备
         • Cape 防具栏的肩部装备
         • Body 防具栏的胸部装备
         • Gloves 防具栏的手部装备
         • Leg 防具栏的腿部装备
         • Horse 骑乘栏的骑乘装备
         • HorseHarness 骑乘栏的骑乘防具装备
    2. 子元素
       • 兵种的日常装备常用格式。
       • 可空
       • 填写装备模板的id，见装备模板xml文档wiki页面
    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>