Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -171,6 +171,9 @@ jobs:
--exclude='docs/' \
--exclude='*.csproj' \
--exclude='*.sln' \
--exclude='.coderabbit.yaml' \
--exclude='.pre-commit-config.yaml' \
--exclude='INTRODUCTION.txt' \
--exclude='.gitignore' \
--exclude='.gitattributes' \
--exclude='*.md' \
Expand Down
66 changes: 65 additions & 1 deletion About/About.xml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,71 @@
<li>1.6</li>
<li>1.7</li>
</supportedVersions>
<description>AI-driven personality system for colonists. Each day, an LLM evaluates colonist state and injects personality Thoughts that influence mood and behavior. [v2.0 BREAKING CHANGES]</description>
<description>[h1]RimMind - Personality (v2.0)[/h1]
Big-Five psychological profiling and probabilistic state-transition reflection system for RimWorld colonists. Endows every colonist with a persistent inner world, generating dynamic personality Thoughts and introspective soliloquies that influence mood, behavior, and advisor decisions.

[b]v2.0 Clean Architecture &amp; RimWorld 1.6 / 1.7 Dual-Version Support:[/b]
[list]
[*][b]RimWorld 1.6 &amp; 1.7 (Waylith / .NET 10) Ready[/b]: Native multi-target compilation supporting both RimWorld 1.6 (.NET Framework 4.8) and RimWorld 1.7 (.NET 10 / Harmony 2.x &amp; 3.x).
[*][b]v2.0 Big-Five Psychometric &amp; Probabilistic State Engine[/b]: Replaces rigid timers with organic environmental triggers (06:00 Dawn Sunrise, Skygazing, Shared Recreation, Traumatic Mood Swings). Note: v1.x saves are not compatible with v2.0.
[*][b]Loose-Coupled Thought Event Bus[/b]: Broadcasts psychological shifts to [code]RimMind-Advisor[/code] and [code]RimMind-Core[/code] Zone 2 context without direct cross-mod coupling.
[/list]

[h2]What Is RimMind[/h2]
RimMind is an enterprise-grade, AI-powered RimWorld mod suite. Integrated with Large Language Models (LLM), it transforms colonists into self-reflecting agents with distinct personalities, three-tier memories, natural spoken dialogues, autonomous mechanisms, and dynamic storytelling.

[h2]Sub-mod List &amp; Dependency Relationships[/h2]
[table]
[tr][th]Mod[/th][th]Responsibility[/th][th]Dependencies[/th][th]GitHub[/th][/tr]
[tr][td]RimMind-Core[/td][td]LLM runtime, 4-Zone context engine, async queue, ToolCall registry &amp; F8 Hub[/td][td]Harmony[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Core]Link[/url][/td][/tr]
[tr][td]RimMind-Actions[/td][td]Composite ToolCall mechanisms, battlefield triage &amp; autonomous construction[/td][td]Core[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Actions]Link[/url][/td][/tr]
[tr][td]RimMind-Advisor[/td][td]Colonist self-reflective advice cards, 5-domain autonomy &amp; player approval[/td][td]Core, Actions[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Advisor]Link[/url][/td][/tr]
[tr][td]RimMind-Dialogue[/td][td]Contextual spoken dialogue via express_dialogue ToolCall &amp; speech bubbles[/td][td]Core[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Dialogue]Link[/url][/td][/tr]
[tr][td]RimMind-Memory[/td][td]3-Tier cognitive memory hierarchy, work aggregation &amp; temporal decay[/td][td]Core[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Memory]Link[/url][/td][/tr]
[tr][td][b]RimMind-Personality[/b][/td][td]Big-Five psychological profiles, dawn monologues &amp; dynamic mood thoughts[/td][td]Core[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Personality]Link[/url][/td][/tr]
[tr][td]RimMind-Storyteller[/td][td]AI Story Director, dramatic tension curve, chained arcs &amp; Storyteller Altar[/td][td]Core, Memory[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Storyteller]Link[/url][/td][/tr]
[tr][td]RimMind-Extension-ModelService[/td][td]Multi-provider routing, Anthropic KV cache, local gateways &amp; load balancing[/td][td]Core[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Extension-ModelService]Link[/url][/td][/tr]
[tr][td]RimMind-Bridge-RimChat[/td][td]RimChat compatibility bridge: dialogue/action mutual exclusion &amp; context sync[/td][td]Core, RimChat[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Bridge-RimChat]Link[/url][/td][/tr]
[tr][td]RimMind-Bridge-RimTalk[/td][td]RimTalk compatibility bridge: bubble harmonization &amp; bidirectional context[/td][td]Core, RimTalk[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Bridge-RimTalk]Link[/url][/td][/tr]
[/table]
[code]Core ──┬── Actions ── Advisor
├── Dialogue
├── Memory ── Storyteller
├── Personality
├── Extension-ModelService
├── Bridge-RimChat
└── Bridge-RimTalk[/code]

