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

# 根元素
<Factions>
# 类型名
<Faction
元素1=""
元素2=""
……>
</Faction>
# 原版路径
Modules\SandBox\ModuleData\spclans.xml
# 用途
## 所有（阵营/派系）家族的信息
- 家族的名称
- 家族的领袖
- 家族的旗帜矢量图码
- 家族的主颜色与副颜色
- 家族的文化
- 家族初始的等阶
- 阵营的默认部队模板
- 百科全书介绍文本
- 小家族的部队指挥官模板
- 小家族的部队复活坐标
- 家族是否是贵族、是否是小家族、是否是宗教类/游牧类/雇佣类/不法类
## 阵营的大体分类
- 玩家家族
- 强盗派系
- 中立
- 领主/贵族家族
- 小家族
# 特点
- 只在创建新存档时读取一次，并以此生成家族和派系。
- 生成后，家族的数据将保存在存档文件中，载入游戏存档不会使用该文件内的数据。
- 部队和角色不可以没有Faction归属，容易崩，所以如果出现了没有归属的，则丢进中立。
# 格式示范
```
<Faction id="karakhuzaits"
         initial_posX="700.0"
         initial_posY="515.0"
         banner_key="34.25.10.1536.1536.764.764.1.0.0.314.22.35.444.444.764.764.0.0.270"
         label_color="FF72583B"
         color="FF72583B"
         color2="FF72583B"
         alternative_color="FF72583B"
         alternative_color2="FF72583B"
         culture="Culture.khuzait"
         default_party_template="PartyTemplate.kingdom_hero_party_karakhuzaits_template"
         settlement_banner_mesh="encounter_flag_f"
         is_minor_faction="true"
         is_outlaw="true"
         is_nomad="true"
         name="{=6BvGhzao}Karakhergit"
         tier="4"
         text="{=XJbDRBfd}The Karakhergit are one of the last nomadic clans in the western steppe. The Urkhunid khans have tried to coax them into settling down, offering them farmlands and serfs in exchange for a commitment to pay taxes and supply military levies, but they have resisted. They are treated by the other clans with a combination of envy and contempt. They trade and sometimes even intermarry with their settled brethren, but they also do a limited amount of kidnapping for ransom and raiding of flocks, and scoff at those who would blame them for carrying on with the heroic old ways.">
  <minor_faction_character_templates>
    <template id="NPCCharacter.spc_karakhuzaits_leader_0" />
    <template id="NPCCharacter.spc_karakhuzaits_leader_1" />
    <template id="NPCCharacter.spc_karakhuzaits_leader_2" />
    <template id="NPCCharacter.spc_karakhuzaits_leader_3" />
  </minor_faction_character_templates>
</Faction>
```
# 元素说明
- id
	- 该派系的ID
	- 不可空
- owner
	- 该家族的家族领袖角色id
	- 以"Hero.角色id"的格式填写
	- 领主/贵族家族不可空，其他派系可空
	- [见领主角色xml文档wiki页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/68/NPCCharacters%E9%A2%86%E4%B8%BB)
- banner_key
	- 该派系的旗帜矢量图码
	- 可通过该网址绘制：https://bannerlord.party/banner/
	- 其颜色会被强制同步成更上层的颜色。如任何领主/贵族家族，在国家中时，旗帜颜色强制使用国家的颜色。若无上层，则使用矢量码中的颜色。
	- 应该不可空
- label_color
	- 未知作用
	  该派系的标签颜色？
	- 贵族家族可空
- color
	- 衣服主色
	- 当该派系士兵的防具使用派系颜色时，按照模型的颜色通道规则生效
	- 贵族家族可空
- color2
	- 衣服副色
	- 其他见上
	- 贵族家族可空
- alternative_color
	- 未知用途
	- 通常参数与color相同
	- 贵族家族可空
- alternative_color2
	- 未知用途
	- 通常参数与color2相同
	- 贵族家族可空
- 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)
- name
	- 该家族的名称
	- 不可空
	- 加入火星人制作的强制读取英语翻译文件的功能后，才可以正常读取英语的翻译文件显示英文，否则英文语言设置下，游戏中显示名称只显示name中的字符。
	- 格式
	  ```
	  name="{=此处填写翻译的StringID}此处填写英文名称"
	  ```
- tier
	- 该家族的初始等阶
	- 可填0~6
	- 应该不可空
- super_faction
	- 该家族所属国家
	- 贵族家族才有此元素
	- 以"Kingdom.国家id"的格式填写
	- [见国家派系xml文档wiki页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/82/Kingdoms%E5%9B%BD%E5%AE%B6%E6%B4%BE%E7%B3%BB)
- settlement_banner_mesh
	- 作用未知
	- 很可能是定该家族所属部队进入定居点后，在定居点城楼处显示的旗帜模型
	- 贵族家族没有该元素；小家族、强盗派系和中立有该元素
		- 强盗家族为"none"
		- 小家族为"encounter_flag_f"
		- 中立为"encounter_flag_a"
- default_party_template
	- 该派系的默认部队模板
	- 贵族家族和中立没有该元素；小家族、强盗派系有该元素
	- 以"PartyTemplate.部队模板id"为格式填写
	- 见[部队模板文档wiki页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/80/partyTemplates%E9%83%A8%E9%98%9F%E6%A8%A1%E6%9D%BF)
- text
	- 该家族在百科全书中的介绍文本
	- 不可空
- is_bandit
	- 该派系是否是强盗派系
	- 可填参数:"true"
	- 可空，空则默认为false
- is_outlaw
	- 该派系是否是不法家族
	- 必定出现在强盗派系，可能出现在小家族
	- 可填参数:"true"
	- 可空，空则默认为false
- is_noble
	- 该家族是否是贵族家族
	- 可填参数:"true"
	- 可空，空则默认为false
- is_minor_faction
	- 该家族是否是小家族
	- 可填参数:"true"
	- 可空，空则默认为false
- is_clan_type_mercenary
	- 该家族是否是雇佣兵类别
	- 若是，则该家族在结果上必定会在各个国家之间跳槽（非常密集的跳槽判定，且无法阻止）
	- 可填参数:"true"
	- 可空，空则默认为false
- is_mafia
	- 该家族是否是秘密党派
	- 作用未知，猜测是废案
	- 只出现在小家族
- is_nomad
	- 该家族是否是游牧家族
	- 作用未知，猜测是废案
	- 只出现在小家族
- initial_posX
- initial_posY
	- 该家族的部队在世界地图上的出生坐标
	- 出现在小家族
- short_name
	- 家族简称
		- 例子
		  全称"Brotherhood of the Woods"
		  简称"Brotherhood"
- 父元素<minor_faction_character_templates>
	- 该小家族的部队指挥官角色模板
	- 见[角色其他文档wiki页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/72/NPCCharacters%E5%85%B6%E4%BB%96)
	- 格式
	  ```
	  <minor_faction_character_templates>
	    <template id="NPCCharacter.spc_hidden_hand_leader_0" />
	    <template id="NPCCharacter.spc_hidden_hand_leader_1" />
	    <template id="NPCCharacter.spc_hidden_hand_leader_2" />
	    <template id="NPCCharacter.spc_hidden_hand_leader_3" />
	  </minor_faction_character_templates>
	  ```