betterxSound
Installation
Drop in betterxSound and start it.
1. Install the resource
- Drop the
betterxSoundfiles into a resource folder namedxsound(replace your existing xSound folder if you have one). - Add it to your
server.cfg, or rely on a bracketed folder such as[standalone]:
ensure xsoundIf you are migrating from stock xSound, that is the whole process — see Migration.
2. Optional configuration
Everything works out of the box. To tune it, open config.lua:
config.idleDuiRecycleSec— seconds of silence before the audio browser is recycled.config.youtubePoolMax— max simultaneous YouTube players (pooled and reused).config.security— anti-abuse limits for the sound trigger events.
See Configuration for details.
3. Verify
Start the server and play a sound from any resource that uses xSound (for example a music boombox or a phone). No code changes are needed in those resources.
The YouTube IFrame API is the only remote dependency and is loaded from Google by design.
howler, jQuery and DOMPurify are bundled in html/lib/, so the resource works without a CDN.