[h2]Core Features[/h2]
[list]
[*][b]Big-Five Cognitive Profiling[/b] - Maps vanilla RimWorld traits (e.g., Bloodlust, Optimist, Neurotic) onto continuous psychometric axes ([i]Openness, Conscientiousness, Extraversion, Agreeableness, Neuroticism[/i]).
[*][b]Probabilistic State-Transition Reflections[/b] - Colonists reflect naturally during 06:00 Dawn Sunrise (30% chance), Skygazing/Solitude (40% chance), Shared Recreation (25% chance), and Traumatic Mood Swings (50% chance).
[*][b]Dynamic Mood Thought Injection[/b] - Generates 1 to 3 contextual Personality Thoughts (intensity -3 to +3, mapping to -10 to +10 mood offset) injected into independent mood slots without overwriting one another.
[*][b]Bio Personality Tab &amp; Player Editing[/b] - View AI psychological narratives directly in the pawn Bio tab, customize personality descriptions, work preferences, and social tendencies, and use [b]Shape Voting[/b] to guide future AI evaluations.
[/list]

[h2]Trigger Conditions &amp; Mood Scaling[/h2]
[table]
[tr][th]Trigger Type[/th][th]Description[/th][/tr]
[tr][td]06:00 Dawn &amp; Daily Cycle[/td][td]Morning reflection as daylight returns, with staggered offset to avoid simultaneous bursts[/td][/tr]
[tr][td]Injury &amp; Illness[/td][td]Reacts to severe combat wounds or chronic health conditions[/td][/tr]
[tr][td]Skill Milestones[/td][td]Reflects on personal growth when skill levels advance[/td][/tr]
[tr][td]Major Colony Events &amp; Bereavement[/td][td]Reacts to raids, harvests, or the loss of bonded companions[/td][/tr]
[/table]

[table]
[tr][th]AI Intensity[/th][th]Mood Offset[/th][th]Psychological State[/th][/tr]
[tr][td]+3 / +2 / +1[/td][td]+10 / +3 / +1[/td][td]Inspired, hopeful, or quietly content[/td][/tr]
[tr][td]0[/td][td]0[/td][td]Emotionally balanced observation[/td][/tr]
[tr][td]-1 / -2 / -3[/td][td]-1 / -3 / -10[/td][td]Troubled, anxious, or deeply distressed[/td][/tr]
[/table]

[h2]Frequently Asked Questions[/h2]
[b]Q: Can I customize a colonist's personality manually?[/b]
A: Yes! Open the Personality panel in the pawn's Bio tab to edit traits, work habits, and social tendencies, or upvote/downvote AI assessments via Shape Voting.

