|
|
**2023年2月11日**
|
|
|
**对应游戏版本v1.0.3** 皮蛋初版完成
|
|
|
|
|
|
# 根元素
|
|
|
<WeaponDescriptions>
|
|
|
|
|
|
# 类型名
|
|
|
```
|
|
|
<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](https://moddocs.bannerlord.com/asset-management/weapon_smithing/)
|
|
|
|
|
|
# 用途
|
|
|
- 锻造武器所有存在的用法。比如，骑枪冲刺用法、架矛用法。
|
|
|
- 或者更常见的是“单手”“双手”，其实在文件里会细分成很多种。
|
|
|
- 比如，两只手共同握持长杆武器的用法，游戏中也叫“双手”。
|
|
|
- 所有锻造武器用法具备的所有行动。例如格挡、持盾防具、单手持武器、挥动攻击、戳捅攻击等。
|
|
|
- 支持该用法的所有武器配件。
|
|
|
- 被CraftingTemplates武器锻造类别读取使用。
|
|
|
- 详见[CraftingTemplates武器锻造类别页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/91/CraftingTemplates%E6%AD%A6%E5%99%A8%E9%94%BB%E9%80%A0%E7%B1%BB%E5%88%AB)
|
|
|
|
|
|
附一把锻造武器物品的逻辑图：
|
|
|
|
|
|
|
|
|
# 特点
|
|
|
- 建议直接复制粘贴骑砍2自己的数据，并在此基础上添加自己的配件。这样可以避免产生问题。
|
|
|
- 武器用法必须和武器锻造类别里的内容相匹配，包括武器用法的ID和锻造类别中读取的用法ID，锻造类别中的可用配件也要在相对应的用法中登记等。
|
|
|
- 如果一个配件具备特殊的情况，例如：
|
|
|
- 禁止这个配件造出来的武器去作“戳捅”动作。
|
|
|
- 禁止这个配件造出来的武器佩戴盾牌使用。
|
|
|
- 其他在用法登记上不容易归纳的情况。
|
|
|
- 就需要在武器配件的xml文件中进行修改。详见[CraftingPieces武器配件页面](https://dev.azure.com/KnightOfTheArk/KnightOfTheArk/_wiki/wikis/KnightOfTheArk.wiki/58/CraftingPieces%E6%AD%A6%E5%99%A8%E9%85%8D%E4%BB%B6)。
|
|
|
|
|
|
# 格式示范
|
|
|
```
|
|
|
<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>
|
|
|
``` |