SCU - MLW 行为

SCU - MLW 行为

为SpecialCustomUnits模组添加了“类似MLW”的招募雇佣机制(带有不同模式的切换开关)。

[size=5][b]SCU - MLW Behaviour[/b][/size]
[b]一个独立的附加组件,为 [url=https://www.nexusmods.com/mountandblade2bannerlord/mods/14398]Special Custom Units[/url] 添加 [url=https://www.nexusmods.com/mountandblade2bannerlord/mods/14038]My Little Warband[/url] 风格的定居点招募和统一的 MLW XML 模板导入功能,并支持通过 MCM 即时切换模式。[/b]

[line]

[size=4][b]概述[/b][/size]
[i]Special Custom Units[/i] 非常适合设计兵种树,而 [i]My Little Warband[/i] 则将自定义新兵直接整合到原版的城镇和村庄招募界面中。

[b]SCU - MLW Behaviour[/b] 在一个可切换的附加组件中桥接了这两种方式:
[list]
[]在 MCM 中随时在 [b]SCU 模式[/b] 和 [b]MLW 模式[/b] 之间干净地切换——无需额外的城镇/村庄切换菜单。[/]
[]在 [b]两种[/b] 模式下均可直接在 Special Custom Units 模板导入器中导入 [b]My Little Warband[/b] XML 兵种树模板。[/]
[]完全从零构建为独立的附加模块——它 [b]不包含[/b] Special Custom Units 或 My Little Warband 的任何 [b]代码或资源[/b]。[/]
[/list]
[line]

[size=4][b]招募模式(在 MCM 中配置)[/b][/size]
打开 [b]Mod 选项 -> SCU - MLW Behaviour -> 招募模式 -> SpecialCustomUnits Behaviour[/b] 以即时切换模式(无需重启):

[b]1. SCU 模式(默认)[/b]
[list]
[]所有标准的 [i]Special Custom Units[/i] 机制完全保持不变(全部 15 行、自定义库存数量、补充天数、费用倍率、定居点菜单开关,以及通过 [i]特殊招募[/i] 直接雇佣)。[/]
[][b]新增功能:[/b] 现在除了原生的 [i].scutemplate[/i] 文件外,您还可以导入 [b]My Little Warband XML[/b] 兵种树模板。[/]
[/list]
[b]2. MLW 模式[/b]
专为希望获得平衡、原版节奏招募的玩家设计,而不是在 MCM/编辑器中配置固定或虚高的库存数量:
[list]
[][b]原版定居点招募替换:[/b] 当您在城镇和村庄打开标准的 [i]招募部队[/i] 界面时,名流提供的可用原版志愿者槽位会动态替换为您 [b]第 1 行[/b] 自定义兵种树中的部队。[/]
[][b]公平的槽位与层级缩放:[/b] 空/锁定的名流槽位保持为空(您与名流的关系和定居点实力仍然决定您可以雇佣多少部队)。可用槽位与被替换的原版志愿者层级匹配,遵循您第 1 行树中的随机升级路径。[/]
[][b]干净的存档处理:[/b] 一旦您关闭招募界面,未招募的志愿者槽位会恢复为原始原版部队——因此切换回 [i]SCU 模式[/i] 或移除模组后,您的战役保持干净。[/]
[][b]无需额外的城镇/村庄切换:[/b] 想要恢复原版部队?只需在 MCM 中将 [i]SpecialCustomUnits Behaviour[/i] 切换回 [b]SCU 模式[/b]。[/]
[][b]禁用 SCU 经济和额外行:[/b]
[list]
[
]在 MCM 中,不兼容的 Special Custom Units 选项([i]每行新兵数[/i]、[i]每(天)补充[/i]、[i]招募费用倍率[/i]、[i]在城镇/城堡/村庄中显示[/i])会自动禁用。
[/]
[
]Special Custom Units 窗口内的直接雇佣、第 2–15 行、行重新排序以及单位编辑器中的 [i]每次补充新兵数[/i] 控件均被禁用。
[/]
[
]定居点菜单项变更为 [b]特殊招募(第 1 行编辑器)[/b],以便您始终可以打开第 1 行来创建、编辑、装备、导出或导入您的兵种树。
[/]
[/list][/
]
[][b]包含 XML 导入:[/b] 导入 MLW XML 兵种模板在 [i]MLW 模式[/i] 下同样有效(导入到第 1 行)。[/]
[/list]
[b][color=#f1c40f]关于第 1 行的重要说明(基础 vs. 贵族新兵):[/color][/b]
在 [b]MLW 模式[/b] 下,[b]仅第 1 行[/b] 被用作自定义兵种树。与独立的 [i]My Little Warband[/i] 不同,目前 [b]没有基础与贵族/精英新兵线路的区分[/b]——所有可用的城镇和村庄志愿者槽位都使用您的第 1 行树进行替换。未来更新可能会添加对独立基础/贵族线路的支持。

[line]

[size=4][b]统一 XML 模板导入(MLW -> SCU)[/b][/size]
[list]
[][b]XML 文件放置位置:[/b] 将您的 My Little Warband [i].xml[/i] 兵种文件放入标准的 Special Custom Units 模板文件夹:

[code]Documents\Mount and Blade II Bannerlord\Configs\SpecialCustomUnits\Templates\[/code][/
]
[][b]游戏内选择:[/b] [i].scutemplate[/i] 和 [i].xml[/i] 文件会一起出现在导入下拉列表中(XML 文件标记为 [i][XML][/i])。如果一个 XML 文件同时包含基础树和精英树(或多个根部队),每个树会作为单独的可选条目出现(例如 [i][XML: Basic][/i]、[i][XML: Elite][/i])。您也可以从 UI 中删除 XML 模板文件(存档中已导入的行不受影响)。[/]
[][b]XML 导入时的 SCU 树限制:[/b] Special Custom Units 每个部队最多支持 [b]2 个升级分支[/b],从基础单位起深度最多 [b]5 级[/b](总计最多 63 个部队)。如果导入的 XML 树更宽或更深,多余的分支/层级会被安全跳过,并会通知报告省略了多少节点。[/]
[][b]其他模组中缺失的物品:[/b] 如果 XML 模板引用了当前未加载的模组中的护甲、武器或马匹,这些装备槽位将留空,游戏内消息会列出缺失的物品 ID。[/]
[/list]
[line]

[size=4][b]需求与兼容性[/b][/size]
[b]必需模组(在本模组之前加载):[/b]
[list]
[]Bannerlord.Harmony[/]
[]Bannerlord.ButterLib[/]
[]Bannerlord.UIExtenderEx[/]
[]Mod Configuration Menu (MCMv5)[/]
[][url=https://www.nexusmods.com/mountandblade2bannerlord/mods/14398]Special Custom Units[/url](使用 v0.7.3 测试)[/]
[/list]
[b]冲突与说明:[/b]
[list]
[][b]请勿与 My Little Warband / My Little Warband - Gwyn's Edition 一起使用:[/b] 同时激活原版 MLW 或 Gwyn's Edition 会导致志愿者重复替换。如果检测到冲突的 MLW 模块,模组将在启动时显示警告。[/]
[][b]存档中途安全:[/b] 可以在战役中途在 [i]SCU 模式[/i] 和 [i]MLW 模式[/i] 之间切换。由于未招募的志愿者槽位在关闭招募界面时会恢复,原版定居点名册保持完整。[/]
[][b]故障排除:[/b] MCM([i]SCU - MLW Behaviour[/i])中提供了一个可选的 [b]诊断日志[/b] 开关,如果您需要调试招募行为,可以输出逐步替换日志。[/]
[/list]
[line]

[size=4][b]安装[/b][/size]
[list=1]
[]安装上面列出的所有必需依赖项,包括 [b]Special Custom Units[/b]。[/]
[]将 [b]SCU-MLW[/b] 文件夹解压到您的 Bannerlord [i]Modules[/i] 目录中(路径应为 [i]Modules\SCU-MLW\SubModule.xml[/i])。[/]
[]在 Bannerlord 启动器中,启用 [b]SCU - MLW Behaviour[/b] 并将其放在加载顺序中 [b]Special Custom Units 下方[/b]。[/]
[]在游戏中,打开 [b]Mod 选项 -> SCU - MLW Behaviour[/b],选择 [b]MLW 模式[/b](或保留 [b]SCU 模式[/b]),并通过 [i]特殊招募[/i] 在 [b]第 1 行[/b] 中创建或导入自定义兵种树。[/]
[/list]
[line]

[size=4][b]致谢、依赖与归属[/b][/size]
本模组是一个从零编写的 [b]独立附加组件/补丁[/b]。它 [b]不包含或重新分发[/b] 任何其他模组的代码、DLL、UI 文件或资源。所有必需的模组和框架必须从其原始作者处单独下载:
[list]
[][b][url=https://www.nexusmods.com/mountandblade2bannerlord/mods/14398]Special Custom Units[/url][/b] 由 [b]Kaison[/b] 制作——必需的基础模组,本附加组件集成了其第 1 行自定义兵种树、编辑器和模板系统。[/]
[][b][url=https://www.nexusmods.com/mountandblade2bannerlord/mods/14038]My Little Warband - Gwyn's Edition[/url][/b] 由 [b]Gwynbleidd25418[/b] 制作,以及 [b]LL Muse[/b] 制作的原始 [b]My Little Warband[/b]——城镇/村庄志愿者替换机制的灵感来源,以及标准 XML 兵种导出格式的兼容性参考。[/]
[][b]Harmony[/b] 由 [b]Andreas Pardeike (pardeike)[/b] 制作(MIT 许可证)& [b]BUTR 团队[/b]([b]ButterLib[/b]、[b]UIExtenderEx[/b]、[b]MCM / Mod Configuration Menu[/b]——MIT 许可证)。[/]
[][b]TaleWorlds Entertainment[/b] 制作 [i]Mount & Blade II: Bannerlord[/i]。[/]
[/list]有关完整的第三方归属和许可证声明,请参阅模组存档内的 [i]THIRD-PARTY-NOTICES.md[/i]。

[line]

[b][size=4]Русское описание:[/size][/b]

[size=5][b]SCU - MLW Behaviour (SCU + MLW)[/b][/size]
[b]Независимое дополнение для [url=https://www.nexusmods.com/mountandblade2bannerlord/mods/14398]Special Custom Units[/url], добавляющее механику найма добровольцев в стиле [url=https://www.nexusmods.com/mountandblade2bannerlord/mods/14038]My Little Warband[/url] и единый импорт XML-шаблонов MLW — с быстрым переключением режимов через MCM.[/b]

[line]

[size=4][b]Описание[/b][/size]
Мод [i]Special Custom Units[/i] отлично подходит для создания деревьев войск, а [i]My Little Warband[/i] позволяет органично встроить кастомных рекрутов в обычный найм в городах и деревнях.

[b]SCU - MLW Behaviour[/b] объединяет оба подхода в одном переключаемом дополнении:
[list]
[]Режим работы свободно переключается между [b]SCU Mode[/b] и [b]MLW Mode[/b] в меню настроек MCM — без лишних переключателей в меню городов и деревень.[/]
[]Поддерживает прямой импорт XML-шаблонов войск из [b]My Little Warband[/b] в общем списке импорта Special Custom Units в [b]обоих[/b] режимах.[/]
[]Написан с нуля как отдельный модуль-аддон и [b]не содержит кода или ассетов[/b] из Special Custom Units или My Little Warband.[/]
[/list]
[line]

[size=4][b]Режимы работы (настраиваются в MCM)[/b][/size]
Переключение выполняется в меню игры: [b]Настройки модов (MCM) -> SCU - MLW Behaviour -> Режим найма -> SpecialCustomUnits Behaviour[/b] (перезапуск игры не требуется):

[b]1. SCU Mode (по умолчанию)[/b]
[list]
[]Весь стандартный функционал мода [i]Special Custom Units[/i] остаётся без изменений (все 15 строк, настройка количества и частоты пополнения рекрутов, множитель цены, отображение в поселениях и прямой найм через меню [i]Особый наём[/i]).[/]
[][b]Новое:[/b] добавлена возможность импортировать шаблоны деревьев войск в формате XML из [b]My Little Warband[/b] наравне со стандартными файлами [i].scutemplate[/i].[/]
[/list]
[b]2. MLW Mode[/b]
Режим создан для максимально «честного» и сбалансированного найма кастомных войск — без ручного указания завышенного количества рекрутов в MCM или редакторе:
[list]
[][b]Подмена добровольцев в городах и деревнях:[/b] при открытии обычного окна найма добровольцев в поселении доступные слоты нативных юнитов у знати автоматически заменяются на кастомных юнитов из [b]Row 1 (первой строки)[/b] мода Special Custom Units.[/]
[][b]Честное количество и уровни:[/b] закрытые/пустые слоты знати остаются пустыми (на доступность найма по-прежнему влияют отношения со знатью и развитие поселения). Уровень подставляемого кастомного бойца подбирается под тир исходного добровольца по случайной ветке улучшений вашего дерева в Row 1.[/]
[][b]Безопасность сохранений:[/b] после закрытия окна найма все некупленные слоты возвращаются к исходным нативным войскам — вы можете в любой момент вернуться в [i]SCU Mode[/i] без последствий для сохранения.[/]
[][b]Без лишних кнопок в поселениях:[/b] дополнительного переключателя в городах/деревнях, как в MLW, нет — чтобы вернуть нативные войска, достаточно переключить режим обратно на [b]SCU Mode[/b] в MCM.[/]
[][b]Отключение лишних механик SCU:[/b]

[list]
[
]В MCM несовместимые настройки Special Custom Units ([i]Recruits per row[/i], [i]Refill every (days)[/i], [i]Recruitment cost multiplier[/i], [i]Show in towns/castles/villages[/i]) автоматически блокируются.
[/]
[
]В окне Special Custom Units отключается прямой наём рекрутов, блокируются строки 2–15, перемещение строк и изменение числа рекрутов за пополнение в редакторе юнита.
[/]
[
]Пункт меню в поселениях переименовывается в [b]Особый наём (редактор Row 1)[/b], чтобы вы могли в любой момент открыть Row 1 и настроить, создать или импортировать дерево войск.
[/]
[/list][/
]
[][b]Импорт XML также работает:[/b] загрузка шаблонов деревьев войск из My Little Warband доступна и в этом режиме (импорт выполняется в Row 1).[/]
[/list]
[b][color=#f1c40f]Важное примечание по Row 1 (обычные и благородные рекруты):[/color][/b]
В режиме [b]MLW Mode[/b] работает только [b]ОДИН РЯД — Row 1 (первая строка)[/b]. В отличие от оригинального [i]My Little Warband[/i], разделения на обычных и благородных (элитных) рекрутов здесь нет: все доступные слоты добровольцев в городах и деревнях заменяются юнитами из этого одного шаблона. В будущих обновлениях мода это может измениться.

[line]

[size=4][b]Импорт XML-шаблонов из My Little Warband[/b][/size]
[list]
[][b]Куда помещать файлы:[/b] скопируйте ваши [i].xml[/i]-шаблоны войск из MLW в стандартную папку шаблонов Special Custom Units:

[code]Documents\Mount and Blade II Bannerlord\Configs\SpecialCustomUnits\Templates\[/code][/
]
[][b]Выбор в интерфейсе:[/b] файлы [i].xml[/i] отображаются в общем выпадающем списке импорта рядом с [i].scutemplate[/i] (с пометкой [i][XML][/i]). Если внутри одного XML-файла описаны сразу несколько корневых веток (например, обычная и элитная), каждая ветка отобразится отдельным пунктом ([i][XML: Basic][/i], [i][XML: Elite][/i]), и вы сможете выбрать нужную. Удаление XML-файла через кнопку удаления в окне также поддерживается (уже загруженные в строки деревья в сохранении не затрагиваются).[/]
[][b]Ограничения дерева при импорте XML:[/b] в Special Custom Units каждое дерево поддерживает максимум [b]2 ветки улучшений[/b] от каждого бойца и глубину до [b]5 шагов[/b] от базового юнита (до 63 бойцов). Если импортируемый XML-шаблон шире или глубже, лишние ответвления аккуратно отбрасываются с выводом уведомления о количестве пропущенных узлов.[/]
[][b]Отсутствующие предметы в XML:[/b] если в XML-шаблоне указана экипировка из других модов, не подключённых в текущей сборке игры, такие слоты оставляются пустыми, а игрок видит уведомление со списком отсутствующих идентификаторов предметов.[/]
[/list]
[line]

[size=4][b]Требования и совместимость[/b][/size]
[b]Обязательные моды (должны загружаться раньше):[/b]
[list]
[]Bannerlord.Harmony[/]
[]Bannerlord.ButterLib[/]
[]Bannerlord.UIExtenderEx[/]
[]Mod Configuration Menu (MCMv5)[/]
[][url=https://www.nexusmods.com/mountandblade2bannerlord/mods/14398]Special Custom Units[/url] (протестировано с v0.7.3)[/]
[/list]
[b]Совместимость и ограничения:[/b]
[list]
[][b]Не запускайте одновременно с My Little Warband / My Little Warband - Gwyn's Edition:[/b] оригинальный мод My Little Warband и его форк Gwyn's Edition не должны быть активны одновременно с этим аддоном, чтобы не возникало двойной подмены добровольцев. При одновременной загрузке мод выведет предупреждение.[/]
[][b]Безопасно для текущих сохранений:[/b] режимы можно переключать прямо посреди кампании.[/]
[][b]Диагностика:[/b] при необходимости в настройках MCM ([i]SCU - MLW Behaviour[/i]) можно включить переключатель [b]Диагностика подмены рекрутов[/b] для вывода подробных шагов работы подмены в чат и лог.[/]
[/list]
[line]

[size=4][b]Установка[/b][/size]
[list=1]
[]Установите все обязательные зависимости, включая [b]Special Custom Units[/b].[/]
[]Распакуйте папку [b]SCU-MLW[/b] в каталог [i]Modules[/i] игры (путь должен выглядеть как [i]Modules\SCU-MLW\SubModule.xml[/i]).[/]
[]В лаунчере игры включите [b]SCU - MLW Behaviour[/b] и расположите его [b]ниже Special Custom Units[/b] в порядке загрузки.[/]
[]В игре откройте [b]Настройки модов -> SCU - MLW Behaviour[/b], выберите [b]MLW Mode[/b] (или оставьте [b]SCU Mode[/b]) и создайте или импортируйте дерево войск в [b]Row 1[/b] через меню [i]Особого найма[/i].[/]
[/list]
[line]

[size=4][b]Благодарности и использованные проекты[/b][/size]
Данный мод является [b]независимым дополнением[/b], написанным с нуля. Он [b]не содержит и не распространяет[/b] исходный код, DLL-библиотеки, файлы интерфейса или ассеты других модов — все требуемые моды и библиотеки устанавливаются пользователем отдельно со страниц их авторов:
[list]
[][b][url=https://www.nexusmods.com/mountandblade2bannerlord/mods/14398]Special Custom Units[/url][/b] от [b]Kaison[/b] — обязательный базовый мод, с редактором, шаблонами и первой строкой юнитов которого работает данное дополнение.[/]
[][b][url=https://www.nexusmods.com/mountandblade2bannerlord/mods/14038]My Little Warband - Gwyn's Edition[/url][/b] от [b]Gwynbleidd25418[/b], а также оригинальный [b]My Little Warband[/b] от [b]LL Muse[/b] — идея механики подмены добровольцев в городах и деревнях и совместимость со стандартным форматом XML-шаблонов войск.[/]
[][b]Harmony[/b] от [b]Andreas Pardeike (pardeike)[/b] (лицензия MIT) и команда [b]BUTR[/b] ([b]ButterLib[/b], [b]UIExtenderEx[/b], [b]MCM / Mod Configuration Menu[/b] — лицензия MIT).[/]
[][b]TaleWorlds Entertainment[/b] за игру [i]Mount & Blade II: Bannerlord[/i].[/]
[/list]Полная информация об авторах и лицензиях приведена в файле [i]THIRD-PARTY-NOTICES.md[/i] в папке мода.