About the Project
This project documents the integration of AI with RimWorld through the RimMind mod. Initially, I hoped to explore whether an AI could actually play RimWorld — making decisions and controlling the colony autonomously. After setting up RimMind with OpenRouter and Claude, I discovered it functions primarily as an AI chatbot and colony advisor.
The website honestly explains what RimMind does, what it does not do, and outlines the technical work performed to get it running on RimWorld 1.5.4062.
What RimMind Does
RimMind provides an AI interface that can query and understand aspects of the RimWorld colony through various read‑only tools. It does not autonomously control the game.
Colonist
4 tools
- list_colonists
- get_colonist_details
- get_colonist_health
- get_colonist_health
Social
2 tools
- get_relationships
- get_faction_relations
Work
3 tools
- get_work_priorities
- get_bills
- get_schedules
Colony
4 tools
- get_colony_overview
- get_resources
- get_rooms
- remove_plans
Total: 24 query tools for observing colony state.
Technical Architecture
Current system is primarily read/observe → explain. The AI observes colony state through RimMind's tools, processes with OpenRouter/Claude, and returns advice to the human player who then decides and acts in the game.
Technical Work Completed
RimWorld 1.5 Compatibility
Adapted RimMind to build against the actual standalone RimWorld 1.5.4062 assemblies.
Assembly References
Updated project references to point to the real RimWorld installation rather than unavailable relative Workshop paths.
API Compatibility Fix
Corrected allDesignations to AllDesignations to match the actual RimWorld 1.5.4062 API in PlanTools.cs.
Build Success
Build succeeded with 0 errors and 0 warnings after compatibility updates.
Harmony Integration
Integrated official Harmony library for RimWorld 1.5, recognized and loading correctly.
OpenRouter Configuration
Configured OpenRouter as the AI API layer (API key stored securely via RimMind's in-game settings).
Current Status
| Component | Status |
|---|---|
| RimWorld 1.5.4062 | Working |
| RimMind | Installed |
| Harmony | Working |
| OpenRouter | Configured |
| AI Colony Queries | Working |
| AI Advice | Working |
| Autonomous Game Control | Not Implemented |
What It Cannot Currently Do
Be very explicit: the current project does NOT claim to:
- Automatically play RimWorld
- Control the mouse or keyboard
- Independently manage the colony
- Build structures without human input
- Independently move colonists
- Independently fight battles
- Run an autonomous decision/action loop
These are future research goals, not current capabilities.
The Interesting Part: Future AI Player
From AI Advisor to AI Player - the desired future architecture:
Potential Future Actions (Research Only)
- Assign work to colonists
- Change work priorities dynamically
- Create designations for construction, mining, farming
- Order construction at workbenches
- Manage growing zones (crop selection, soil treatment)
- Manage bills (ingredient requirements, suspension)
- Draft colonists for combat, training, or specific tasks
- Move colonists to specific locations or zones
- Research project selection and management
- Emergency response protocols (firefighting, disease treatment)
- Resource allocation and trading decisions
None of these autonomous capabilities are currently implemented. They represent future research directions.
Lessons Learned
- AI integration is not the same as AI control.
- Giving an AI access to game state does not automatically give it the ability to change the game.
- Read-only tools and action tools are fundamentally different - observation ≠ intervention.
- Current RimWorld modding APIs (via HugsLib/Harmony) provide extensive observation capabilities but limited direct action capabilities for complex AI decision loops.
- Configuration management is crucial - keeping API keys secure while allowing user configuration.
- Technical compatibility requires attention to API versions and assembly references when working with specific game versions.