Skip to content

README.md

Latest commit

 

History

History
78 lines (53 loc) · 2.88 KB

README.md

File metadata and controls

78 lines (53 loc) · 2.88 KB
Raw

RimMind-Advisor 💡

Autonomous Colonist Advice, Player Approval & Feedback Loop for RimWorld 1.6

English | 简体中文

RimWorld 1.6 Dependency: RimMind-Core Unit Tests License: MIT

Transform AI thoughts into meaningful colonist advice with player approval and real-time execution feedback.

📖 Overview

RimMind-Advisor empowers colonists to formulate insightful suggestions based on their current psychological thoughts, environmental stresses, and personal goals. Instead of blindly overriding player commands, colonists present structured advice proposals with clear rationale and expected outcomes.

Core Features

  • Player Approval Flow: Advice surfaces via a non-intrusive floating HUD card displaying colonist reasoning, urgency, and proposed actions with one-click [Approve] and [Reject] buttons.
  • Smooth Mini-Pill Auto-Collapse: When an advice proposal is decided or times out, the window automatically collapses into an elegant mini status pill [Pending: 0], preventing screen clutter.
  • 3-Round Feedback Loop: Colonists track the execution outcome of approved proposals, learning whether their suggestions successfully alleviated crises or caused new setbacks.

🎮 In-Game Showcase

RimMind-Advisor Showcase In-game advice approval card: A colonist presents a tactical proposal to harvest wild medicinal herbs before winter, with interactive approve/reject options and status indicator.

🏛️ Architecture & Clean Dependencies

flowchart TD
    Pawn["Colonist Mental & Physical State"] --> Thought["Pawn Thoughts / Desires"]
    Thought --> Advisor["RimMind-Advisor Agent"]
    Advisor --> Proposal["Structured Advice Proposal"]
    Proposal --> Overlay["Advice Approval Window (UI)"]
    Overlay --> Decision{"Player Decision"}
    Decision -- Approve --> Execute["Dispatch via Core ToolCall"]
    Decision -- Reject --> Cooldown["Record Feedback & Enter Cooldown"]
    Execute --> Feedback["3-Round Execution Evaluation"]
Loading

🛠️ Installation & Load Order

1. Harmony
2. Core (Vanilla RimWorld)
3. RimMind-Core
4. RimMind-Advisor

🧪 Developer Guide & Testing

Run unit tests directly:

dotnet test RimMind-Advisor/Tests/RimMindAdvisor.Tests.csproj -c Release

📜 License

Licensed under the MIT License.