# 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.

- Type: Case study
- Targets: Binary · Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/tdimino/bg3se-macos>
- Primary source: <https://github.com/tdimino/bg3se-macos/blob/19f935483917274953ef0532513b6771d6f96188/README.md>
- Catalog page: <https://awesomerea.org/resources/bg3se-macos-baldurs-gate-3-case/>
- Record JSON: <https://awesomerea.org/resources/bg3se-macos-baldurs-gate-3-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/bg3se-macos-baldurs-gate-3-case/index.md)

## 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.

## Primary sources

1. <https://github.com/tdimino/bg3se-macos/blob/19f935483917274953ef0532513b6771d6f96188/README.md>
2. <https://github.com/tdimino/bg3se-macos/blob/19f935483917274953ef0532513b6771d6f96188/docs/architecture.md>

## More in Games

- [Blaster: reconstruction of an arcade sound ROM](https://awesomerea.org/resources/blaster-sound-rom-reconstruction-case/index.md) · Case study
- [Booty: a ZX Spectrum game disassembly](https://awesomerea.org/resources/booty-disassembly-case/index.md) · Case study
- [butterfly: emulating DDR A online services](https://awesomerea.org/resources/butterfly-ddr-a-service-case/index.md) · Case study
- [Call of Duty 2: Big Red One: a native loader for the Xbox game](https://awesomerea.org/resources/cod2-bro-native-loader-case/index.md) · Case study
- [Casiolator: reimplementing Casio PV-1000, PV-2000 and Loopy consoles](https://awesomerea.org/resources/casiolator-case/index.md) · Case study
- [Castlevania III: a PRG ROM disassembly with extraction tools](https://awesomerea.org/resources/castlevania-iii-disassembly-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.