[b]Q: How does Personality interact with Advisor and Dialogue?[/b]
A: Active Personality profiles and Thoughts are injected into Core's Zone 2 context and broadcast to [code]RimMind-Advisor[/code], ensuring dialogues and action proposals reflect each colonist's true inner state.</description>
<modDependencies>
<li>
<packageId>brrainz.harmony</packageId>
Expand Down
4 changes: 4 additions & 0 deletions Languages/ChineseSimplified/Keyed/RimMind_Personality.xml
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,8 @@
<RimMind.Personality.UI.SocialTendencies>社交倾向</RimMind.Personality.UI.SocialTendencies>
<RimMind.Personality.UI.AINarrative>AI 近期叙事(只读,每日 AI 更新)</RimMind.Personality.UI.AINarrative>
<RimMind.Personality.UI.NarrativeEmpty>(尚未评估——运行一段时间后 AI 会自动填写)</RimMind.Personality.UI.NarrativeEmpty>
<RimMind.Personality.UI.EnableShapingVoteToggle>启用人格塑造投票弹窗</RimMind.Personality.UI.EnableShapingVoteToggle>
<RimMind.Personality.UI.EnableShapingVoteToggle.Tip>取消勾选后,生成新人格特质时将不再在悬浮请求栏弹出投票提示。</RimMind.Personality.UI.EnableShapingVoteToggle.Tip>
<RimMind.Personality.UI.Save>保存</RimMind.Personality.UI.Save>
<RimMind.Personality.UI.Cancel>取消</RimMind.Personality.UI.Cancel>
<RimMind.Personality.UI.ProfileSaved>[RimMind] {0} 的人格档案已保存。</RimMind.Personality.UI.ProfileSaved>
Expand All @@ -73,6 +75,8 @@
<RimMind.Personality.Shaping.Reinforce>强化</RimMind.Personality.Shaping.Reinforce>
<RimMind.Personality.Shaping.Suppress>抑制</RimMind.Personality.Shaping.Suppress>
<RimMind.Personality.Shaping.Ignore>忽略</RimMind.Personality.Shaping.Ignore>
<RimMind.Personality.Shaping.MuteVote>不再弹出</RimMind.Personality.Shaping.MuteVote>
<RimMind.Personality.Shaping.MuteVote.Tip>关闭后续的人格塑造投票弹窗(可在人格设置或角色人格档案窗口中重新开启)。</RimMind.Personality.Shaping.MuteVote.Tip>
<!-- RimMindPersonalityMod.cs - Shaping Action Labels (context provider) -->
<RimMind.Personality.Context.ShapingHistoryHeader>[玩家塑造历史]</RimMind.Personality.Context.ShapingHistoryHeader>
<RimMind.Personality.ShapingAction.Reinforce>强化</RimMind.Personality.ShapingAction.Reinforce>
Expand Down
4 changes: 4 additions & 0 deletions Languages/English/Keyed/RimMind_Personality.xml
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,8 @@
<RimMind.Personality.UI.SocialTendencies>Social tendencies</RimMind.Personality.UI.SocialTendencies>
<RimMind.Personality.UI.AINarrative>AI recent narrative (read-only, updated daily by AI)</RimMind.Personality.UI.AINarrative>
<RimMind.Personality.UI.NarrativeEmpty>(Not yet evaluated - AI will fill in automatically after running for a while)</RimMind.Personality.UI.NarrativeEmpty>
<RimMind.Personality.UI.EnableShapingVoteToggle>Enable personality shaping vote popups</RimMind.Personality.UI.EnableShapingVoteToggle>
<RimMind.Personality.UI.EnableShapingVoteToggle.Tip>When unchecked, new personality traits will not trigger shaping vote popups in the request overlay.</RimMind.Personality.UI.EnableShapingVoteToggle.Tip>
<RimMind.Personality.UI.Save>Save</RimMind.Personality.UI.Save>
<RimMind.Personality.UI.Cancel>Cancel</RimMind.Personality.UI.Cancel>
<RimMind.Personality.UI.ProfileSaved>[RimMind] {0}'s personality profile saved.</RimMind.Personality.UI.ProfileSaved>
Expand All @@ -73,6 +75,8 @@
<RimMind.Personality.Shaping.Reinforce>Reinforce</RimMind.Personality.Shaping.Reinforce>
<RimMind.Personality.Shaping.Suppress>Suppress</RimMind.Personality.Shaping.Suppress>
<RimMind.Personality.Shaping.Ignore>Ignore</RimMind.Personality.Shaping.Ignore>
<RimMind.Personality.Shaping.MuteVote>Mute</RimMind.Personality.Shaping.MuteVote>
<RimMind.Personality.Shaping.MuteVote.Tip>Disable future personality shaping vote popups (can be re-enabled in Personality settings or the colonist's Personality window).</RimMind.Personality.Shaping.MuteVote.Tip>
<!-- RimMindPersonalityMod.cs - Shaping Action Labels (context provider) -->
<RimMind.Personality.Context.ShapingHistoryHeader>[Player Shaping History]</RimMind.Personality.Context.ShapingHistoryHeader>
<RimMind.Personality.ShapingAction.Reinforce>Reinforce</RimMind.Personality.ShapingAction.Reinforce>
Expand Down
50 changes: 16 additions & 34 deletions Source/Comps/CompAIPersonality.cs
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,6 @@
}
}

