RimBridgeServer는 외부 도구가 사용할 수있는 Bridge로 실행되는 RimWorld mod입니다.

실제로 테스트 하네스, 개발자 도구 또는 AI 에이전트가 RimWorld를 시작할 수 있음을 의미합니다. 라이브 게임 상태를 검사하고 내장 된 UI를 구동하며 mods 및 mod 설정을 관리하며 디버그 작업을 수행하며 대상 스크린 샷을 수행하고 시뮬레이션 대신 실제 게임에 대한 동작을 확인합니다.

이 프로젝트는 자동화된 mod 개발과 테스트를 목표로 합니다:

• 실제 RimWorld 세션에 대한 통합 테스트
• semantic 대화 상자, 대상 및 스크린 샷을 통한 UI 및 UX 검증
• 디버그 작업, 저장, 설정 및 로드 주문 변경을위한 빠른 리프로 루프
• GABS 또는 직접 브리지 연결을 통한 AI 보조 모드 개발

아키텍처 및 디자인 노트는 docs/architecture.md, docs/lua-frontend-design.md, docs/semantic-state-design.md 및 docs/attention-policy.md에서 라이브.

그것은 무엇을

RimBridgeServer는 RimWorld 내부를 실행하고 도구 표면을 노출시킵니다.

• 읽기 게임,지도, 카메라, 선택, 알림, UI 상태
• 디버그 작업, 메인 탭, Architect Designators 및 선택 변경과 같은 고급 게임 작업을 구동
• mod 설정 및 mod load order 변경

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.