RimBridgeServer - это мод RimWorld, который превращает запущенную игру в мост, который может использовать внешний инструмент.

На практике это означает, что тестовая упряжка, инструмент разработчика или агент ИИ могут запускать RimWorld, проверять состояние живой игры, управлять встроенным пользовательским интерфейсом, управлять модами и настройками модов, выполнять действия отладки, делать целевые скриншоты и проверять поведение против реальной игры вместо симуляции.

Данный проект направлен на автоматизированную разработку и тестирование модов:

Интеграционное тестирование против реальной сессии RimWorld Проверка UI и UX через семантические диалоги, цели и скриншоты

• более быстрые повторные циклы для отладки действий, сохранения, настроек и изменений загрузки Разработка модов с помощью ИИ через GABS или прямые мостовые соединения

Заметки об архитектуре и дизайне находятся в 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.