/// <summary>
/// 挂载于 Pawn 的 ThingComp,负责触发 AI 人格评估。
/// 支持每日定时触发和事件驱动触发(外部 Patch 通过 TriggerEvent 注入)。
/// </summary>
public class CompAIPersonality : ThingComp
{
private bool _hasPendingRequest;
Expand All @@ -34,13 +30,15 @@
private float _lastMood = -1f;
private bool _wasAwake = true;

private Pawn Pawn => (Pawn)parent;
private Pawn? PawnOrNull => parent as Pawn;
private Pawn? Pawn => parent as Pawn;
private AIPersonalitySettings Settings => RimMindPersonalityMod.Settings;

private int GetDailyJitter()
{
if (PawnOrNull is not Pawn pawn) return 0;
if (_dailyJitter < 0)
_dailyJitter = new System.Random(Pawn.thingIDNumber ^ 0x3C3C3C3C).Next(-Settings.jitterRangeTicks, Settings.jitterRangeTicks + 1);
_dailyJitter = new System.Random(pawn.thingIDNumber ^ 0x3C3C3C3C).Next(-Settings.jitterRangeTicks, Settings.jitterRangeTicks + 1);
return _dailyJitter;
}

Expand All @@ -59,7 +57,7 @@
if (parent == null || !parent.IsHashIntervalTick(60)) return;
if (!Settings.enablePersonality) return;
if (!(parent is Pawn pawn) || !RimMindPawnLookup.IsActiveSpawnedColonist(pawn)) return;
if (RimMindAPI.IsConfigured() == false) return;

Check warning on line 60 in Source/Comps/CompAIPersonality.cs

View workflow job for this annotation

GitHub Actions / test / test

'RimMindAPI.IsConfigured()' is obsolete: 'Use RimMindAPI.Settings.IsConfigured instead.'

Check warning on line 60 in Source/Comps/CompAIPersonality.cs

View workflow job for this annotation

GitHub Actions / test / test

'RimMindAPI.IsConfigured()' is obsolete: 'Use RimMindAPI.Settings.IsConfigured instead.'
if (RimMindAPI.IsAgentActive(GetCachedThingId(pawn))) return;
if (_hasPendingRequest)
{
Expand Down Expand Up @@ -119,29 +117,23 @@
});
}

/// <summary>
/// Detects natural behavioral transitions and queues probabilistic personality evaluations.
/// Colonist thoughts are not locked to 6:00 AM; they emerge dynamically at natural awakening (any hour),
/// dusk/sunset, idle wandering pulses, job shifts, and mood swings.
/// </summary>
private void ObserveStateTransitions()
{
Map? map = Pawn.Map;
if (PawnOrNull is not Pawn pawn) return;
Map? map = pawn.Map;
if (map == null) return;

int currentTick = Find.TickManager.TicksGame;
float activityScale = RimMindAPI.Settings.ActivityFrequencyScale;
int effectiveCooldown = RimMind.Application.Common.Helpers.ActivityCooldownScaler.Scale(Settings.eventCooldownTicks, activityScale);
bool canQueue = !_hasPendingRequest && (currentTick - _lastEventTick) >= effectiveCooldown && _pendingEventContext == null;

// Check A: Sunrise / Dawn transition (sampled every 250 ticks ≈ 4 seconds)
bool isAwake = Pawn.Awake();
bool isAwake = pawn.Awake();
bool justWokeUp = !_wasAwake && isAwake;
_wasAwake = isAwake;

float currentMood = Pawn.needs?.mood?.CurLevel ?? 0.5f;
float currentMood = pawn.needs?.mood?.CurLevel ?? 0.5f;

// Check A1: Natural Awakening transition at ANY hour of day or night
if (justWokeUp && canQueue && Settings.enableSunriseTrigger)
{
float jitter = Rand.Range(0.85f, 1.15f);
Expand All @@ -168,8 +160,7 @@
}
}

// Check A2: Dusk / Sunset transition (sampled every ~250 ticks ≈ 4 seconds)
if (Pawn.IsHashIntervalTick(250, 60))
if (pawn.IsHashIntervalTick(250, 60))
{
int currentHour = GenLocalDate.HourInteger(map);
if (_lastHour != -1 && currentHour != _lastHour)
Expand All @@ -189,10 +180,9 @@
_lastHour = currentHour;
}

// Check A3: Daytime Idle Wandering Contemplation Pulse (sampled every ~2500 ticks ≈ 40 seconds)
if (Pawn.IsHashIntervalTick(2500, 60) && canQueue && isAwake)
if (pawn.IsHashIntervalTick(2500, 60) && canQueue && isAwake)
{
JobDef? activeJob = Pawn.CurJobDef;
JobDef? activeJob = pawn.CurJobDef;
bool isIdle = activeJob == JobDefOf.Wait_Wander || activeJob == JobDefOf.GotoWander || activeJob == JobDefOf.Wait;
if (isIdle)
{
Expand All @@ -209,15 +199,13 @@
}
}

