设计文档：跟踪冲撞技能 (Tracking Charge)

版本: 0.1

1. 概述

本文档旨在详细说明一个新的 RimWorld 技能：“跟踪冲撞”。该技能允许一个 Pawn（施法者）像制导导弹一样冲向一个目标 Pawn。在飞行过程中，它会对路径上接触到的所有敌对单位和可破坏建筑造成伤害。伤害值会随着飞行距离的增加而累积。当撞击到主目标后，施法者会因惯性继续向前滑行一小段距离。

2. 核心功能需求

技能类型: 主动施放的 targeted ability。
移动方式: 动态追踪曲线移动，而非直线或抛物线。
伤害机制:
- 路径伤害: 对飞行路径上碰撞到的所有有效目标（敌方、中立、可破坏建筑）造成伤害。
- 累积伤害: 总伤害 = 基础伤害 + (飞行距离 * 每米伤害增量)。
- 主目标伤害: 与路径伤害计算方式相同。
最终效果: 撞击主目标后，追踪停止，施法者沿最后的方向继续滑行一小段距离后停下。

3. 技术架构

我们将采用基于自定义 PawnFlyer 的核心架构。这种方法将移动和效果逻辑封装在一个临时的 Thing 中，而施法者 Pawn 本身在技能持续期间会从地图上暂时移除。

3.1. 核心组件

组件名称 (C# Class)	类型	职责
`Verb_CastAbilityTrackingCharge`	`Verb`	技能启动器: 验证目标，从 `CompProperties` 读取配置，创建并初始化 `PawnFlyer_TrackingCharge`。
`PawnFlyer_TrackingCharge`	`PawnFlyer`	核心逻辑处理器: 接收来自 `Verb` 的参数，实现追踪、碰撞、伤害、惯性等所有动态逻辑。
`CompProperties_TrackingCharge`	`CompProperties_AbilityEffect`	XML配置接口: 在 `AbilityDef` 的 `<comps>` 中定义技能的所有可调参数，如伤害、速度、惯性等。
`CompAbilityEffect_TrackingCharge`	`CompAbilityEffect`	数据容器: 作为一个轻量级的组件，其主要作用是让 `CompProperties_TrackingCharge` 能被游戏正确加载。它本身不执行复杂逻辑。

3.2. 设计决策：配置的分层与传递

采纳的方案 (混合模式): 我们将采用一种既符合直觉又技术稳健的混合模式。
1. 配置集中在 AbilityDef: 使用 CompProperties_TrackingCharge (继承自 CompProperties_AbilityEffect) 来存放所有技能参数。这使得 Mod 用户可以在 AbilityDef 的 <comps> 节点中方便地调整一切，符合 RimWorld 的标准实践。
2. Verb 作为数据中介: Verb_CastAbilityTrackingCharge 在施法时，会从 this.ability.def 中轻松获取到 CompProperties_TrackingCharge 的实例，读取所有配置参数。
3. PawnFlyer 接收参数: Verb 在创建 PawnFlyer_TrackingCharge 实例后，会通过一个自定义的初始化方法（例如 Initialize(...)），将所有读取到的参数“注入”到 PawnFlyer 实例中。
优点: 这个方案完美地解决了您的顾虑。配置的易用性（在 AbilityDef 中）和逻辑的清晰性（PawnFlyer 负责执行）都得到了保证。

3.3. 数据流与交互

graph TD
    subgraph Player Action
        A[玩家选择目标并施放技能] --> B(AbilityDef);
    end

    subgraph XML Definitions
        B -- contains --> E[CompProperties_TrackingCharge];
        B -- uses --> C(VerbDef);
        C -- verbClass --> D[Verb_CastAbilityTrackingCharge];
        F(ThingDef for Flyer) -- thingClass --> G[PawnFlyer_TrackingCharge];
    end

    subgraph C# Logic
        D -- 1. Reads Params from --> E;
        D -- 2. Creates --> G;
        D -- 3. Injects Params into --> G;
        G -- 4. Executes Tick Logic --> H{追踪 & 碰撞};
        H -- 5. Applies Damage to --> I[Things on Path];
        G -- 6. Handles Inertia & Self-Destructs --> J[Final Position];
    end

    PlayerInput([施法者 Pawn]) -- temporarily removed --> G;
    G -- places back --> PlayerInput;

4. 详细实现步骤

步骤 1: 创建 C# 类骨架 (最终版)

文件: CompProperties_TrackingCharge.cs
- 继承: Verse.CompProperties_AbilityEffect
- 职责: 定义所有可在 XML 中配置的技能参数。
- 示例字段: public float homingSpeed;, public float initialDamage;, public float damagePerTile;, public float inertiaDistance;, public DamageDef collisionDamageDef;, public ThingDef flyerDef; (用于指定飞行器的ThingDef)。
文件: CompAbilityEffect_TrackingCharge.cs
- 继承: Verse.CompAbilityEffect
- 职责: 轻量级组件，其存在是为了让 CompProperties_TrackingCharge 能被游戏正确加载和访问。
文件: Verb_CastAbilityTrackingCharge.cs
- 继承: Verse.Verb_CastAbility
- 职责:
  1. 在 TryCastShot() 中，从 this.ability.GetComp<CompAbilityEffect_TrackingCharge>().Props 获取配置。
  2. 调用 PawnFlyer.MakeFlyer(Props.flyerDef, ...) 创建 PawnFlyer_TrackingCharge 实例。
  3. 将配置参数设置到 PawnFlyer 的公共字段上。
  4. 调用 flyer.Launch() 启动。
文件: PawnFlyer_TrackingCharge.cs
- 继承: Verse.PawnFlyer
- 职责:
  1. 定义一系列公共字段 (public float homingSpeed; 等) 来接收来自 Verb 的参数。
  2. 在 Tick() 中实现所有核心的追踪、碰撞和伤害逻辑。
- 注意: 不创建自定义的 Initialize() 方法，也不重写 Launch() 来接收参数，以保持设计的简洁和标准。

下一步: 设计文档已最终确定。我将开始实施 步骤 1，为您创建这四个 C# 类的代码框架。

6.2 KiB Raw Blame History Unescape Escape