Bannerlord软件扩展器（BLSE）

Bannerlord 软件扩展器 (BLSE) 是 Bannerlord 模组的工具，可以扩展模组功能并为游戏添加额外的功能。

安装后，无需额外步骤即可使用 BLSE 的附加功能启动 Bannerlord。
您可以使用旗帜领主启动器用于 Vanilla Launcher 或旗帜领主启动器用于扩展启动器（BUTRLoader）。
Mod 开发者可以使用领主.BLSE.Standalone.exe使用 CLI 启动游戏。

如果您之前是BUTR装载机， 跑步旗帜领主启动器获得同样的体验！

资料来源：GitHub!
致谢挑剔龙用于 BLSE 和 BUTR 标志！

如果您正在寻找以下模组：

• BLSE.加载拦截器
• BLSE.AssemblyResolver
  

安装此插件将解决您无法选择模组的问题。以下模组 ID 并非真正的模组，而是高级模组运行所需的 BLSE“功能”。我们将它们标记为模组，以便原版启动器能够阻止选择模组。BLSE 会禁用此阻止功能。

Xbox 警告！

• 在 Xbox 上，由于 JIT 优化禁用，Harmony 2.2 会降低游戏速度
• 在 Xbox 上，Harmony 2.3 测试版及更高版本将保持原生速度
  

安装（手动）

