bg3-steam-launcher

Automate launching Baldur's Gate 3 via Steam and loading saved games.

55|10|Updated Nov 27, 2025
One-click install
npx skills add https://github.com/tdimino/bg3se-macos --skill bg3-steam-launcher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bg3-steam-launcher
Source: https://github.com/tdimino/bg3se-macos/tree/main/tools/automation/skills/bg3-steam-launcher
Command: npx skills add https://github.com/tdimino/bg3se-macos --skill bg3-steam-launcher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates launching Baldur's Gate 3 through Steam, navigating the initial launcher, and loading a saved game. It streamlines testing BG3SE development by providing a repeatable, UI-driven flow.

Core Features & Use Cases

  • Steam launch automation: Launch BG3 via Steam protocol and navigate launcher UI.
  • UI automation stack: Uses macos-automator and Peekaboo MCP to interact with game menus and load saves.
  • Test & validation: Ideal for rapid iteration when validating BG3SE mod injections.

Quick Start

Ensure prerequisites are installed and accessibility permissions granted. Run the launcher to start BG3 via Steam, wait for the PLAY button, and load a preselected save slot using the provided coordinates/mappings.

Frequently Asked Questions about bg3-steam-launcher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate launching Baldur's Gate 3 through Steam?

Automate BG3 Steam launch by using macOS Automator and Peekaboo MCP to invoke Steam protocol, navigate the launcher UI via AppleScript/JXA, and trigger the PLAY button. This requires accessibility permissions and enables repeatable game launches without manual steps.

Can I automate loading saved games in Baldur's Gate 3?

Yes, automate save loading by mapping saved game slot coordinates and using UI automation to click load buttons after BG3 launches. The Skill integrates window-relative coordinate input and CGEvent-based mouse clicks to load preselected saves consistently.

What accessibility permissions does BG3 Steam automation require on macOS?

macOS Automator and Peekaboo MCP require accessibility permissions to interact with game menus and perform UI automation via AppleScript/JXA. Grant these permissions in System Preferences > Security & Privacy > Accessibility for the automation to function.

How do I test BG3SE mod injections with automated launcher flows?

Use Steam protocol automation to launch BG3, navigate UI, and load saves repeatedly without manual intervention. This streamlines validation cycles when testing Script Extender development by eliminating repetitive launcher and menu navigation steps.

Can I use macos-automator and Peekaboo MCP together for game UI automation?

Yes, macos-automator and Peekaboo MCP integrate as a UI automation stack to interact with BG3 menus and control game launch workflows. Together they handle Steam protocol invocation, window navigation, and coordinate-based mouse clicks.