如何轻松管理博德之门3模组？BG3 Mod Manager 完整使用指南 🚀

BG3 Mod Manager 是一款专为《博德之门3》打造的模组管理工具，能帮助玩家轻松搞定模组安装、排序和更新。如果你是 Baldur's Gate 3 的忠实玩家，想体验丰富的模组却被手动管理搞得头大，那么这款工具绝对是你的不二之选！

📂 项目结构速览

项目采用清晰的分层结构，核心代码位于 src/ 目录下，主要分为以下模块：

• 核心功能：src/Core/ - 包含模组加载、排序和冲突检测的核心逻辑
• 图形界面：src/GUI/ - 提供直观的用户操作界面
• 工具集：src/Toolbox/ - 包含版本生成器等实用工具

BG3ModManager/
├── BG3ModManager.sln       # 解决方案文件
├── BuildRelease.py         # 发布构建脚本
├── README.md               # 项目说明文档
├── Update.xml              # 更新配置文件
└── src/                    # 源代码目录
    ├── Core/               # 核心功能模块
    ├── GUI/                # 图形用户界面
    └── Toolbox/            # 实用工具集

🔧 快速上手：安装与启动

准备工作

1. 确保已安装 .NET 8.0 和最新的 C++ 运行库
2. 从仓库克隆项目：git clone https://gitcode.com/gh_mirrors/bg/BG3ModManager

启动步骤

1. 用 Visual Studio 打开 BG3ModManager.sln 解决方案
2. 生成项目（Build）并运行，或直接双击 src/GUI/bin/Debug/BG3ModManager.exe 启动

💡 小贴士：首次运行前请确保《博德之门3》已至少启动过一次，以便创建必要的模组文件夹结构

⚙️ 核心功能详解

1. 模组管理基础

BG3 Mod Manager 提供直观的拖拽式界面，让你轻松管理模组加载顺序：

• 拖拽排序：直接拖放模组调整加载优先级
• 冲突检测：自动识别模组间的依赖关系和冲突
• 批量操作：支持同时启用/禁用多个模组

BG3 Mod Manager 模组排序界面

2. 配置游戏路径

首次使用需设置正确的游戏数据路径：

1. 打开 Settings -> Preferences
2. 在 游戏数据路径 中指定 Baldur's Gate 3 的 Data 文件夹位置
3. 设置 模组路径（通常为 Documents/Larian Studios/Baldur's Gate 3/Mods）
4. 点击 Save 保存并 Refresh 刷新数据

⚠️ 注意：不要将模组放在受保护的系统目录（如 Program Files）下

3. 高级功能

模组导出与分享

• 导出加载顺序：通过 File -> Export Order to Game 导出配置
• 打包分享：使用 Export Order to Archive 将模组打包为 zip 文件

模组作者工具

• 版本生成器：Tools -> Version Generator 帮助创建正确的版本号
• UUID 复制：右键模组可快速复制 UUID，方便脚本开发

🛠️ 实用技巧与常见问题

模组安装位置

默认模组路径：%LOCALAPPDATA%\Larian Studios\Baldur's Gate 3\Mods

常见问题解决

• 加载顺序错误：使用 Refresh 按钮重建模组缓存
• 路径配置问题：检查 Update.xml 中的更新源设置
• 启动失败：确保已安装所有依赖项，特别是 .NET 8.0 运行时

📈 功能亮点

• 双主题支持：亮/暗两种界面模式随心切换
• 智能过滤：按名称、作者等多维度筛选模组
• 版本管理：自动检查模组更新并提供安装建议
• 存档导入：从游戏存档中导入模组加载顺序

📚 资源与支持

• 官方文档：README.md
• 问题反馈：通过 GitHub Issues 提交 bug 报告
• 开发指南：查看 src/Core/Models/ 了解数据结构

🌟 无论你是普通玩家还是模组开发者，BG3 Mod Manager 都能为你的博德之门3体验提供强大支持。立即尝试，开启你的个性化冒险之旅吧！