<h1 align="center">
<a href="https://prompts.chat">
Automatically launch Stellaris, load your save, and unpause the game - perfect for mod testing with Claude Code.
Sign in to like and favorite skills
Automatically launch Stellaris, load your save, and unpause the game - perfect for mod testing with Claude Code.
Total time: ~45-50 seconds (first run), ~30-35 seconds (if launcher already open)
requests, websocket-clientpip install requests websocket-client
Download and install AutoHotkey v2.0 from https://www.autohotkey.com/
git clone https://gitlab.com/stellarisclaude206-group/stellarisClaude-project.git cd stellarisClaude-project
cp config.template.sh config.sh nano config.sh # Edit paths for your system
chmod +x *.sh scripts/*.py
./stellaris-autostart.sh
Edit
config.sh with your paths:
# Path to your Stellaris logs (OneDrive or local) STELLARIS_LOGS="/mnt/c/Users/YOURUSERNAME/OneDrive/Documents/Paradox Interactive/Stellaris/logs" # Path to AutoHotkey v2 AHK_PATH="/mnt/c/Program Files/AutoHotkey/v2/AutoHotkey.exe" # Path to Paradox Launcher LAUNCHER_PATH="/mnt/c/Users/YOURUSERNAME/AppData/Local/Programs/Paradox Interactive/launcher/bootstrapper-v2.exe" # Optional: Path to your mod workspace (for auto-sync) MOD_WORKSPACE="" # Leave empty to skip sync
./stellaris-autostart.sh
./stellaris-autostart.sh debug
Add to your project's CLAUDE.md:
## Quick Commands - `./stellaris-autostart.sh` - Launch game and unpause
Then just tell Claude: "run the autostart script"
The Paradox Launcher is an Electron app, which means it has a built-in Chrome debugging interface. By launching with
--remote-debugging-port=9222, we can:
This is much more reliable than image recognition!
Stellaris uses SDL/DirectInput which filters synthetic keyboard input from normal Windows APIs. AutoHotkey provides hardware-level HID emulation that bypasses this filter - that's why we use it for unpause/speed commands.
debug mode for more infoMAX_LOAD_TIME in configconfig.shstellaris-autostart/ ├── README.md # This file ├── config.template.sh # Configuration template ├── stellaris-autostart.sh # Main automation script └── scripts/ ├── click_resume_cdp.py # CDP script to click RESUME └── unpause.ahk # AutoHotkey unpause script
Created for use with Claude Code for Stellaris mod development.
MIT License - Use freely, modify as needed!