GABS - Game Agent Bridge Server

Let AI control your games naturally!

GABS connects AI assistants to your games through a simple, secure bridge. Configure your games once, then ask your AI to start servers, check status, or manage multiple games—all through natural conversation.

Why GABS?

For Everyone:

• Simple Setup: Configure games once with easy commands
• Natural Control: Ask AI to manage games in plain English
• Works Everywhere: Windows, macOS, Linux—one tool for all your games
• Secure: Everything runs locally by default
• Real Examples: "Start my Minecraft server", "Check if RimWorld is running", "Stop all games"

For Modders:

• AI-Powered Development: Let AI help test and debug your mods
• Universal: Works with any game that can add GABP support
• Easy Integration: Simple JSON protocol for mod developers

How It Works

GABS uses a configuration-first approach. You set up your games once, then AI controls them through simple tools.

Key Architecture Concepts

Communication Flow:

AI Agent ← MCP → GABS ← GABP → Game Mod ← Game API → Game

Important: In the GABP layer, your game mod acts as the server (listening on a port) while GABS acts as the client (connecting to your mod). This design ensures:

• GABS manages port allocation for multiple games
• All communication stays local (127.0.0.1)
• Games can start independently and GABS connects when ready

Key Features:

• Configure once: Add games with gabs games add
• Control with AI: Natural commands through MCP tools
• Any game: Works with modded games that support GABP
• Any AI: Works with Claude, ChatGPT, and custom AI tools
• Live updates: AI gets real-time notifications from your games

Quick Start

1. Download GABS

Get the latest version for your system:

• Windows: gabs-windows-amd64.exe
• macOS: gabs-darwin-arm64
• Linux: gabs-linux-amd64

2. Add Your Games

# Interactive setup (recommended)
gabs games add minecraft
gabs games add rimworld

# See what you've configured
gabs games list

GABS will ask simple questions to set up each game:

• Game Name: Friendly display name
• Launch Mode: How to start the game (Direct executable, Steam App ID, Epic, or Custom command)
• Target: Path to executable or Steam/Epic App ID
• Stop Process Name: Required for Steam/Epic games - the actual game process name for proper stopping

Critical for Steam/Epic users: GABS requires the actual game process name (like RimWorldWin64.exe for RimWorld, java for Minecraft) to properly stop games launched through Steam or Epic. Without this, GABS can start games but cannot stop them reliably.

3. Start the Server

# For AI assistants
gabs server

# For web tools (optional)
gabs server --http localhost:8080

4. Connect Your AI

Add GABS to your AI's MCP settings:

Claude Desktop:

{
  "mcpServers": {
    "gabs": {
      "command": "/path/to/gabs",
      "args": ["server"]
    }
  }
}

Codex CLI:

[mcp_servers.gabs]
command = "gabs"
args = ["server"]

Then ask your AI:

• "List my games"
• "Start the Minecraft server"
• "Stop all running games"
• "Check the status of RimWorld"

AI Tools Available

Once connected, your AI can use these tools:

Core Game Management Tools

• games.list - Show all configured games and their status
• games.start - Start a game: {"gameId": "minecraft"}
• games.stop - Stop a game gracefully: {"gameId": "minecraft"}
• games.kill - Force stop a game: {"gameId": "minecraft"}
• games.status - Check game status: {"gameId": "minecraft"}
• games.tools - List game-specific tools from connected mods

Game-Specific Tools from Mods

The real power comes from GABP-compliant mods that expose their own tools!

When your games have GABP mods installed, they add game-specific tools like:

• minecraft.inventory.get - Get player inventory in Minecraft
• minecraft.world.place_block - Place blocks in Minecraft world
• rimworld.inventory.get - Get colonist inventory in RimWorld
• rimworld.crafting.build - Build items in RimWorld

Game ID Prefixing: To avoid conflicts when multiple games are running, mod tools are automatically prefixed with the game ID (e.g., minecraft., rimworld.). This lets AI clearly specify which game to control.

Discovering Tools: Use games.tools to see what tools each running game provides:

AI: "List available tools for Minecraft"
GABS: Shows minecraft.inventory.get, minecraft.world.place_block, etc.

Pro tip: You can use game names ("minecraft") or launch IDs ("294100" for Steam) interchangeably.

Documentation

• Configuration Guide - Detailed setup for different game types and tool normalization
• AI Integration Guide - Connect GABS to different AI tools and deployment scenarios
• Mod Development Guide - Add GABP support to your game mods
• Advanced Usage Guide - Multiple instances, HTTP mode, scripting, and more
• Deployment Guide - Production deployments and cloud setups
• OpenAI Tool Normalization - Configure tool name compatibility for OpenAI API
• Dynamic Tools Guide - How AI agents handle expanding tool sets
• AI Dynamic Tools FAQ - Common questions about dynamic tool discovery

For Mod Developers

Want your game to work with GABS? Add GABP support to your mod:

1. Read GABP configuration from environment variables when your game starts:
   • GABP_SERVER_PORT - Port your mod should listen on
   • GABP_TOKEN - Authentication token for GABS connections
   • GABS_GAME_ID - Your game's identifier
2. Start a GABP server to listen for GABS connections (your mod = server, GABS = client)
3. Expose game features as tools, resources, and events

See the Mod Development Guide for complete examples in C#, Java, and Python.

Build from Source

Requirements: Go 1.22+

# Simple build
go build ./cmd/gabs

# Build with version information (recommended)
make build

# Build with custom version
go build -ldflags "-X github.com/pardeike/gabs/internal/version.Version=v1.0.0" ./cmd/gabs

Contributing & Support

• Issues & Ideas: GitHub Issues
• GABP Protocol: GABP Repository
• Example Configuration: See example-config.json for sample configurations

License

MIT License - see LICENSE for details.

---

GABS makes AI-game interaction simple. Configure once, control naturally.