bg3se-macos-ghidra

What problem does it solve?

This Skill helps developers build and debug the Baldur's Gate 3 Script Extender port for macOS by using Ghidra to discover game offsets, function addresses, and data structures. It accelerates porting Windows BG3SE features to ARM64 macOS and improves understanding of ECS, Osiris integration, and the stat/offset landscape.

Core Features & Use Cases

• Ghidra-based offset discovery: Identify critical pointers, structures, and function entry points for the macOS port.
• Documentation & architecture clarity: Centralized references and offset mappings to reduce rework during porting.
• Growth & porting support: Guidance for implementing new Lua APIs (Ext., Osi.) and porting Windows features to macOS ARM64.
• Use Case: You’re porting a Windows feature; this skill guides offset discovery and provides a workflow to validate work with headless Ghidra scripts.

Quick Start

Build and analyze with Ghidra headless analysis using the included scripts:

• Build commands follow the project’s usual workflow (cmake) and then run headless analysis scripts, e.g. via the provided ghidra/run scripts.
• Use the headless wrapper to execute a script like run_analysis.sh with a target script (for example, find_modifierlist_offsets.py) and review outputs in the log.