Case study

BG3SE-macOS: rebuilding the Baldur's Gate 3 Script Extender

BG3SE-macOS rebuilds the Baldur's Gate 3 Script Extender for macOS using Ghidra analysis of the Mac game binary and the Windows extender's architecture as a reference. It patches a Mach-O load command to inject a dylib, hooks game functions, and exposes Lua scripting APIs for mods; the author reports partial behavioral parity with the Windows implementation.

Targets: Binary · Game
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06

Stars: 64
Last commit: 2026-09-15
Language: C
License (GitHub): MIT

GitHub data as of 2026-11-09

Copy as Markdown View JSON Cite

Requirements & limits

Prerequisites: macOS 12 or newer, a Steam copy of Baldur's Gate 3, Xcode Command Line Tools and CMake.
Limits: Apple Silicon is recommended; Intel has limited functionality.
Limits: Ext.UI/Noesis, Lua Debugger/DAP, Virtual Textures and Input Injection are deferred.
License: MIT license.

Cite

BibTeX

@misc{bg3se-macos-baldurs-gate-3-case,
  title = {{BG3SE-macOS: rebuilding the Baldur's Gate 3 Script Extender}},
  howpublished = {\url{https://github.com/tdimino/bg3se-macos}},
  url = {https://github.com/tdimino/bg3se-macos},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/bg3se-macos-baldurs-gate-3-case/}}
}

Plain text

BG3SE-macOS: rebuilding the Baldur's Gate 3 Script Extender. https://github.com/tdimino/bg3se-macos (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/bg3se-macos-baldurs-gate-3-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · tdimino/bg3se-macos · Revision 19f9354
docs/architecture.md GitHub · tdimino/bg3se-macos · Revision 19f9354