1. 在游戏同级目录下创建 weapons/ 文件夹，并为每种武器新建子文件夹（如 weapons/paint/）。

2. 推荐使用透明背景的 PNG 或 WebP 图片，文件名随意，只需在清单中引用即可。

3. 在 weapons/manifest.json 中列出武器配置，mode 支持 hitscan（直射）或 lob（抛物线），例如：

[
  {
    "id": "cat",
    "label": "猫咪发射器",
    "mode": "hitscan",
    "power": 1,
    "recoil": 0.28,
    "preview": "weapons/cat/weapon.png",
    "previewImageScale": 0.78,
    "splat": "weapons/cat/impact.png",
    "splatImageScale": 1.18,
    "firingSound": "weapons/cat/cat_firing.mp3",
    "impactSound": "weapons/cat/cat_splat.mp3"
  },
  {
    "id": "paint",
    "label": "颜料炸弹",
    "mode": "lob",
    "power": 3,
    "preview": "weapons/paint/weapon.png",
    "previewImageScale": 0.9,
    "projectile": "weapons/paint/projectile.png",
    "projectileImageScale": 1.1,
    "splat": "weapons/paint/splat.png",
    "splatImageScale": 1.0,
    "impactSound": "weapons/paint/splat.mp3"
  }
]

4. 保存后刷新页面即可看到新的武器选项。可以继续添加对象扩充武器数量。

5. 抛掷类武器的弹体会沿抛物线逐渐缩小，起始大小会参照武器展示图，命中时接近 splat.png 的可视尺寸。直射武器可选填 projectile.png 来展示子弹轨迹，也可以省略。建议准备至少与展示图宽度 1.2 倍（约 220px 以上）的溅射图片，以便命中时覆盖更明显。可以使用 previewImageScale、projectileImageScale 与 splatImageScale 微调三张图片的渲染尺寸。

6. 使用 power 字段定义每次命中的“威力值”（填写正整数），默认是 1，表示一次只扣掉一个汉字（或拼写单位）。设置为 3 就能一次削掉 3 点耐久，适合“便便”一类的大范围武器。

7. 音效按阶段拆分：直射武器点击时播放 firingSound（未填写时会回退到 sfx/hit.mp3 保证有反馈），命中的 impactSound 只有在清单里指定时才会播放，缺省则保持安静；抛掷武器仍在落地时播放 impactSound。若未在清单中写明路径，程序会自动尝试同名文件，例如 weapons/<武器ID>/<武器ID>_firing.mp3 与 weapons/<武器ID>/<武器ID>_splat.mp3。

8. 直射武器可选填 recoil 数值来控制准星的后坐力幅度，数值越大抖动越明显。