diff --git a/1.6/Defs/HediffDefs/ARA_Hediffs_HiveMind.xml b/1.6/Defs/HediffDefs/ARA_Hediffs_HiveMind.xml new file mode 100644 index 0000000..02f3fac --- /dev/null +++ b/1.6/Defs/HediffDefs/ARA_Hediffs_HiveMind.xml @@ -0,0 +1,37 @@ + + + + + ARA_HiveMindMaster + + The central node of a hive mind, connected to multiple drone beings. + ArachnaeSwarm.Hediff_HiveMindMaster + (0.8, 0.3, 0.8) + false + true + 100 + +
  • + + 0 + +
  • +
    +
    + + + ARA_HiveMindDrone + + A drone being, psychically linked to a master node. If the master dies, this unit will cease to function. + ArachnaeSwarm.Hediff_HiveMindDrone + (0.6, 0.4, 0.8) + false + true + +
  • + +
  • +
    +
    + +
    \ No newline at end of file diff --git a/Source/Documents/HiveMind_Design.md b/Source/Documents/HiveMind_Design.md new file mode 100644 index 0000000..2c8a218 --- /dev/null +++ b/Source/Documents/HiveMind_Design.md @@ -0,0 +1,147 @@ +# 蜂巢意识(Hive Mind)系统设计文档 - v2 + +## 1. 需求概述 + +本设计旨在为 `ArachnaeSwarm` Mod 实现一个“蜂巢意识”系统。该系统包含两种角色: + +- **主节点 (Master)**:蜂巢的中心。 +- **子节点 (Drone)**:蜂巢的工蜂,可以有多个。 + +它们之间通过 `Hediff`(健康状态)进行链接,实现以下核心功能: + +1. **自动绑定**:子节点在生成时,会自动在地图上寻找携带 `ARA_HiveMindMaster` Hediff 的Pawn作为主节点。如果找到多个,则选择第一个进行绑定。如果找不到主节点,子节点会立即死亡。 +2. **主从死亡联动**:当主节点死亡时,所有与之链接的子节点也会立即死亡。 +3. **链接增益**:主节点的力量会随着链接的子节点数量增加而增强。具体表现为主节点的 `Hediff` 严重性(Severity)会随着子节点数量的增加而提升,为后续添加属性加成提供基础。 + +## 2. 技术方案 + +为了实现上述功能,我们将创建以下组件: + +### 2.1. XML 定义 (使用 ARA_ 前缀) + +我们将定义两个新的 `HediffDef`: + +- `HediffDef: ARA_HiveMindMaster` + - **hediffClass**: `ArachnaeSwarm.Hediff_HiveMindMaster` + - **描述**: 应用于主节点,用于管理子节点链接并根据数量调整严重性。 +- `HediffDef: ARA_HiveMindDrone` + - **hediffClass**: `ArachnaeSwarm.Hediff_HiveMindDrone` + - **描述**: 应用于子节点,继承自 `HediffWithTarget`,其 `target` 字段将指向主节点。 + +### 2.2. C# 类定义 (命名空间: ArachnaeSwarm) + +我们将实现两个新的C#类: + +- `Hediff_HiveMindMaster` + - 继承自 `Hediff`。 + - 包含一个 `List` 类型的字段 `drones`,用于存储所有已链接的子节点。 + - 提供 `RegisterDrone(Pawn drone)` 和 `DeregisterDrone(Pawn drone)` 方法,用于添加和移除子节点。 + - 在每次注册/反注册后,更新自身的 `Severity` 属性,其值等于 `drones.Count`。 + - 重写 `PostRemoved()` 方法,在主节点死亡或Hediff被移除时,杀死所有已注册的子节点。 + +- `Hediff_HiveMindDrone` + - 继承自 `HediffWithTarget`。 + - 重写 `PostAdd(DamageInfo? dinfo)` 方法。在此方法中: + 1. 在当前地图上扫描所有Pawn,查找携带 `ARA_HiveMindMaster` Hediff 的单位。 + 2. 如果找到至少一个,则选择第一个作为 `target`,并调用其 `RegisterDrone` 方法将自己注册进去。 + 3. 如果找不到任何主节点,立即杀死自己 (`pawn.Kill(null, null)`)。 + - 重写 `PostRemoved()` 方法,在自身被移除时,如果 `target` 仍然有效,则调用其 `DeregisterDrone` 方法将自己从中移除。 + - 在 `PostTick()` 或类似方法中周期性检查 `target`(主节点)是否已死亡或 Hediff 已被移除。如果是,则立即杀死自己。 + +## 3. 开发步骤 (TODO List) + +- [ ] **步骤 1: 创建 XML 定义** + - 在 `ArachnaeSwarm/1.6/Defs/HediffDefs/` 目录下创建 `ARA_Hediffs_HiveMind.xml` 文件。 +- [ ] **步骤 2: 实现 C# 类 `Hediff_HiveMindMaster`** + - 在 `ArachnaeSwarm/Source/ArachnaeSwarm/` 目录下创建 `Hediff_HiveMindMaster.cs` 文件并编写代码。 +- [ ] **步骤 3: 实现 C# 类 `Hediff_HiveMindDrone`** + - 在 `ArachnaeSwarm/Source/ArachnaeSwarm/` 目录下创建 `Hediff_HiveMindDrone.cs` 文件并编写代码。 +- [ ] **步骤 4: 更新项目文件** + - 将新创建的 `.cs` 文件添加到 `ArachnaeSwarm.csproj` 项目文件中。 +- [ ] **步骤 5: 编译和测试** + - 运行 `dotnet build` 编译项目,修复所有编译错误。 + - 进入游戏进行功能测试。 + +## 4. 参考代码 + +### `HediffWithTarget.cs` + +```csharp +using Verse; + +namespace RimWorld +{ + public class HediffWithTarget : HediffWithComps + { + public Thing target; + + public override bool ShouldRemove + { + get + { + if (target != null && !(target is Pawn { Dead: not false })) + { + return base.ShouldRemove; + } + return true; + } + } + + public override void ExposeData() + { + base.ExposeData(); + Scribe_References.Look(ref target, "target"); + } + } +} +``` + +### `Hediff_PsychicBond.cs` + +```csharp +using Verse; + +namespace RimWorld +{ + public class Hediff_PsychicBond : HediffWithTarget + { + private const int HediffCheckInterval = 65; + + public override string LabelBase => base.LabelBase + " (" + target?.LabelShortCap + ")"; + + public override bool ShouldRemove + { + get + { + if (!base.ShouldRemove) + { + return pawn.Dead; + } + return true; + } + } + + public override void PostRemoved() + { + base.PostRemoved(); + Gene_PsychicBonding gene_PsychicBonding = base.pawn.genes?.GetFirstGeneOfType(); + if (gene_PsychicBonding != null) + { + gene_PsychicBonding.RemoveBond(); + } + else if (target != null && target is Pawn pawn) + { + pawn.genes?.GetFirstGeneOfType()?.RemoveBond(); + } + } + + public override void PostTickInterval(int delta) + { + base.PostTickInterval(delta); + if (pawn.IsHashIntervalTick(65, delta)) + { + Severity = (ThoughtWorker_PsychicBondProximity.NearPsychicBondedPerson(pawn, this) ? 0.5f : 1.5f); + } + } + } +} \ No newline at end of file