跳至主要內容

武器系统

YWZJ2026/1/25大约 4 分钟

武器系统

YWZJ实现了一个基础的武器系统，其关联于一个武器单元进行运作

武器配置文件

一个武器配置文件对应一个独立武器，其存放于data/tutorial/weapons/

提示

武器配置文件名即是武器的唯一id，如data/tutorial/weapons/qjt_5.8mm.json例中，qjt_5.8mm就是武器在注册时的唯一id，是所有与它关联的数据的主键，如载具配置中weapons内的id参数

武器的模板

与载具模板类似，武器也有模板概念，即武器模板，目前官方已实现了枪炮、榴弹、火箭、航弹、导弹、热诱弹武器模板，附属作者也可效仿追加新的武器模板类型

武器配置的type参数填写不同的枚举值以启用不同的武器模板

{
  "type": "ywzj_vehicle:cannon", # 武器模板
  "name": "QJT 5.8mm",
  ...
}

武器的配置

不同类型的武器体现于不同的武器模板，具备不同的配置

本文示例为data/tutorial/weapons/qjt_5.8mm.json

{
  "type": "ywzj_vehicle:cannon", # 枪炮类型
  "name": "QJT 5.8mm", # 武器名，可以是lang key
  "caliber": 7.62, # 口径 影响曳光大小
  "tracer_r": 0.7, # 曳光颜色 红
  "tracer_g": 0.5, # 曳光颜色 绿
  "tracer_b": 0.1, # 曳光颜色 蓝
  "damage": 8,
  "velocity": 16,
  "headshot_multiplier": 1.5,
  "shoot_interval": 80, # 自动射击时的间隔
  "max_capacity": 120, # 弹容量
  "reload": {
    "time": 100, # 装弹时间
    "ammo": "ywzj_vehicle:ammo_machine_gun" # 使用的弹药物品
  }
}

武器的资产配置与载具类似。武器一般具有音效，而大型弹射物一般具有模型（如导弹）

示例为assets/tutorial/display/weapons/qjt_5.8mm.json中配置了音效

{
  "type": "ywzj_vehicle:weapon",
  "sounds": {
    "fire": "ywzj_vehicle:gun_7.62mm_shot",
    "reload": "ywzj_vehicle:gun_reload"
  }
}

一个PL-8的导弹资产配置，额外配置了模型贴图

{
  "type": "ywzj_vehicle:weapon",
  "model": "ywzj_vehicle:entity/missile_pl_8",
  "texture": "ywzj_vehicle:textures/entity/j8.png",
  "sounds": {
    "fire": "ywzj_vehicle:missile_launch",
    "reload": "ywzj_vehicle:common_reload"
  }
}

武器单元

所有武器都需关联于一个武器单元的载具部件进行运作，一个武器单元可具备多个武器，一个武器只能与一个武器单元关联

主炮塔具有多个武器，每个武器都有自己的部件与结构

{
  "type": "ywzj_vehicle:tracked_vehicle",
  ...
  "parts": [
    {
      "id": "turret",
      "name": "turret",
      "type": "ywzj_vehicle:weapon", # 属于武器单元
      "structure_bone": "turret",
      ...
      "weapons": [
        "tutorial:cannon_125mm", # 主炮 关联于主炮塔部件，即本身
        {
          "id": "tutorial:qjt_5.8mm", # 同轴机枪
          "part_unit_id": "turret_machine_gun" # 关联于同轴机枪部件的id
        },
        {
          "id": "ywzj_vehicle:launcher_smoke_grenade", # 烟雾弹
          "part_unit_id": "turret_smoke_grenade" # 关联于烟雾弹部件的id
        }
      ]
    },
    {
      "id": "turret_machine_gun", # 同轴机枪部件
      "name": "turret_machine_gun",
      "type": "ywzj_vehicle:weapon", # 属于武器单元
      "structure_bone": "turret_machine_gun",
      "is_seat": false,
      "base": "turret",
      "rot_info": {
        "x_rot_speed": 1.5,
        "y_rot_speed": 0, # 同轴机枪自己不能水平转
        "x_rot_max": 5,
        "x_rot_min": -13
      }
    },
    {
      "id": "turret_smoke_grenade", # 烟雾弹部件
      "name": "turret_smoke_grenade",
      "type": "ywzj_vehicle:weapon", # 属于武器单元
      "structure_bone": "turret_smoke_grenade",
      "is_seat": false,
      "base": "turret",
      "rot_info": {
        "x_rot_speed": 0, # 烟雾弹只有固定角度，不能旋转
        "y_rot_speed": 0
      }
    },
...

弹药发射位置

一般来说，武器都会有炮闩与炮口的概念，炮弹会以炮闩指向炮口为方向，在炮口末端射出

在结构模型篇的分组与枢轴中，我们提过武器单元有2个组，其中约定名为部件名的组是座圈组，名为部件名_barrel的组属于炮管组

而YWZJ会从炮管组中自动解析炮闩与炮口位置，在部件名_barrel中的每一个块都会被视作一个炮管，以其Z轴正方向上的末端为炮口，负方向上的末端为炮闩

CS/SA5的导弹有两个发射架，所以导弹的炮管组有两个块

提示

虽然武器单元规定有2个组，但CS/SA5的例子中，导弹发射架只有炮管组turret_missile_barrel，而没有座圈组turret_missile，这是考虑配置便捷性，没有座圈概念的武器单元可以省略座圈组的配置

武器单元的自带旋转

在资产准备篇的模型注意事项中，我们强调了部件三轴旋转都为0时，朝向Z轴正方向，因为我们约定在没有任何车体、部件旋转时，它们的朝向都是Z轴正方向

在武器不指向载具正方向的场景，其需要在结构模型的座圈组与炮管组设置自带旋转，其中座圈组设置Y轴自带旋转，炮管组设置X轴自带旋转

AC-130的侧方航炮在结构模型的座圈组中有90度的自带旋转

考虑了自带旋转的AC-130侧方航炮的武器配置

...
    {
      "id": "105mm_cannon",
      "name": "105mm_cannon",
      "type": "ywzj_vehicle:weapon",
      "structure_bone": "gun2",
      "optical_sight_type": "crt",
      "crosshair_style": "circle",
      "seat_offset": [0, 3, 5],
      "optical_sight_offset": [-0.5, 0.1, 1.2],
      "operator_on_weapon_unit": false,
      "rot_info": {
        "x_rot_speed": 8,
        "y_rot_speed": 8,
        "x_rot_min": -15,
        "x_rot_max": 20,
        "y_rot_min": -105, # -90 - 15 注意基岩模型与载具对Y轴旋转方向的约定相反
        "y_rot_max": -75   # -90 + 15
      },
      "weapons": [
        "dragonrise_reforge_ywzj:cannon_105mm"
      ]
    },
...
Copyright © 2026 YWZJ