Baldur's Gate 3 Community Library
baldurs-gate-3 — Mods & Enhancements
Baldur's Gate 3 Community Library (BG3CL) is the foundational dependency for hundreds of mods, providing shared Lua scripts, status effects, spell definitions, and passive abilities that modders reference to avoid duplicating code. It patches the game's SpellData, StatusData, and PassiveData tables at runtime, allowing mods like '5e Spells' and 'Expanded Feats' to add new mechanics without conflicting with each other. Players install it because nearly every gameplay overhaul, from 'Mystra's Spells' to 'Level 20', requires it as a hard dependency, and without it, those mods will either fail to load or cause silent CTDs on character creation.
📦 Full mod page on discovermods
Downloads, ratings, compatibility info, installation guides, and user reviews.
View on discovermods →Syntax
ResourcesExample
Downloads: 1,450,992 | Endorsements: 14,318💡 Notes
By BG3 Community Library Team | v2.3.0.2 | 14,318 endorsements
🎯 Tips & Tricks
In Vortex, deploy BG3CL AFTER 'Baldur's Gate 3 Script Extender' (BG3SE) but BEFORE any mod that adds spells or feats. Right-click BG3CL, select 'Deploy After' and choose BG3SE. Then, ensure any spell mod (e.g., 'Tasha's Cauldron') is set to deploy after BG3CL. This prevents the library's shared tables from being overwritten, which would break spell tooltips.
After installing, open the BG3 Mod Manager (BG3MM), click 'Load Order', and confirm BG3CL is placed at the TOP of the 'Active Mods' list, above all other .pak files. If it's below a spell mod, drag it up. In-game, type '/bg3cl' in the chat console (with BG3SE active) to see the library version; if it returns 'not found', reinstall the .pak file.
For Patch 7 hotfixes (e.g., Hotfix 29), BG3CL must be updated to at least v1.25.3. Check the mod's GitHub page (github.com/BG3-Community-Library) for the 'Hotfix' branch. If you're using the 'Full Release' version from Nexus, manually download the 'Hotfix' .pak and replace the old one in your Mods folder, then refresh in BG3MM.
🔧 Troubleshooting
CTD when loading a save with 'Expanded Feats' and 'BG3CL' installed, but only after Patch 7.
This is a known conflict with 'ImprovedUI Assets' (v1.0.0) which overwrites BG3CL's UIData. Download 'ImprovedUI Assets' v1.0.1 from Nexus (file ID 366) and ensure it's deployed AFTER BG3CL in Vortex. If using BG3MM, move 'ImprovedUI Assets' below BG3CL in the load order. Alternatively, delete the 'Public/UI' folder from BG3CL's .pak (using 7zip) to let ImprovedUI handle UI.
Spell descriptions show 'ERROR: Missing Description' for mod-added spells.
This happens when BG3CL is loaded but 'Mod Fixer' (by Sertith) is missing or outdated. Install 'Mod Fixer' v1.0.3 from Nexus (file ID 141) and place it ABOVE BG3CL in load order. If the issue persists, edit the 'Mods.lsx' file in your BG3 profile to add 'ModFixer' as a dependency for BG3CL (set 'Dependency' to 'true').
⚠️ Common Mistakes
- [object Object]
- [object Object]
👍 Pros
- 14,318 endorsements
- 1,450,992 downloads
- Category: Resources
👎 Cons
- Requires mod manager installation
- May conflict with similar mods