• 从文件选项卡下载 BLSE。
• 从“描述”选项卡中的“要求”部分下载并安装 Harmony。
• 将 ZIP 中顶级文件夹中的所有文件解压到您的游戏文件夹（Bannerlord.Launcher.exe 所在的位置）。
• 使用 Bannerlord.BLSE.Launcher.exe 或 Bannerlord.BLSE.LauncherEx.exe 运行游戏。
• 要确认它是否正常工作，请使用 ALT+`（波浪号）键打开控制台，然后输入 blse.version。这将显示已安装的 BLSE 版本的版本。
  

使用 Vortex 安装

• 单击此页面右上角的“Vortex”按钮。
• 安装并启用后，请确保已通过单击 Mods 工具栏上的“部署 Mods”来部署它。
• 将其标记为“引擎注入”模块
• 使用仪表盘上的快捷方式，通过 BLSE 启动游戏。（这里是如何)
  

特征

• 解除文件阻止
  
  • 启动器和LauncherEx将在启动时自动解除文件阻止。
    可以通过以下方式选择退出/名词块在命令行参数中。
  • 独立版不会在启动时自动解除文件阻止。
    可以通过以下方式选择加入/解除阻止在命令行参数中。
• 继续保存文件- 允许指定启动游戏时要加载的保存文件。
  
  • 可以通过传递/继续保存我的存档在命令行参数中。
  • (独立（仅限）也支持传递不带模块列表的存档文件。游戏将检查存档文件中的所有模块并自动加载。
    
• DPI 感知- 删除模糊的消息框和崩溃报告。
• 游戏通行证 PC- 支持 Xbox 平台上的模组制作。BLSE 禁用了 Xbox 集成，将云存档替换为类似 Steam/GOG/Epic 上的存档。
• 程序集解析器(BLSE.AssemblyResolver) - 改变游戏的程序集加载优先级。
  
  • 如果程序集在其中一个已加载的模块中可用，则将从该模块加载该程序集，即使该程序集在主模块中可用/垃圾桶文件夹。
    
• 拦截器(BLSE.LoadingInterceptor) - BLSE 检查是否是具有名为BLSEInterceptorAttribute。如果找到，它会检查是否存在以下签名：
  
  • 静态无效OnInitializeSubModulesPrefix（）- 将在游戏开始前执行，以初始化子模块。这使我们能够添加用其他编程语言声明的子模块，例如Python和Lua
  • 静态无效OnLoadSubModulesPostfix（）- 将在所有子模块初始化后立即执行
    
• 异常拦截器- BLSE 拦截未处理的异常并修补本机（C/C++）游戏代码调用的所有托管（C#）入口点，从而确保捕获所有异常
  
  • 可以通过 LauncherEx 中的设置或命令行参数选择退出/enablecrashhandlerwhendebuggerisattached在连接调试器时启用拦截器或/禁用自动生成异常禁用托管入口点修补。
    
• 看门狗禁用程序- 禁用拦截游戏异常的 TaleWorlds 工具，从而阻止 BLSE 的异常拦截器。
  
  • 可以通过 LauncherEx 中的设置或命令行参数选择退出/启用 vanillacrashhandler
    
• ReShade 支持- 如果安装了 ReShade，则需要手动加载，即使启动器和LauncherEx. 使用 DirectX 10/11/12 安装 ReShade。
• 特别K支持- 将安装的 dxgi.dll 重命名为特殊K64.dll. 安装 ReShade 后，Special K 将无法工作。使用 SKIF 启动 BLSE 或运行 Special K 服务并照常启动 BLSE。
  

启动器
启动器是原生 UI 模块，不包含 LauncherEx 功能。它支持以下可选功能，可在 LauncherEx 中配置：

• DPI 感知
• 异常拦截器
• 看门狗禁用程序
• ReShade 支持
• 特别K支持
  

LauncherEx
LauncherEx是 UI 模块。它通过以下功能扩展了原生启动器：

• 选项选项卡- 提供游戏和引擎选项，以及以下启动器选项。
  
  • 扩展排序- 启动器现在排序时会考虑社区元数据。默认启用。
  • 紧凑模块列表- 允许更紧凑地显示模块列表。默认禁用。
  • 修复常见问题- 启动器会检查主 /bin 文件夹中是否存在 0Harmony.dll。如果存在，则会提示用户是否删除它。
  • 文件解锁- 如果 .dll 文件被锁定，启动器将自动解锁。默认启用。
  • Beta 排序- 使用新的算法对模块进行排序。应用新的加载顺序时，尝试遵循现有的加载顺序。
  • 大模式- 扩展 Native Launcher 窗口的高度。
    
• 保存子标签- 显示所有可用存档、部分元数据及其加载顺序。允许继续执行特定存档，并导入/导出存档的加载顺序。
• 滚动条- e1.7.2 之前的启动器不支持不使用鼠标滚轮滚动。我们添加了滚动条来解决这个问题。
• 启用/禁用所有模组复选框- 增加了一键启用和禁用所有模块的功能。
• 度假村模块按钮- 将强制重置模块列表并强制对原始加载列表进行排序。
• 扩展依赖项提示- 添加了我们的社区元数据，以显示在 e1.7.0 中添加的提示中。
• 问题提示系统- 启动器会显示一个箭头，展开后会显示无法启用模块的原因。问题可能是依赖模块版本错误，或者与当前游戏版本二进制不兼容。
• 二进制兼容性检查- 启动器将检查模块与当前游戏版本是否存在 ABI 问题。ABI 问题意味着模块无法在游戏中运行，需要更新版本。
• 导入/导出模组列表- 提供导出和导入模块列表的方法，确保加载顺序和模块版本正确。如果模块版本不正确，则会突出显示。
• 支持 Mod Organizer 2- 完全支持 MO2 及其虚拟 FS。以下是如何将 BLSE 添加到 MO2.
  

社区依赖元数据
BLSE 增加了对新标签 DependedModuleMetadatas 的支持，使您可以更好地定义加载顺序，请参见下面的示例

<DependedModuleMetadatas>
<!-- 顺序：[ “LoadBeforeThis”， “LoadAfterThis” ] -->
<!-- 可选：[ “true”, “false” ] -->
<!-- 版本：[ “e1.0.0.0”, “e1.*”, “e1.0.*”, “e1.0.0.*” ] -->
<!-- 不兼容：[“true”，“false”] -->

<DependedModuleMetadata id="Bannerlord.Harmony" order="LoadBeforeThis" />

<DependedModuleMetadata id="Native" order="LoadAfterThis" version="e1.4.3.*" />
<DependedModuleMetadata id="SandBoxCore" order="LoadAfterThis" version="e1.5.*" />
<DependedModuleMetadata id="Sandbox" order="LoadAfterThis" />
<DependedModuleMetadata id="StoryMode" order="LoadAfterThis" version="e1.*"optional="true"/>
<DependedModuleMetadata id="CustomBattle" order="LoadAfterThis"optional="true"/>

<DependedModuleMetadata id="MyCustomMod" incompatible="true" />
</DependedModuleMetadatas>


常问问题
我遇到了安装问题！

我需要同时包含Win64_Shipping_客户端和游戏.桌面.x64_Shipping_客户端目錄？
不！
对于 Xbox Game Pass PC，您只需要游戏.桌面.x64_Shipping_客户端
对于 Steam/GOG/Epic，您只需要Win64_Shipping_客户端
我在 Xbox Game Pass PC 上看不到我的旧保存！
BLSE 使用 Steam/GOG/Epic 版本游戏使用的存储方式。我们不支持 Xbox 的存档！
PC Games 有一篇关于保存迁移的文章。
BLSE 未显示在 Vortex 的工具中！
你需要添加它手动目前！
Steam Workshop 模组不可见！
尝试启动游戏一次并退出，我们有报告说这可能会有帮助！