Skip to content

About

Composite tool call orchestration and high-level mechanism actions for RimMind suite

Topics

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

RimMind-Actions ⚡

Composite Mechanisms & Tactical Emergency Actions for RimWorld 1.6

English | 简体中文

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

Equip AI-driven colonists with battlefield triage, autonomous construction, farming, and tactical emergency mechanisms.


📖 Overview

RimMind-Actions translates high-level AI tactical and colony-building intents into robust, multi-step game actions called Composite Mechanisms. When facing sudden crises or executing long-running colony projects, colonists autonomously execute and poll composite workflows to completion.

Key Highlights

  • 10 Built-in Composite Tools:
    • Emergency & Survival: actions.stabilize_rest, actions.emergency_flee, actions.eat_and_recreation, actions.triage_patient
    • Construction & Engineering: actions.place_blueprint, actions.plan_room_project, actions.clear_area_for_build
    • Production & Agriculture: actions.designated_harvest, actions.set_work_bill, actions.schedule_farming_cycle
  • ContinuousJobPoller Multi-Stage Lifecycle: Continuously drives multi-step jobs (including seamless Blueprint_Build -> Frame resource delivery and construction transitions) until every target structure is finished or canceled.
  • ActionPermissionGuard & ResourceSafetyGuard: Enforces active spawned non-downed colonist eligibility, work-type capability checks, danger proximity interception, and colony material reserve thresholds before issuing Verse jobs.

🎮 In-Game Showcase

RimMind-Actions Showcase Battlefield emergency intervention in action: An AI-driven colonist rushes through smoke to bandage a fallen friend and carry them to safety.


🏛️ Dependency & Integration

RimMind-Actions depends solely on the public API of RimMind-Core:

flowchart LR
    Advisor["RimMind-Advisor / AI Planner"] -->|Issues Intent| Actions["RimMind-Actions"]
    Actions -->|ActionPermissionGuard & ResourceSafetyGuard| Gate{"Safe & Valid?"}
    Gate -- Yes --> Poller["ContinuousJobPoller & Verse JobDriver"]
    Gate -- No --> Fallback["Cancel with Trace Reason"]
    Actions -->|Registered via Public API| Core["RimMind-Core ToolRegistry"]
Loading

🛠️ Installation & Requirements

Ensure RimMind-Core is loaded before RimMind-Actions:

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

🧪 Developer Guide & Testing

Run unit tests directly:

dotnet test RimMind-Actions/Tests/RimMindActions.Tests.csproj -c Release

📜 License

Licensed under the MIT License.

About

Composite tool call orchestration and high-level mechanism actions for RimMind suite

Topics

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages