Rimworld Mod教程 武器Weapon篇 近战章 第二讲：生物可用的近战来源

本讲分析的是在原版（core+all dlc）环境下，一个Pawn可以用的Tools的所有来源。
重点要分析的是RimWorld.Pawn_MeleeVerbs下的方法GetUpdatedAvailableVerbsList，我把它贴在下面：

public List<VerbEntry> GetUpdatedAvailableVerbsList(bool terrainTools)
{
	meleeVerbs.Clear();
	verbsToAdd.Clear();
	if (!terrainTools)
	{
		List<Verb> allVerbs = pawn.verbTracker.AllVerbs;
		for (int i = 0; i < allVerbs.Count; i++)
		{
			if (IsUsableMeleeVerb(allVerbs[i]))
			{
				verbsToAdd.Add(allVerbs[i]);
			}
		}
		if (pawn.equipment != null)
		{
			List<ThingWithComps> allEquipmentListForReading = pawn.equipment.AllEquipmentListForReading;
			for (int j = 0; j < allEquipmentListForReading.Count; j++)
			{
				List<Verb> list = allEquipmentListForReading[j].GetComp<CompEquippable>()?.AllVerbs;
				if (list == null)
				{
					continue;
				}
				for (int k = 0; k < list.Count; k++)
				{
					if (IsUsableMeleeVerb(list[k]))
					{
						verbsToAdd.Add(list[k]);
					}
				}
			}
		}
		if (pawn.apparel != null)
		{
			List<Apparel> wornApparel = pawn.apparel.WornApparel;
			for (int l = 0; l < wornApparel.Count; l++)
			{
				List<Verb> list2 = wornApparel[l].GetComp<CompEquippable>()?.AllVerbs;
				if (list2 == null)
				{
					continue;
				}
				for (int m = 0; m < list2.Count; m++)
				{
					if (IsUsableMeleeVerb(list2[m]))
					{
						verbsToAdd.Add(list2[m]);
					}
				}
			}
		}
		foreach (Verb hediffsVerb in pawn.health.hediffSet.GetHediffsVerbs())
		{
			if (IsUsableMeleeVerb(hediffsVerb))
			{
				verbsToAdd.Add(hediffsVerb);
			}
		}
		if (ModsConfig.AnomalyActive && pawn.IsMutant)
		{
			foreach (Verb allVerb in pawn.mutant.AllVerbs)
			{
				if (IsUsableMeleeVerb(allVerb))
				{
					verbsToAdd.Add(allVerb);
				}
			}
		}
	}
	else if (pawn.Spawned && !pawn.IsMutant)
	{
		TerrainDef terrain = pawn.Position.GetTerrain(pawn.Map);
		if (terrainVerbs == null || terrainVerbs.def != terrain)
		{
			terrainVerbs = Pawn_MeleeVerbs_TerrainSource.Create(this, terrain);
		}
		List<Verb> allVerbs2 = terrainVerbs.tracker.AllVerbs;
		for (int n = 0; n < allVerbs2.Count; n++)
		{
			Verb verb = allVerbs2[n];
			if (IsUsableMeleeVerb(verb))
			{
				verbsToAdd.Add(verb);
			}
		}
	}
	float num = 0f;
	foreach (Verb item in verbsToAdd)
	{
		float num2 = VerbUtility.InitialVerbWeight(item, pawn);
		if (num2 > num)
		{
			num = num2;
		}
	}
	foreach (Verb item2 in verbsToAdd)
	{
		meleeVerbs.Add(new VerbEntry(item2, pawn, verbsToAdd, num));
	}
	return meleeVerbs;
	bool IsUsableMeleeVerb(Verb v)
	{
		if (v.IsMeleeAttack)
		{
			return v.IsStillUsableBy(pawn);
		}
		return false;
	}
}

具有一定C#基础的同学一看就懂了，好的，本期教程到此为止，谢谢大家【

咳咳，然而该教程依然是面向XML的教程，所以我将把上述天书翻译为正常的教程内容。
首先，一个Pawn本身会自带一定的Tools，比如人类的左拳右拳牙齿头槌：

Core\ThingDefs_Races\Races_Humanlike.xml，line16开始

<tools>
      <li>
        <label>left fist</label>
        <labelNoLocation>fist</labelNoLocation>
        <capacities>
          <li>Blunt</li>
        </capacities>
        <power>8.2</power>
        <cooldownTime>2</cooldownTime>
        <linkedBodyPartsGroup>LeftHand</linkedBodyPartsGroup>
        <surpriseAttack>
          <extraMeleeDamages>
            <li>
              <def>Stun</def>
              <amount>14</amount>
            </li>
          </extraMeleeDamages>
        </surpriseAttack>
      </li>
      <li>
        <label>right fist</label>
        <labelNoLocation>fist</labelNoLocation>
        <capacities>
          <li>Blunt</li>
        </capacities>
        <power>8.2</power>
        <cooldownTime>2</cooldownTime>
        <linkedBodyPartsGroup>RightHand</linkedBodyPartsGroup>
        <surpriseAttack>
          <extraMeleeDamages>
            <li>
              <def>Stun</def>
              <amount>14</amount>
            </li>
          </extraMeleeDamages>
        </surpriseAttack>
      </li>
      <li>
        <label>teeth</label>
        <capacities>
          <li>Bite</li>
        </capacities>
        <power>8.2</power>
        <cooldownTime>2</cooldownTime>
        <linkedBodyPartsGroup>Teeth</linkedBodyPartsGroup>
        <chanceFactor>0.07</chanceFactor>
        <soundMeleeHit>Pawn_Melee_HumanBite_Hit</soundMeleeHit>
        <soundMeleeMiss>Pawn_Melee_HumanBite_Miss</soundMeleeMiss>
      </li>
      <li>
        <label>head</label>
        <capacities>
          <li>Blunt</li>
        </capacities>
        <power>5</power>
        <cooldownTime>2</cooldownTime>
        <linkedBodyPartsGroup>HeadAttackTool</linkedBodyPartsGroup>
        <ensureLinkedBodyPartsGroupAlwaysUsable>true</ensureLinkedBodyPartsGroupAlwaysUsable>
        <chanceFactor>0.2</chanceFactor>
      </li>
