RimBridgeServer 是一个 RimWorld 模组，将跑步游戏变成外部工具可以使用的桥接。

实际上，这意味着测试工具、开发者工具或AI代理可以启动RimWorld，检查实时游戏状态，驱动内置UI，管理模组和模组设置，执行调试操作，截图目标，并验证行为是否与真实游戏相符，而非模拟。

该项目旨在实现模组的自动化开发和测试：

• 基于真实RimWorld会话进行集成测试
• 通过语义对话、目标和截图进行UI和用户体验验证
• 更快的复刻循环，用于调试操作、保存、设置和加载顺序更改
• 通过GABS或直接桥接连接的AI辅助模组开发

架构和设计笔记分别存放在docs/architecture.md、docs/lua-frontend-design.md、docs/semantic-state-design.md和docs/attention-policy.md中。

它的作用

RimBridgeServer 运行于 RimWorld 内部，并暴露以下工具表面：

• 读取游戏、地图、摄像头、选择、通知和界面状态
• 驱动高级游戏动作，如调试操作、主标签页、架构师标识符和选择变更
• 更改模组设置和模组加载顺序

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.