Garry's Mod中sound.Play()无法播放自定义音效文件

API 探路者

2026-8-2

Garry's Mod自定义音效无法播放的解决办法

核心问题：路径错误

你的代码里音效路径写法不对，GMod加载自定义音效时，不需要包含addons/testaddon/sound/前缀，直接写相对于sound文件夹的路径即可。

比如你的文件实际位置是addons/testaddon/sound/testsound.wav，代码里应该写成：

local soundFile = "testsound.wav"

hook.Add("KeyPress", "myTestAddon", function(ply, key)
    if key == IN_JUMP then
        sound.Play(soundFile, ply:GetPos(), 75, 100, 1)
        print("Test")
    end
end)

其他排查项

确认文件结构：addon必须遵循addons/[你的插件名]/sound/[音效文件]的结构，不能嵌套多余层级，插件文件夹名尽量用纯英文小写，避免特殊字符。
客户端/服务器同步：sound.Play()在服务器端运行时，只有服务器能听到；要让所有玩家听到，建议改用ply:EmitSound()（自动同步给客户端），代码改成：
```
ply:EmitSound(soundFile, 75, 100, 1, CHAN_AUTO)
```
或者把播放逻辑放到客户端钩子（比如PlayerButtonDown）里。
验证音效文件参数：确保是16位深度的PCM编码WAV，或者标准Vorbis编码的OGG，用Audacity重新导出一次，采样率保持44100Hz即可。
检查插件加载状态：在游戏主菜单的“Addons”里确认你的testaddon处于启用状态。
查看控制台报错：按~打开控制台，跳跃时观察是否有音效加载失败的提示，比如Couldn't open sound file，能快速定位问题。