</tools>

Pawn自带的tools会多出一个常用的字段，为linkedBodyPartsGroup，即该Tool与身体部件绑定。具体来说，与其绑定的BodyPartsGroup内的身体部件的效率会以倍率的形式影响该Tool的伤害；而如果Group内的身体部件均已缺失，则该Tool的伤害为0，也就不会被使用。
与之相关的另一个字段是ensureLinkedBodyPartsGroupAlwaysUsable，如果填的是true，那么伤害倍率至少为0.4倍，那么即使绑定的所有部件均已缺失，也能正常使用。

除此之外，这里还有一个surpriseAttack的词条，这并非“暴击”的意思，而是突然袭击。
具体来说，这个机制只有一个触发条件：当野生的食肉动物触发狩猎工作（JobDriver_PredatorHunt）时，若该次攻击是对目标造成的第一次尝试攻击，且目标并非殖民者，那么会造成额外的效果。在原版，这个额外效果均为14*30tick（7秒）的晕眩。

还有一个出现的chanceFactor，它会影响随机选用tools时被选中的概率。（具体的选择逻辑后续讲吧）


第二个来源是手持的武器，这个就不再细讲了。
第三个来源是身上的装备，装备依然需要带有CompEquippable，与武器类似。
第四个来源是hediff，比如皇权里面的肘刀：

Royalty\HediffDefs\Hediffs_BodyParts_Prosthetic_Empire.xml

<HediffDef ParentName="ImplantHediffBase">
    <defName>ElbowBlade</defName>
    <label>elbow blade</label>
    <labelNoun>an elbow blade</labelNoun>
    <description>An installed elbow blade. Extends at will from a hidden opening at the end of the ulna. Appearing without warning, it can be used for devastating slice attacks.</description>
    <descriptionHyperlinks><ThingDef>ElbowBlade</ThingDef></descriptionHyperlinks>
    <addedPartProps>
      <solid>true</solid>
    </addedPartProps>
    <comps>
      <li Class="HediffCompProperties_VerbGiver">
        <tools>
          <li>
            <label>blade</label>
            <capacities>
              <li>Cut</li>
            </capacities>
            <power>18</power>
            <cooldownTime>2</cooldownTime>
            <alwaysTreatAsWeapon>true</alwaysTreatAsWeapon>
            <soundMeleeHit>MeleeHit_BionicSlash</soundMeleeHit>
            <soundMeleeMiss>MeleeMiss_BionicSlash</soundMeleeMiss>
          </li>
        </tools>
      </li>
    </comps>
    <spawnThingOnRemoved>ElbowBlade</spawnThingOnRemoved>
</HediffDef>

就是这里的comp里面的内容。当带有该comp的hediff出现在小人身上的时候，小人就能直接使用它作为近战来源。

第五个来源是异象DLC下的机制，变异的生物会获得来自变异提供的更多tools，在MutantDef.tools进行编辑。原版比较典型的是蹒跚怪获得的新tools：
Anomaly\Misc\Mutants.xml line87

 <tools>
      <li>
        <label>teeth</label>
        <capacities>
          <li>Bite</li>
        </capacities>
        <power>8.2</power>
        <cooldownTime>2</cooldownTime>
        <linkedBodyPartsGroup>Teeth</linkedBodyPartsGroup>
        <chanceFactor>1</chanceFactor>
        <soundMeleeHit>Pawn_Melee_HumanBite_Hit</soundMeleeHit>
        <soundMeleeMiss>Pawn_Melee_HumanBite_Miss</soundMeleeMiss>
      </li>
      <li>
        <label>left hand</label>
        <labelNoLocation>hand</labelNoLocation>
        <capacities>
          <li>Scratch</li>
        </capacities>
        <power>7.0</power>
        <cooldownTime>2</cooldownTime>
        <linkedBodyPartsGroup>LeftHand</linkedBodyPartsGroup>
        <chanceFactor>1.5</chanceFactor>
        <alwaysTreatAsWeapon>true</alwaysTreatAsWeapon>
      </li>
      <li>
        <label>right hand</label>
        <labelNoLocation>hand</labelNoLocation>
        <capacities>
          <li>Scratch</li>
        </capacities>
        <power>7.0</power>
        <cooldownTime>2</cooldownTime>
        <linkedBodyPartsGroup>RightHand</linkedBodyPartsGroup>
        <chanceFactor>1.5</chanceFactor>
        <alwaysTreatAsWeapon>true</alwaysTreatAsWeapon>
      </li>
</tools>

新增了一个牙齿，两个伤害类型为刮伤的左右手。这三个tools类似Pawn自带的tools，也是与身体部件绑定的。但可以发现它们的chanceFactor都被设置的很高，表达了泰南将其作为更高攻击性身体武器的想法。


第六个来源是地板。Core\TerrainDefs\Terrain_Natural.xml  line41

 <tools>
      <li>
        <label>dirt</label>
        <capacities>
          <li>KickMaterialInEyes</li>
        </capacities>
        <hediff>DirtInEyes</hediff>
        <cooldownTime>1.5</cooldownTime>
      </li>
</tools>

就是站在这种地形上可以使用这种tool，这里是把土踢进人眼睛里，是一个特殊的近战。

没了。下次再会。