Compatibility Framework
🟡 Updated this year⚠️ Install Order · 2 steps
Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.
Preview
🔍 Analysis
- 👍 0.9% endorsement rate
- 🏆 #5 of 71 Utilities mods in this game by downloads
📋 About This Mod
This is the Compatibility Framework. Split off from BG3 Community Library, this mod provides an API and easy JSON Configuration-based compatibility loader for other mods to use improve compatibility. Initially designed for Subclass Compatibility, the Framework has API endpoints that Script-Extender Enabled mods can hook into to insert values into Races, Progressions/Feats and Spell/Skill/PassiveLists at Runtime. What this means is that a mod author can inject their mod's data into existing Progressions, Feats, Races, or Lists without overwriting data, allowing for total compatibility. If you want to know which mods are currently supported, check out this list.
The BG3 Compatibility Patcher and Spell List Combiner are two alternatives, that take different approaches to handling compatibility with Progressions and Lists.
Contributing
The Compatibility Framework makes it easy to set mods that work with Progressions or Lists up for compatibility with other mods that alter the same things. You can utilize the Framework's API (Template Provided), or add a small amount of code to a single file. To find out how, check out our Wiki page.
Our Wiki on GitHub has useful documentation on using the Compatibility Framework, both via its API and its JSON Configuration loader methods. For quick links to documentation on specific parts of the Framework, see this list:
-
[]Races.lsx Compatibility
[
]Lists Compatibility[]Progressions Compatibility: Subclasses
[]Progressions/Feats Compatibility: Selectors
[]Progressions/Feats Compatibility: Boosts/Passives/Requirements
[]Progressions/Feats Compatibility: Booleans
- Action Resource Group Definitions Compatibility
Installation
This mod works with Baldur's Gate 3 Mod Manager, and possibly Vortex and Manual Installations. BG3 Mod Managers is by far the simplest method, and as such is recommended one.
Load Order
- If you're updating to Compatibility Framework 2. 3. 0 or higher, you can safely delete SubclassCompatibilityFramework, as it has been renamed.
- If using Community Library, you no longer need CommunityLibraryDummies, which can be safely deleted.
- If you're upd
Compatibility Framework is an API mod split from BG3 Community Library, providing endpoints for other mods to improve compatibility, initially for Subclass Compatibility. With 14,232 endorsements and 1.5M downloads, it's a widely adopted utility for Baldur's Gate 3 modders.
✨ Key Features
📊 Pros & Cons
✅ Pros
- Massive community trust with 14,232 endorsements and 1.5M downloads.
- Essential for modders who want to ensure their mods work together.
- Actively maintained with a recent update in April 2026.
⚠️ Cons
- Not for players—it's a backend utility, so no direct gameplay impact.
- Requires other mods to actually use the API to be useful.
- No detailed documentation provided in the description, so you'll need to dig into the mod files or community guides.
For BG3 mod developers who want to build compatibility features into their mods. Also for players who use mods that depend on this framework—you'll need it as a required dependency. Skip if you're looking for gameplay changes; this is purely a technical tool.
💡 Beginner Tips
- If you're a mod user, just install this mod and let other mods use it—no configuration needed.
- For mod developers, check the API endpoints in the mod's files to see how to integrate compatibility.
- Make sure to place this mod in your load order before any mods that depend on it.
📊 Mod Details
- Game
- Baldurs Gate 3 Mods
- Author
- BG3 Community Library Team
- Version
- 2.9.2.0
- Downloads
- 1,533,111
- Endorsements
- 14,232
- Category
- Utilities
- Created
- 9/7/2023
- Updated
- 4/14/2026
🔗 Required By 13 Mods
These mods list this mod as a dependency.
🧩 Commonly Used Together
Users add these mods to the same collections — a real compatibility signal, not an AI guess.
🔧 How to Install Baldurs Gate 3 Mods
Download from Nexus.
📖 Full step-by-step install guide for Baldurs Gate 3 →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Baldurs Gate 3 commands, item IDs, and more.
Keep browsing — more Baldurs Gate 3 mods await