// Check B: Job Transition (Recreation or Skygaze/Meditate)
JobDef? curJob = Pawn.CurJobDef;
JobDef? curJob = pawn.CurJobDef;
string? curJobName = curJob?.defName;
if (curJobName != _lastJobDefName)
{
if (curJob != null && curJobName != null)
{
float jitter = Rand.Range(0.85f, 1.15f);
// Skygazing / Meditating / Praying
if (curJobName == "Skygaze" || curJobName == "Meditate" || curJobName == "Pray")
{
float dynamicChance = PersonalityTriggerPolicy.CalculateDynamicPersonalityChance(Settings.skygazeTriggerChance, currentMood, jitter, activityScale);
Expand All @@ -232,7 +220,6 @@
curJob.label ?? curJobName);
}
}
// Joy / Recreation
else if (curJob.joyKind != null)
{
float dynamicChance = PersonalityTriggerPolicy.CalculateDynamicPersonalityChance(Settings.recreationTriggerChance, currentMood, jitter, activityScale);
Expand All @@ -251,10 +238,9 @@
_lastJobDefName = curJobName;
}

// Check C: Mood Swing (sampled every ~500 ticks ≈ 8 seconds)
if (Pawn.IsHashIntervalTick(500, 60) && Pawn.needs?.mood != null)
if (pawn.IsHashIntervalTick(500, 60) && pawn.needs?.mood != null)
{
float curMood = Pawn.needs.mood.CurLevel;
float curMood = pawn.needs.mood.CurLevel;
if (_lastMood < 0f)
{
_lastMood = curMood;
Expand All @@ -281,22 +267,18 @@
}
}

/// <summary>
/// 从外部 Patch(受伤、技能升级、事件等)触发一次人格评估。
/// </summary>
public void TriggerEvent(string context, TriggerEventType eventType = TriggerEventType.Incident)
{
if (!Settings.enablePersonality) return;
if (PawnOrNull == null || !Settings.enablePersonality) return;

if (!PersonalityTriggerPolicy.IsTriggerEnabled(eventType, Settings))
return;

_pendingEventContext = context;
}

private bool IsEligible() => PersonalityTriggerPolicy.IsEligible(Pawn);
private bool IsEligible() => PawnOrNull is Pawn pawn && PersonalityTriggerPolicy.IsEligible(pawn);

// Delegates to RimMindText.TrOr (guards key.CanTranslate() on the main thread).
private static string TranslateOrFallback(string key, string fallback, params object[] args)
=> RimMindText.TrOr(key, fallback, args);

Expand Down
14 changes: 4 additions & 10 deletions Source/Patches/AddCompToHumanlikePatch.cs
Original file line number Diff line number Diff line change
Expand Up @@ -8,27 +8,21 @@
namespace RimMind.Personality.Patches
{
/// <summary>
/// 在所�ThingDef 解析完继承关系(ResolveReferences)之后,
/// 动态为所有人形智能小人(�AlienRaces 外星种族)注�CompProperties_AIPersonality�
///
/// 为什么不�XML PatchOperation�
/// XML Patch 在继承解析前运行,raw XML 里没�race/intelligence 字段(它们从父类继承而来),
/// 所�XPath 过滤 race/intelligence="Humanlike" 匹配 0 个节点�
/// Harmony Postfix 在解析后运行,可直接读取已解析的 race 字段�
/// 一次性覆盖原�Human + 所�AlienRaces 种族 + 未来任何 mod 添加的人形种族�
/// Dynamically injects CompProperties_AIPersonality into all humanlike Pawn ThingDefs
/// after ThingDef.ResolveReferences completes (excluding Corpse ThingDefs).
/// </summary>
[HarmonyPatch(typeof(ThingDef), nameof(ThingDef.ResolveReferences))]
public static class AddCompToHumanlikePatch
{
[HarmonyPostfix]
public static void Postfix(ThingDef __instance)
{
// 只处理人形智能种�
if (__instance == null || __instance.IsCorpse) return;
if (__instance.thingClass == null || !typeof(Pawn).IsAssignableFrom(__instance.thingClass)) return;
if (__instance.race?.intelligence != Intelligence.Humanlike) return;

__instance.comps ??= new List<CompProperties>();

// 避免重复注入(热重载或多次调用场景)
if (__instance.comps.Any(c => c is CompProperties_AIPersonality)) return;

__instance.comps.Add(new CompProperties_AIPersonality());
Expand Down
Loading
Loading