跳至主要內容

音效

大约 3 分钟

音效

本页介绍枪械音效配置的两种方式：display JSON 中指定音效路径，以及通过动画关键帧嵌入音效。

音效字段 sounds

可选，对象类型。以下为所有可用的音效键：

键说明默认行为
draw掏枪时播放—
put_away收枪时播放—
shoot本地客户端开火时播放，支持双声道—
shoot_3p其他生物开火时播放，仅单声道—
silence本地客户端安装消音器后开火时播放—
silence_3p其他生物安装消音器后开火时播放—
reload_empty膛内无子弹时空仓换弹时播放—
reload_tactical膛内有子弹时战术换弹时播放—
inspect膛内有子弹时检视时播放—
inspect_empty膛内无子弹时检视时播放—
dry_fire弹匣打空后扣动扳机有默认音效，可不写
fire_select切换快慢机时播放有默认音效，可不写
head_hit爆头音效反馈有默认音效，可不写
flesh_hit命中身体音效反馈有默认音效，可不写
kill击杀生物音效反馈有默认音效，可不写
melee_bayonet刺刀近战音效有默认音效，可不写
melee_push推击近战音效有默认音效，可不写
melee_stock枪托打击音效有默认音效，可不写
"sounds": {
  "draw": "tacz:ak47/ak47_draw",
  "put_away": "tacz:ak47/ak47_put_away",
  "shoot": "tacz:ak47/ak47_shoot",
  "shoot_3p": "tacz:ak47/ak47_shoot_3p",
  "silence": "tacz:ak47/ak47_silence",
  "silence_3p": "tacz:ak47/ak47_silence_3p",
  "reload_empty": "tacz:ak47/ak47_reload_empty",
  "reload_tactical": "tacz:ak47/ak47_reload_tactical",
  "inspect": "tacz:ak47/ak47_inspect",
  "inspect_empty": "tacz:ak47/ak47_inspect_empty",
  "dry_fire": "tacz:dry_fire",
  "fire_select": "tacz:fire_select",
  "head_hit": "tacz:head_hit",
  "flesh_hit": "tacz:flesh_hit",
  "kill": "tacz:kill",
  "melee_bayonet": "tacz:melee_bayonet/melee_bayonet_01",
  "melee_push": "tacz:melee_stock/melee_stock_01",
  "melee_stock": "tacz:melee_stock/melee_stock_02"
}

此例来自默认枪包 ak47_display.json。

  • 音效文件使用 .ogg 格式，在枪包根目录下的 sounds/ 中寻找。
  • shoot / silence 为本地玩家听到的音效（双声道，更丰富）；shoot_3p / silence_3p 为其他玩家听到的音效（单声道，性能更好）。
  • 标注「有默认音效」的键可以不填，模组会自动使用内置默认音效。

文件位置：{枪包根目录}/sounds/{命名空间}/（如 sounds/tacz/ak47/ak47_shoot.ogg）

文件结构

{枪包根目录}
└─ sounds
   └─ {命名空间}
      └─ ak47
         ├─ ak47_draw.ogg
         ├─ ak47_shoot.ogg
         ├─ ak47_shoot_3p.ogg
         └─ ...

提示

制作枪包时应尽可能复用已有音效。模组内置了大量通用音效（fire_select、dry_fire、kill 等），不写即可自动使用。你的枪包内只需添加枪械专属音效（如 shoot、reload_empty 等）。

进阶：动画音效

自 1.1.4 版本起，TACZ 支持将音效以关键帧形式嵌入动画文件中，逐步取代 reload_empty、reload_tactical、inspect、inspect_empty 等字段。

制作方法

  1. 在 BlockBench 中进入动画模式，打开模型对应的动画文件。
时间线
时间线
  1. 在时间线上点击 动画效果，此时出现「效果」分组。
音效关键帧
音效关键帧
  1. 在需要播放音效的时间点添加关键帧，编辑关键帧的路径。路径格式与 display JSON 一致：{命名空间}:{文件夹路径}/{文件名}。
音效路径
音效路径

警告

如果动画内存在没有任何路径的音效关键帧，可能导致游戏崩溃。

使用动画音效后，对应的 display JSON 音效键可以省略，由动画关键帧接管播放。默认枪包中大部分枪械已迁移至此方式。

另请参见

data - 音效 —— 枪声传播距离（最远/最近距离、静音衰减系数等）由 data 中的 fire_sound 控制。