模组配置菜单 (MCM)

模组配置菜单 (MCM)

提供游戏内图形界面，可从主菜单和ESC菜单进入，使玩家能轻松管理模组设置、按键绑定和自定义IMGUI组件。

模组配置菜单 (MCM)预览查看大图

博德之门 3 模组配置菜单（MCM）

MCM 提供了一个游戏内菜单，模组使用者可以通过它配置模组设置和热键。

[图片：https://i.imgur.com/kbiG11u.png] 它作为模组配置的中心位置，可通过主菜单、ESC 菜单或按 Insert 键（默认）访问。

您是模组作者吗？ 请查阅集成 MCM 的文档；这是一个简单的过程，并且有许多面向作者的功能，您一定想了解！

这里展示了 MCM 1.33 与几个模组协同工作的效果，包括配置文件、键位绑定和模组页面： [图片：https://i.imgur.com/PGuMLG3.gif]

如果您想支持 MCM 和我的其他模组，请考虑在 Patreon 上支持我；每一点帮助都很重要！ 也可以礼貌地请求使用脚本扩展器的模组作者将其模组与 MCM 集成！

Patreon 加入我的Discord

[图片：https://i.imgur.com/zFbSiOA.png]

  • 轻松配置模组：MCM 提供了一种简单直观的方式来更改模组设置。无需手动编辑 JSON 文件——当然，像以往那样手动编辑仍然是被允许的！
  • 即时保存与加载设置：与传统设置处理方式不同，集成 MCM 的设置在被更改时会实时更新，无需重新加载存档或输入 SE（脚本扩展器）命令；
  • 加载顺序健康检查：MCM 还会检查您的加载顺序，查找缺失/过期的依赖项以及 UUID 无效的模组。
  • 热键管理：直接在 MCM 窗口中轻松分配键盘按键，内置冲突处理功能。
  • UI 无关性：MCM 的核心配置代码设计为独立于 IMGUI 工作。这意味着即使完全移除 IMGUI 支持，MCM 仍然可以工作。对于无法看到当前 UI 的用户，仍可使用 MCM 的后台优势来管理其设置，以及通过 JSON 文件进行编辑。
  • 存档安全：MCM 不会向您的存档文件写入任何内容——所有修改均在内存中完成，然后保存为 JSON 文件。只要同时禁用或卸载任何使用 MCM 的模组，您可以随时安全卸载 MCM，而不会影响存档文件；
  • 多配置文件：MCM 允许您管理多个配置方案，从而可以为不同的周目/角色设置不同的配置；
  • 减少用户错误：MCM 会执行多项设置验证，即使手动编辑 JSON 文件，也能降低用户配置模组时出错的风险；
  • 导入导出设置：模组设置以每个配置文件和每个模组为单位，存储于 Script Extender\BG3MCM 路径下的 JSON 文件中，便于创建备份和恢复设置。
  • 简洁界面：MCM 将所有模组设置整合到一个界面中，减少屏幕杂乱。
  • 稳健可靠：MCM 有数十项自动化测试，以确保其正常运行而不会中断；
  • 本地化支持：如果模组作者/译者提供了翻译，MCM 允许您使用偏好的语言查看设置。

[图片：https://i.imgur.com/sxXwnGA.png] 安装方式与其他 pak 模组相同，可用于新存档和现有存档：

  1. 在 Baldur's Gate 3 Mod Manager 中（或自行斟酌使用 Vortex），通过点击程序左上角的“工具”选项卡并选择“下载并解压脚本扩展器”来安装/启用脚本扩展器（SE）。或者，在 BG3MM 窗口聚焦时按 CTRL+SHIFT+ALT+T；
  2. 将此模组的 .zip 文件导入 Mod Manager，然后将模组从 Mod Manager 右侧面板拖到左侧面板；确保将其拖到加载顺序的顶部，因为它必须放在任何依赖此框架的模组之上；
  3. 保存并导出您的加载顺序。MCM 将自动被任何可能使用它的模组识别并生效。

然后您在游戏内的 ESC 菜单中应该能看到 MCM 的按钮。默认情况下，它也可以通过按 INSERT 键打开。 除非另有说明，您可以随时更新 MCM。

[图片：https://i.imgur.com/aF63bEO.png] 自发布以来，SE 中的 UI/IMGUI 支持已得到显著改善，但您仍可能遇到一些超出我控制范围的问题。 如果您看不到 MCM 窗口，可以尝试以下方法：

  1. 重新启动游戏（在到达主菜单前切勿切换窗口（alt-tab））；
  2. 暂时禁用覆盖层（如 Discord/RTSS 等）；
  3. 禁用第三方帧生成（如 NVIDIA Smooth Motion、AMD Fluid Motion、帧生成类模组等）
  4. 切换渲染 API 为 Vulkan/DX11。
  5. 验证在没有其他 DLL 模组（例如 WASD 移动模组）时问题是否依然存在；
  6. 删除 AppData\Local\Larian Studios\Baldur's Gate 3\imgui.ini 中的 imgui.ini 文件；
  7. 如果您禁用了 SE 自动更新或使用开发者频道并遇到问题，请切换回正式版。

即使您遇到 IMGUI 问题，若 MCM 窗口未出现，它在后台仍会作为配置/JSON 管理器继续工作。

[图片：https://i.imgur.com/DpLvnqC.png] MCM 1.30 及以上版本显著改善了多人游戏兼容性。但如果您仍然遇到问题，请让主机管理设置。 加入多人游戏会话的玩家无需与主机的 MCM 设置保持一致，除非相应模组作者另有说明。

请使用 Bug 选项卡报告问题。 欢迎在 论坛 或 帖子 选项卡中提出建议。

文件位置 个人用户设置可在 BG3MCM\Profiles\<PROFILE_NAME>\<MOD_NAME>\ 文件夹中找到。如果您有兴趣探索，下面是一个展示完整文件结构的 示例 剧透： [剧透] 您可以在 Windows 上按 WIN+R 并输入以下内容找到根文件夹：

explorer %LocalAppData%\Larian Studios\Baldur's Gate 3\Script Extender\BG3MCM

BG3MCM/
│   mcm_params.json (存储配置文件数据，用于加载配置文件)
│   mod_configuration_menu_config.json (在 MCM 加载自身设置之前管理一些 MCM 设置)
└───Profiles
    ├───Default
    │   ├───AutoSendFoodToCamp
    │   │       settings.json (存储当前模组 Auto Send Food To Camp 的值)
    │   ├───PreemptivelyLabelContainers
    │   │       settings.json
    │   └───WaypointInsideEmeraldGrove
    │           settings.json
    ├───Profile 1
    │   ├───AutoSendFoodToCamp
    │   │       settings.json
    │   └───WaypointInsideEmeraldGrove
    │           settings.json

[/剧透]

[图片：https://i.imgur.com/hDj8F0X.png] 与我制作 ISF 的经历类似，我要感谢 Focus 和 Nells/社区库团队 的基础工作。虽然在此语境下应用程度较低，但他们在 ISF 开发过程中的见解使这项工作变得不再艰巨。我将永远感激他们对博德之门 3 模组社区所做的开源贡献。当然，如果没有 Norbyte 对 Script Extender & LSLib 的付出以及他对反馈和问题排查的积极响应，这一切都不可能实现。与各位先生们的异步合作非常愉快 🎩👌。 还要感谢 Fallen 对模组进行 alpha 测试，感谢 Skiz 与我一起在 IMGUI 领域并肩作战，感谢 Aahz（以及 osirisofinternet）在侧边栏设计和实现、窗口分离、涉及客户端 UI 的状态管理（例如为 SE 适配 ReactiveX）以及移植原版图标以在 IMGUI 中使用方面提供的帮助，感谢 F4MCM 团队给予的灵感，感谢 MattifusP 和 Valeriede 在 GitHub 上所做的贡献，也感谢模组社区中许多其他给予支持或进行捐赠的朋友！ 源代码 源代码可在 GitHub 上获取，或通过解压 .pak 文件获得。如果您喜欢它，请在 Nexus 上点赞并在 GitHub 上给它一个星标！

我的模组 我已将大部分模组更新为与 MCM 集成。作为演示，它们的 MCM 设置也提供了巴西葡萄牙语 (PT-BR) 🇧🇷：

工具/资源

Ko-fi

BTC: bc1quankq2ep9yh3ekl2p7d39y4a2ca2shvycseeul BCH: qq8mr3rcrsju3ceftdnxjm0fezcrzgvj8vd7yyapms XMR: 8AmcntGtEsjG5KmH1frBpBQeqvy33FFvnCm8bQaV4WKH2piKtMikF8kGgNrueFqpCcCx4mo9axrEE9MFXPJ643mnFGrjnSh

加入BG3模组Discord