兼容性框架

这是兼容性框架。从《博德之门3》社区库中分离出来的这个模组提供了一个API和基于JSON配置的简易兼容性加载器，供其他模组使用以提升兼容性。最初设计用于子职业兼容性，该框架具备API端点，支持脚本扩展器的模组可以挂钩这些端点，在运行时向种族、职业进度/专长以及法术/技能/被动列表注入数值。这意味着模组作者能够将自己的模组数据注入到现有的职业进度、专长、种族或列表中，而无需覆盖原有数据，从而实现完全兼容。若想了解当前支持的模组列表，请查阅此处。

BG3兼容性补丁和法术列表合并器是两种不同的替代方案，它们采用不同的方法来处理进度和列表的兼容性问题。

如果你喜欢我的作品，请考虑在 Ko-fi 上留下小费！我的模组和支持永远不会以支付或捐赠为前提——这只是为了鼓励我保持咖啡习惯 xD

贡献

兼容性框架使得设定与进度或列表兼容的模组变得简单，即使其他模组修改了相同内容。
您可以使用框架提供的API（附有模板），或者只需在单个文件中添加少量代码。
如需了解更多，请查阅我们的Wiki页面。

用法

我们的 GitHub Wiki 提供了关于使用兼容性框架的有用文档，包括通过其API和JSON配置加载器方法。如需快速跳转到框架特定部分的文档，请参阅以下列表：

• 种族.lsx 兼容性列表
• 兼容性进度
• 兼容性：子职业
• 进度/专长 兼容性：选择器
• 进度/专长 兼容性：增益/被动/需求
• 进度/专长 兼容性：布尔值
• 行动资源组定义 兼容性

安装

本模组适用于 Baldur's Gate 3 Mod Manager，也可能支持 Vortex 和手动安装。BG3 Mod Managers 是目前最简单的方法，因此是推荐的选择。

加载顺序

• 如果你正在更新至兼容性框架 2.3.0 或更高版本，可以安全删除 SubclassCompatibilityFramework，因为它已被重命名。
• 如果使用社区库（Community Library），则不再需要 CommunityLibraryDummies，可以安全删除。
• 如果您正在更新至兼容性框架 2.0.0 或更高版本，您可以安全地删除 SubclassCompatibilityFrameworkDummies。

BG3 Mod 管理器下载最新版本，解压 .pak 文件。
打开 BG3 Mod 管理器，点击文件 -> 导入 Mod。
选择 CompatibilityFramework.pak。
导入完成后，点击刷新。
将 CompatibilityFramework 移至加载顺序底部（BG3MM 中数字最大的位置）。
点击“保存加载顺序到文件”。

推荐模组管理工具

Laughing Leader 的模组管理器

其他推荐的模组/页面

博德之门3模组社区 Discord

致谢

• Larian Software，感谢他们开发《博德之门3》并将第五版规则带入 PC 平台。
• LaughingLeader，感谢他解释了如何进行配置加载。
• 《博德之门3》模组社区。
• Kvalyr，感谢他有效讲解了如何公开 API。
• https://github.com/ShinyHobo 感谢他们简化了创建 .pak 文件的过程。
• Alana，感谢她制作了模组管理器兼容性图片。