dayz-sound-systemlisted
Install: claude install-skill willy92wins/DayZ-Modding-Knowledge-Pack
# DayZ Sound System (Enforce Script + config)
Verified reference for mod audio. Citations are `path:line` against the vanilla 1.30.164289 scripts
(first verified on v1.24, re-checked on 2026-10-28 and 2026-11-09; a cite labelled 1.29 is the 1.29 line; ±3 drift) and two real mods used as prior art (IMPWMODPart2 weapons, DoorLockSystem). The full
deep-dive with every signature lives in `references/sonido-deep-dive.md` — load it for AbstractWave
events, DynamicMusicPlayer internals, or PlayerSoundManager handlers. 1.30 cites:
`references/dayz-1-30-sound.md`.
## The one rule that explains most bugs
**Audio is client-only.** `SEffectManager.Init()` runs only on clients (`3_game/effectmanager.c:507-521`)
and `Object.PlaySoundSet` is guarded by `if (g_Game && !g_Game.IsDedicatedServer())`
(`3_game/entities/object.c:1249`). Any `Play*` call on a dedicated server is a silent no-op.
To make a sound happen "from the server", you synchronize a state change and let each client play it:
the official vehicle for that is `StartItemSoundServer` (below), or your own SyncVar +
`OnVariablesSynchronized`.
(hasta 1.29 / still on `Object.PlaySoundSet` in 1.30: the guard is `object.c:1249` —
`if ( g_Game && !g_Game.IsDedicatedServer() )`.)
(desde 1.30: item/player sound **handlers** use `g_Game.IsHeadlessOrDedicatedServer()` so headless
clients are skipped too — `ItemSoundHandler.c:121`, `PlayerSoundManager.c:105`,
`DayZPlayerCfgSounds.c:335`. Proto: `Game.c:1132-1136`. `[EXACT]`: `references/day