Wiki/pages/WeaponDescriptions武器用法.md

2023年2月11日 对应游戏版本v1.0.3 皮蛋初版完成

根元素

类型名

  <WeaponDescription 元素1=""
                     元素2=""
                     ……>
    <WeaponFlags>
      <WeaponFlag value="MeleeWeapon"/>
      <WeaponFlag value="NotUsableWithOneHand"/>
      ……
    </WeaponFlags>
    <AvailablePieces>
     <AvailablePiece id="axe_craft_1_handle"/>
     <AvailablePiece id="mace_head_24"/>
     ……
    </AvailablePieces>
  </WeaponDescription>

原版路径

Modules\Native\ModuleData\weapon_descriptions.xml

官方文档

WEAPON SMITHING & CRAFTING PIECES

用途

• 锻造武器所有存在的用法。比如，骑枪冲刺用法、架矛用法。
• 或者更常见的是“单手”“双手”，其实在文件里会细分成很多种。
• 比如，两只手共同握持长杆武器的用法，游戏中也叫“双手”。
• 所有锻造武器用法具备的所有行动。例如格挡、持盾防具、单手持武器、挥动攻击、戳捅攻击等。
• 支持该用法的所有武器配件。
• 被CraftingTemplates武器锻造类别读取使用。
• 详见CraftingTemplates武器锻造类别页面

附一把锻造武器物品的逻辑图：

特点

• 建议直接复制粘贴骑砍2自己的数据，并在此基础上添加自己的配件。这样可以避免产生问题。
• 武器用法必须和武器锻造类别里的内容相匹配，包括武器用法的ID和锻造类别中读取的用法ID，锻造类别中的可用配件也要在相对应的用法中登记等。
• 如果一个配件具备特殊的情况，例如：
  • 禁止这个配件造出来的武器去作“戳捅”动作。
  • 禁止这个配件造出来的武器佩戴盾牌使用。
  • 其他在用法登记上不容易归纳的情况。
• 就需要在武器配件的xml文件中进行修改。详见CraftingPieces武器配件页面。

格式示范

  <WeaponDescription id="Javelin"
                     weapon_class="Javelin"
                     item_usage_features="throwing:javelin"
                     rotated_in_hand="true"
                     use_center_of_mass_as_hand_base="true">
    <WeaponFlags>
      <WeaponFlag value="RangedWeapon"/>
      <WeaponFlag value="Consumable"/>
      <WeaponFlag value="AmmoSticksWhenShot"/>
      <WeaponFlag value="UseHandAsThrowBase"/>
      <WeaponFlag value="AutoReload"/>
      <WeaponFlag value="UnloadWhenSheathed"/>
    </WeaponFlags>
    <AvailablePieces>
     <AvailablePiece id="spear_blade_1"/>
     <AvailablePiece id="spear_blade_9"/>
     <AvailablePiece id="spear_blade_10"/>
     <AvailablePiece id="spear_blade_41"/>
    </AvailablePieces>
  </WeaponDescription>

元素说明

• id

  • 该锻造武器用法的ID。
  • 特殊的，此处的ID使用大驼峰，所有单词首字母大写，无下划线。
  • 不可空。

• weapon_class

  • 武器组别。
  • 比较特殊的一种分类方法，只有装备到身上的武器有“武器组别”。
  • 建议直接复制骑砍2自己的参数。不需要做任何修改。
  • 猜测是用于角色特长效果。例如“挡箭术”特长对双手剑生效。
  • 存在的组别：
    • OneHandedSword 单手剑
    • Dagger 匕首
    • ThrowingKnife 飞刀
    • OneHandedAxe 单手斧
    • TwoHandedAxe 双手斧
    • ThrowingAxe 飞斧
    • OneHandedPolearm 一只手握持的长杆
    • TwoHandedPolearm 双手握持的长杆
    • Javelin 标枪
    • Mace 单手锤
    • TwoHandedMace 双手锤
    • Crossbow 弩
    • Bolt 弩矢
    • LargeShield 大盾
    • Bow 弓
    • Arrow 箭
    • Boulder 大石头
    • Stone 小石子
    • Banner 旗帜

• item_usage_features

  • 物品的可用方法和特性。
  • 建议直接复制骑砍2自己的参数。不需要做任何修改。
  • 具体内容可见"item_usage_sets.xml"文件。
  • 用于定义该用法具备的所有功能，比如是否能做出挥动动作的攻击，能否格挡，能放佩戴盾牌，能否做骑枪冲刺等。
  • 出现的有：
    • onehanded 一只手拿
    • twohanded 两只手拿
    • onehanded_polearm 一只手拿的长杆
    • polearm 长杆，可能是两只手持握的长杆
    • long 未知，一般出现在长杆用法上
    • block 猜测格挡
    • shield 猜测是手持盾牌
    • swing 作出挥动动作的攻击
    • thrust 作出戳捅动作的攻击
    • rshield 未知，跟盾牌有关，只用在手办武器切换用法上
    • throwing 投掷
    • javelin 标枪
    • thrown 长杆类武器里的的投掷
    • knife 小刀？
    • axe 斧
    • widegrip 宽握，应该跟动作有关系
    • couch 骑枪冲刺
    • pike 只出现在原版的“枪”锻造类别中，猜测是不能骑马的用途
    • bracing 架矛
    • tipdraw 未知，只有单手锤用。猜测：tip轻触；draw抽出（尤指武器）

• rotated_in_hand

  • 在手中时武器模型旋转。
  • 建议直接复制骑砍2自己的参数。不需要做任何修改。
  • 填写"true"。
  • 可空，默认为false。
  • 只在投掷类武器的投掷用法和长杆类武器的投掷用法中使用。

• use_center_of_mass_as_hand_base

  • 未知。
  • 建议直接复制骑砍2自己的参数。不需要做任何修改。
  • 填写"true"。
  • 可空，默认为false。
  • 只在投掷类武器的投掷用法和长杆类武器的投掷用法中使用。

• WeaponFlags

  • 用法的标记。
  • 建议直接复制骑砍2自己的参数。不需要做任何修改。
  • 格式：

    <WeaponFlags>
      <WeaponFlag value="RangedWeapon"/>
      <WeaponFlag value="Consumable"/>
      <WeaponFlag value="AmmoSticksWhenShot"/>
      <WeaponFlag value="UseHandAsThrowBase"/>
      <WeaponFlag value="AutoReload"/>
      <WeaponFlag value="UnloadWhenSheathed"/>
    </WeaponFlags>

• 出现的有：

  • MeleeWeapon 近战武器
  • NotUsableWithOneHand 不能一只手持握
  • RangedWeapon 远程武器
  • Consumable 消耗品，猜测是有个数的
  • AmmoSticksWhenShot 猜测是存在弹药命中时模型插在身上的视觉效果
  • UseHandAsThrowBase 猜测是切换至该武器时以投掷状态为默认状态
  • AutoReload 自动装填
  • UnloadWhenSheathed 未知，可能是举盾时卸下该武器；也可能是举盾防御时不装填。
  • BonusAgainstShield 对盾加成
  • TwoHandIdleOnMount 骑乘时
  • WideGrip 宽握，只用在长杆上，猜测是跟可以停马有关系

• AvailablePieces

  • 可用的武器配件。
  • 锻造武器的所有配件均在该用法中登记，则该武器存在这个用法。
  • 格式：

    <AvailablePieces>
      <AvailablePiece id="empire_blade_1"/>
      <AvailablePiece id="empire_noble_blade_1"/>
      <AvailablePiece id="empire_noble_blade_2"/>
    </AvailablePieces>