Alpha testers wanted: BattleTech mod that lets an AI (Claude, ChatGPT, Local LLMs) play the game, fight you as the OpFor, and more - Windows and macOS
I've been building BTBridge, a mod that lets an AI agent play HBS BattleTech through the game's own logic rather than clicking the screen.
It can:
- Read your company, mechbay, storage, and the mechlab while you build, including unsaved edits.
- Refit and repair mechs using the game's own validation and work-order systems.
- Run the campaign loop: contracts, negotiation, missions, salvage, travel, events, pilots, stores, finances, and Argo upgrades.
- Command a lance in combat on your side.
- Command the enemy OpFor against you.
- Read mission dialogue, radio chatter, objectives, and campaign story conversations.
- Chat with you through a small in-game overlay, with an input box so you can talk back during play.
This is not screen-reading or mouse automation. BTBridge hooks into BattleTech's actual game logic and exposes structured game state and actions to an AI agent.
It works on my Windows machine. Now I need other people's setups, especially macOS players, because I do not own a Mac and the Mac build has never been run on real Mac hardware.
Downloads - v0.1 alpha:
Windows:
https://github.com/PStryder/BTBridge/releases/download/v0.1-alpha/BTBridge-v0.1-alpha-windows.zip
macOS:
https://github.com/PStryder/BTBridge/releases/download/v0.1-alpha/BTBridge-v0.1-alpha-macos.zip
Release page, notes, and checksums:
https://github.com/PStryder/BTBridge/releases/tag/v0.1-alpha
Project:
https://github.com/PStryder/BTBridge
REQUIREMENTS
- BattleTech 1.9.1 on Steam
- Vanilla game
- ModTek v4.5.1
ModTek:
https://github.com/BattletechModders/ModTek/releases
BTBridge will not currently work alongside RogueTech, BTA, or other major overhaul packs, so use a clean install.
Back up your saves first, as with any alpha mod.
WINDOWS INSTALL
From the ModTek zip, copy winhttp.dll, doorstop_config.ini, and the Mods folder into your BattleTech folder.
On Steam this is usually:
C:\Program Files (x86)\Steam\steamapps\common\BATTLETECH
From the BTBridge Windows zip, copy the BTBridge folder into:
BATTLETECH\Mods\
Launch BattleTech to the main menu.
The version text should end in:
/W MODTEK
Check:
Mods\BTBridge\BTBridge.log
It should contain:
BTBridge 0.1.0 initialized
MACOS INSTALL - EXPERIMENTAL / UNVERIFIED
I do not own a Mac. The macOS paths and packaging have been implemented and tested synthetically, but this has NOT yet been run on real Mac hardware. I especially need Mac testers.
Install ModTek using its macOS instructions. ModTek launches the game through its script, configured as the Steam launch option.
The Steam game folder is usually:
~/Library/Application Support/Steam/steamapps/common/BATTLETECH
From the BTBridge macOS zip, copy the BTBridge folder into ModTek's Mods folder, normally:
BATTLETECH/Mods
next to BattleTech.app.
If macOS quarantines the mod, run:
xattr -dr com.apple.quarantine BATTLETECH/Mods/BTBridge
Launch BattleTech to the main menu.
Check for:
Mods/BTBridge/BTBridge.log
If any of those paths are wrong on your Mac, please tell me. Confirming the real-world macOS layout is one of the reasons for this alpha.
Each zip also contains a fuller INSTALL guide.
WHAT TO SEND BACK
Whether it works or not, please send a comment, DM, or GitHub issue with:
- Windows or macOS
- For Macs: Intel or Apple Silicon, plus macOS version
- Mods/BTBridge/BTBridge.log
- Mods/.modtek/ModTek.log
- Mods/.modtek/battletech_log.txt
If BTBridge.log does not exist at all, that is useful information too. It means the mod never loaded.
CONNECTING AN AI
The release zips contain the BattleTech mod itself.
Connecting Claude, ChatGPT, a local model, or another MCP-capable agent uses the MCP server included in the GitHub repo. Setup is described in the README.
For this first alpha, my main goal is simply getting BTBridge to load cleanly on more machines and finding the assumptions that only worked on mine.
It is alpha software. Things may break.
When they do, the logs are exactly what I need.
Thanks!