异噬XML数据定义文档

健康定义 (<HediffDef>)

功能说明

健康定义（HediffDef）用于定义游戏中各种状态效果、增益或减益。它可以是一个临时的加速效果，一个持续的毒素伤害，一个永久的生命值上限提升，或者其他任何能在一段时间内或永久影响实体属性或行为的状态。Hediff可以具有多个发展阶段，并在不同的阶段表现出不同的效果。

可用参数

示例

示例1：简单的临时加速效果

<Define>
    <HediffDef>
        <defName>TemporarySpeedBoost</defName>
        <label>加速</label>
        <description>暂时提升移动速度。</description>
        <time>10</time> <!-- 持续10秒 -->
        <stages>
            <li>
                <start>0</start> <!-- 从 Hediff 出现时立即生效 -->
                <attributesOffset>
                    <moveSpeedPercentOffset>0.5</moveSpeedPercentOffset> <!-- 移动速度提升50% -->
                </attributesOffset>
            </li>
        </stages>
    </HediffDef>
</Define>

示例2：具有多个阶段的毒素效果

<Define>
    <HediffDef>
        <defName>ToxicExposure</defName>
        <label>毒素暴露</label>
        <description>受到毒素影响，随时间恶化。</description>
        <time>30</time> <!-- 总持续30秒 -->
        <stages>
            <li>
                <start>0</start> <!-- 0-10秒：轻微阶段 -->
                <label>轻度中毒</label>
                <attributesOffset>
                    <moveSpeedPercentOffset>-0.1</moveSpeedPercentOffset> <!-- 10%减速 -->
                </attributesOffset>
            </li>
            <li>
                <start>10</start> <!-- 10-20秒：中度阶段 -->
                <label>中度中毒</label>
                <attributesOffset>
                    <moveSpeedPercentOffset>-0.25</moveSpeedPercentOffset> <!-- 25%减速 -->
                    <healthOffset>-0.1</healthOffset> <!-- 每秒损失0.1生命值（通过Comp实现） -->
                </attributesOffset>
            </li>
            <li>
                <start>20</start> <!-- 20-30秒：重度阶段 -->
                <label>重度中毒</label>
                <attributesOffset>
                    <moveSpeedPercentOffset>-0.5</moveSpeedPercentOffset> <!-- 50%减速 -->
                    <attackPercentOffset>-0.2</attackPercentOffset> <!-- 攻击力降低20% -->
                    <healthOffset>-0.3</healthOffset> <!-- 每秒损失0.3生命值 -->
                </attributesOffset>
            </li>
        </stages>
        <comps>
            <li>
                <!-- 范例：一个自定义组件，负责根据attributesOffset.healthOffset属性造成持续伤害 -->
                <compClass>HediffComp_DamageOverTime</compClass> 
                <properties>{"damageType":"Poison", "tickInterval":1.0}</properties>
            </li>
        </comps>
    </HediffDef>
</Define>

Hediff阶段定义 (<HediffStageDef>)

功能说明

Hediff阶段定义（HediffStageDef）用于描述一个特定状态效果在不同发展阶段的具体属性偏移。一个具有多个阶段的Hediff可以在其持续时间内，随着时间的推移从一个阶段过渡到另一个阶段，从而表现出不同的效果。

可用参数

复杂参数说明

attributesOffset 字段 (属性偏移定义)

• 说明：这是一个 属性偏移定义 (<AttributesOffsetDef>) 的匿名定义或引用。它详细说明了该 Hediff 阶段对实体各项属性（如生命值、移动速度、攻击力等）造成的具体影响，包括绝对值偏移和百分比偏移。
• 匿名定义方式：

  <attributesOffset>
      <healthOffset>-5</healthOffset> <!-- 生命值上限减少5 -->
      <moveSpeedPercentOffset>0.2</moveSpeedPercentOffset> <!-- 移动速度提高20% -->
  </attributesOffset>
  

属性偏移定义 (<AttributesOffsetDef>)

功能说明

属性偏移定义（AttributesOffsetDef）是一个辅助定义，通常作为 Hediff阶段定义 (<HediffStageDef>) 中的匿名定义，用于详细指定对实体各项属性的修改量。这些修改可以是直接的数值增减（绝对值偏移），也可以是基于现有属性值的百分比增减（百分比偏移）。

可用参数

示例

<!-- 作为 HediffStageDef 内部的匿名定义 -->
<attributesOffset>
    <healthOffset>50</healthOffset>               <!-- 生命值上限增加50 -->
    <moveSpeedPercentOffset>0.15</moveSpeedPercentOffset> <!-- 移动速度增加15% -->
    <attackOffset>10</attackOffset>               <!-- 攻击力增加10 -->
    <defensePercentOffset>-0.05</defensePercentOffset> <!-- 防御力降低5% -->
</attributesOffset>

Hediff组件定义 (<HediffCompDef>)

功能说明

Hediff组件定义（HediffCompDef）允许你为 健康定义 (<HediffDef>) 附加更复杂和动态的行为逻辑。每个组件都是一个独立的模块，可以实现特定功能，例如持续伤害、特殊效果触发、周期性事件等。

可用参数

示例

这是一个定义了一个持续造成伤害的Hediff组件的例子：

<!-- 作为 HediffDef 内部的匿名定义 -->
<comps>
    <li>
        <compClass>HediffComp_DamageOverTime</compClass>
        <properties>
            {"damageAmount": 2.5, "damageInterval": 1.0, "damageType": "Burn"}
        </properties>
    </li>
    <li>
        <!-- 另一个组件，例如周期性清除其他Debuff -->
        <compClass>HediffComp_PeriodicCleanse</compClass>
        <properties>
            {"cleanseInterval": 5.0, "cleanseChance": 0.8, "targetHediffTags": ["DebuffTag"]}
        </properties>
    </li>
</comps>

复杂参数说明

properties 字段 (属性字符串)

• 说明：这是一个字符串字段，用于向 compClass 指定的组件传递自定义的配置数据。该字符串内容通常期望是JSON格式，以便组件可以在运行时解析这些数据来配置其行为。例如，一个伤害组件可能需要 damageAmount 和 tickInterval 参数。
• 示例：

  <properties>
      {"key1": "value1", "key2": 123, "key3": true, "nestedObject": {"subKey": "subValue"}}
  </properties>
  

  组件的C#代码会负责解析这段JSON字符串并将其映射到自身的属性上。