ATC[支持1.4.x-1.3.x]Adonnay's Troop Changer

支持游戏本体1.4.x-1.3.7版本
MOD制作组：
作者：Adonnay
原址：https://www.nexusmods.com/mountandblade2bannerlord/mods/286


◆MOD名称
ATC - Adonnay's Troop Changer [Adonnay的兵种树更换器]



◆MOD介绍
ATC（Adonnay's Troop Changer）是一款让MOD作者能够在不替换原有兵种树的前提下，将自定义兵种树添加到游戏中的工具类MOD。它会自动合并多个兵种树，并允许深度自定义，助你打造想象中的卡拉迪亚大陆。

主要功能：

• 在不替换原有兵种树、不修改文化文件的前提下，添加额外兵种树。
• 支持每个氏族/阵营/文化拥有多个并行兵种树。只需下载安装所有兵种树MOD，ATC会自动完成合并，当然你也可以根据需要自行修改配置。
• 允许玩家决定AI是否可以招募特定兵种树（原版自带招募不受影响）。
• 可让新生成的志愿兵立即升级，使你在地图上获得更有经验的部队。
• 可选择沿用原版的贵族兵分配逻辑（所有城堡附属村庄都有贵族兵），或根据要人权势随机分配。
  

该MOD不会：

• 创建兵种树——你需要使用/修改现有的兵种树MOD（如作者制作的Chael Nad'ra），或通过独立MOD添加，也可直接添加到ad_troops.xml中。
• 修改任何游戏原始文件。它使用Harmony补丁仅修改一个招募函数（GetRecruitVolunteerFromIndividual），因此与大多数MOD兼容，除非其他MOD修改或补丁了同一函数。
  

◆配置文件说明
配置文件位于：\ProgramData\Mount & Blade II Bannerlord\ATC\ATC.settings.xml

包含以下选项：

• EnableModScan - 允许ATC扫描已激活MOD中的ATC配置文件（所有名为*ATC.modconfig.xml的文件）
• EnableCustomTemplates - 允许ATC动态修改新生成领主的部队模板
• DebugConfigRead - 调用配置时输出调试信息
• DebugRecruitSpawn - 生成新志愿兵时输出调试信息
• DebugEliteSpawn - 决定贵族兵生成时输出调试信息（1.8.6新增）
• DebugAIRecruiting - AI招募志愿兵时输出调试信息
• EliteOnlyInCastleVillages - 设为true时使用原版贵族兵分配逻辑
• EliteSpawnChance - 仅当EliteOnlyInCastleVillages为false时生效
• ElitePowerThreshold - 仅当EliteOnlyInCastleVillages为false时生效
• EliteSpawnChanceCap - 仅当EliteOnlyInCastleVillages为false时生效
• RecruitMaxUpgradeTier - 志愿兵未被招募时随时间升级的最高兵种等级（4=原版）
• LevelRecruitsUpToTier - 志愿兵生成时立即升至指定等级（1=原版/无即时升级）
• MaxLogSizeInKB - 调试日志文件大小限制
  

1.8.10新增功能：
MOD作者可以在自己的MOD中包含专用的ATC.settings.xml文件（命名规则类似*TC.settings.xml，如ATC.settings.xml或MyMod_ATC.settings.xml）。MOD自带的ATC.settings.xml可以包含以下设置（建议仅包含MOD确实需要修改的选项，为玩家保留灵活性）：

• EliteOnlyInCastleVillages
• EliteSpawnChance
• ElitePowerThreshold
• EliteSpawnChanceCap
• RecruitMaxUpgradeTier
• LevelRecruitsUpToTier
  

注意：当多个MOD都带有自己的ATC.settings.xml时，它们会互相覆盖。请查看ATC.debug.log确认最终生效的配置。

小提示：你也可以开启Mod Scan，启动游戏让ATC生成ATC.config.merged.xml，然后将该合并文件重命名为<自定义名称>_ATC.modconfig.xml作为手动配置文件使用，之后可以关闭自动扫描。


◆安装方法

• 使用Vortex安装ATC，或手动将压缩包解压到Bannerlord/Modules文件夹。安装完成后，Bannerlord/Modules文件夹内应有一个名为"AdonnaysTroopChanger"的子文件夹。
• 手动安装时，请检查/bin/Win64_Shipping_Client目录下的.dll文件是否被系统阻止（右键->属性->解除锁定）。
• 在Bannerlord启动器中激活该MOD。
• Mod Scan（模组扫描）功能默认开启，ATC会自动扫描已激活的带有配置文件的MOD。你无需额外操作，只需安装兵种MOD即可。如果你希望关闭自动扫描并手动选择配置，可在ATC.settings.xml中将对应项设为false——不建议普通玩家关闭Mod Scan功能。
  

卸载须知：
如果你的存档中已经生成了自定义兵种（即MOD启用后进入过游戏并保存），不要卸载该MOD！加载该存档时游戏会崩溃！与所有兵种MOD一样，只能在创建新游戏之前禁用该MOD。


◆MOD相关
MOD包含的文件：

• /Config/BETA160_SAMPLE.modconfig.xml - 示例配置文件（含说明）
• /bin/Win64_Shipping_Client/0Harmony.dll - Harmony外部工具库
• /bin/Win64_Shipping_Client/AdonnaysTroopChanger.dll - 主程序和补丁类
• /ModuleData/atc_partyTemplate.xml - 自定义模板功能所用的空模板文件
• SubModule.xml
  

运行时生成的文件（1.8.0及以上版本首次运行时）：

• \ProgramData\Mount & Blade II Bannerlord\ATC\ATC.settings.xml - 主配置文件
• \ProgramData\Mount & Blade II Bannerlord\ATC\ATC.debug.log - 调试日志文件
• \ProgramData\Mount & Blade II Bannerlord\ATC\ATC.merged.config.xml - 所有ATC兼容兵种MOD配置合并后的文件
  

◆已知不兼容MOD
以下MOD与ATC无法共存：

• Soldiers of Fortune - 补丁了同一方法，同时启用会产生异常结果。
• VolunteersUpTier - 补丁了同一方法，根据加载顺序，ATC或VolunteersUpTier其中一方会失效。ATC最新版本已提供类似功能，请在ATC.settings.xml中查看详情。
• Calradia Expanded Kingdoms - 补丁了同一方法，与ATC不兼容。
  

◆注意事项
前置
请务必安装前置MOD！！！
https://bbs.mountblade.com.cn/thread-2060918-1-1.html

教程
视频版：https://www.bilibili.com/video/BV1HR4y1K7MC/
详细文字版：https://bbs.mountblade.com.cn/thread-2061042-1-2.html

免责声明：
本MOD可能存在BUG，部分BUG可能导致存档损坏无法使用，请知悉。当前游戏本身在MOD环境下的稳定性有限，尤其是启用了多个不止修改XML的MOD时更是如此。如遇到问题请反馈，我会尽量排查与ATC相关的问题。但如果你安装了多个MOD，很可能会遇到兼容性问题。

使用本MOD风险自负！