RimBridgeServer は、実行中のゲームをブリッジに変える RimWorld mod で、外部ツールを使うことができます。

実際には、テストハーネス、デベロッパツール、またはAIエージェントがRimWorldを起動し、ライブゲームの状態を調べ、ビルドインUIをドライブし、MODやMODの設定を管理し、デバッグアクションを実行し、ターゲットを絞ったスクリーンショットを取り、シミュレーションの代わりに実際のゲームに対する動作を確認することができます。

このプロジェクトは、自動改造開発とテストを目的としています。

• 実際のRimWorldセッションに対する統合テスト
• ドメインダイアログ、ターゲット、スクリーンショットによるUIとUX検証
• デバッグ操作、保存、設定、およびロードオーダーの変更のためのより速いreproループ
• GABS または直接橋接続による AI アシスト mod 開発

アーキテクチャと設計ノートは、docs/architecture.md、docs/lua-frontend-design.md、docs/semantic-state-design.md、docs/attention-policy.md で動作します。

それが何をしているか

RimBridgeServer は、RimWorld 内で実行され、ツールの面を次のように露出します。

• 読書ゲーム、地図、カメラ、選択、通知、UIの状態
• デバッグアクション、メインタブ、アーキテクト設計者、選択変更などの高レベルのゲームアクションを駆動
• mod の設定と mod のロード順の変更

RimBridgeServer

RimBridgeServer is a RimWorld mod that turns the running game into a bridge an external tool can use.

In practice, that means a test harness, developer tool, or AI agent can start RimWorld, inspect live game state, drive built-in UI, manage mods and mod settings, execute debug actions, take targeted screenshots, and verify behavior against the real game instead of a simulation.

This project is aimed at automated mod development and testing:

• integration testing against a real RimWorld session
• UI and UX verification through semantic dialogs, targets, and screenshots
• faster repro loops for debug actions, saves, settings, and load-order changes
• AI-assisted mod development through GABS or direct bridge connections

Architecture and design notes live in docs/architecture.md, docs/lua-frontend-design.md, docs/semantic-state-design.md, and docs/attention-policy.md.

What It Does

RimBridgeServer runs inside RimWorld and exposes a tool surface for:

• reading game, map, camera, selection, notification, and UI state
• driving high-level game actions such as debug actions, main tabs, Architect designators, and selection changes
• changing mod settings and mod load order
• capturing screenshots, including clipped screenshots for known UI or screen targets
• running small automation scripts through JSON or Lua front-ends
• driving Dubs Performance Analyzer profiling when DPA is installed and active

It is designed to stay as close as possible to RimWorld’s own logical seams instead of reimplementing gameplay logic outside the game.

RimWorld keeps running while its window is in the background, so agents can drive it without OS focus; the bridge restores this after RimWorld re-applies its preferences, without changing the saved preference.

Installation

Recommended: Use GABS

GABS is the best way to use RimBridgeServer from an AI or automation harness.

Why this is the recommended mode:

• GABS can start and stop RimWorld for you
• GABS can discover the live bridge tool surface after the game connects
• you do not need to manage ports or tokens manually
• this is the cleanest setup for autonomous mod testing

Basic setup:

1. Install RimBridgeServer into your RimWorld Mods folder.
2. Enable RimBridgeServer in RimWorld’s mod list.
3. Install and configure GABS.
4. Start RimWorld through GABS and connect to the running game.

Once RimWorld is up, GABS exposes the game-management tools (games.start, games.connect, games.call_tool) and then the live RimBridgeServer tool surface behind them.