Skip to content

About

Three-tier memory architecture (Active, Archive, Dark) with temporal context & persistence

Topics

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

RimMind-Memory 🧠

3-Tier Cognitive Memory Hierarchy & Temporal Context Engine for RimWorld 1.6

English | 简体中文

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

Endow colonists with long-term memory, episodic life chronicles, and natural emotional decay.


📖 Overview

RimMind-Memory implements a biologically inspired, multi-tiered cognitive memory system for RimWorld. Rather than overwhelming LLM prompts with unfiltered event dumps, memories are structured, filtered, and consolidated across distinct cognitive layers.

3-Tier Architecture

  1. Sensory & Working Buffer (L1): Captures immediate environmental sensations and short-lived interactions. Automatically decays after several hours.
  2. Episodic Daily Chronicle (L2): Records daily milestones, battle triumphs, tragic losses, and relationship shifts in concise narrative entries.
  3. Reflective & Dark Memories (L3): Enduring convictions, traumas, and life philosophy shaped by major colony events (e.g., witnessing cannibalism, surviving a betrayal, or falling in love).

🎮 In-Game Showcase

RimMind-Memory Showcase Memory inspection window: Viewing a colonist's multi-layered memory chronicle, showing decayed sensory impressions alongside pinned life milestones.


🏛️ Memory Lifecycle & Decay Flow

flowchart TD
    RawEvent["In-Game Event (Raid / Wedding / Trauma)"] --> L1["Sensory Buffer (Immediate Context)"]
    L1 --> Filter{"Importance Filter"}
    Filter -- Low Significance --> Decay["Natural Forgetting & Pruning"]
    Filter -- High Significance --> L2["Episodic Memory Consolidation"]
    L2 --> Synthesis["Sleep / Meditation Synthesis"]
    Synthesis --> L3["Deep Reflection & Permanent Personality Imprint"]
    L3 --> Prompt["Injected into Core Zone 2 Context"]
Loading

🛠️ Installation & Load Order

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

🧪 Developer Guide & Testing

Run unit tests directly:

dotnet test RimMind-Memory/Tests/RimMindMemory.Tests.csproj -c Release

📜 License

Licensed under the MIT License.

About

Three-tier memory architecture (Active, Archive, Dark) with temporal context & persistence

Topics

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages