BG3 Forge 0.2.0
BG3 Forge 0.2.0 turns the project from a game-data reader into a connected
inspection, validation, and mod-authoring toolkit for Baldur's Gate 3.
BG3 Forge is a toolkit, not an in-game mod. Do not install it through
BG3 Mod Manager. Run it from PowerShell or a terminal, or embed its Python
library in another community tool.
Highlights
Find answers in the installed game
bg3forge lookup resolves stats names, UUIDs, localization handles, and
cross-references between items, spells, passives, statuses, characters,
classes, races, and progressions. Searches are forgiving, and suggestions
are commands you can copy and run directly.
bg3forge lookup Projectile_fireball_4
bg3forge lookup "Fireball"Catch broken mods before upload
bg3forge lint MyMod.pak checks the module manifest, supported data
formats, UUIDs, localization, and internal references. Point it at an
installed game to validate references against base-game content too.
Build mods programmatically
The Mod API can create and package armor, weapons, consumables, passives,
statuses, spells, scrolls, treasure-table placement, and class spell-list
additions. Builds are deterministic, so the same source produces the same
.pak.
Use the connected BG3 data graph
The typed Python API now includes progressions, classes, races, characters,
quests, dialogs, timelines, compiled stories, treasure tables, and forward
and reverse relationships across the graph. It is designed as reusable
infrastructure for browsers, planners, bots, databases, and other modding
tools.
Download resolved game data
The release can include a patch-labeled data bundle containing SQLite,
JSON, and CSV exports plus a provenance manifest. This gives wiki editors,
theorycrafters, and tool authors usable resolved data without requiring
Python or redistributing Larian assets.
Install
Python 3.10 or newer is required.
python -m pip install "bg3forge==0.2.0"For native-speed archive handling and every optional feature:
python -m pip install "bg3forge[all]==0.2.0"Then verify the game installation:
bg3forge doctorCompatibility
- Baldur's Gate 3 Patch 8 retail data has been used for end-to-end
validation. - Python 3.10–3.13 is tested.
- Windows, Linux, and macOS are tested.
- The core package has zero required dependencies.
- BG3 Forge reads from the game installation and writes only to paths you
explicitly choose.
Because BG3 Forge is still pre-1.0, projects embedding it should pin the
0.2 API:
dependencies = ["bg3forge>=0.2,<0.3"]