BattleBeats | Dynamic Music System
BattleBeats is a modern, all-in-one music system for GMod
Built completely from scratch. It plays combat music during fights and ambient tracks while exploring. Designed to be dynamic, it adapts whether you want intense boss fight music or simply enjoy it as a standalone mp3 player. The goal is to provide an improved system compatible with most popular music addons
-> Nombat
-> SBM
-> 16th Note
-> Action Music
-> DYNAMO
-> MP3 Radio
- Full user interface – other major music addons either have a very basic UI or none at all. BattleBeats offers a full-featured interface with many configuration options for your packs. You can easily access it via context menu
- Playlist creation – you can create your own playlists using tracks from different packs, with full support for importing and exporting playlists
- Assigning NPCs to tracks – BattleBeats lets you easily assign multiple NPCs to a single track, basically allowing you to create your own game soundtrack. Others either lack this entirely or have it hardcoded
- QoL features – BattleBeats offers extensive audio customization, including master volume, separate ambient/combat volume and individual volume control for both packs and tracks. Tracks can also be trimmed with custom start and end points, favorited for quick access and renamed
- Support for PvP – most music bases don’t support this or only offer a bare-bones version. BattleBeats gives you wide customization options
- Highly customizable – BattleBeats includes over 40 options, all with a dedicated UI and clear descriptions
- Pack creation – BattleBeats has one of the easiest, if not the easiest pack creation systems out of all existing addons
You can find the full comparison table here
- PvP, PvE, and EvE support – each highly customizable
- Assign tracks to individual NPCs – when engaging them in combat, their designated theme will automatically play
- Compatible with most NPC bases including (VJ BASE and DRG BASE)
- User-friendly interface – every option comes with a clear description and tooltip
- Player-controlled experience – most features and settings work independently of the server you’re on
- Saves your preferences and excluded tracks
- In-game notification that shows current track name with animated visualizer bars
- Built-in UI for browsing, previewing, and managing packs
- Advanced settings for volume, notifications, track behavior and more
You can customize BattleBeats using the options UI in the pack selector
- Super easy pack creation – no Lua scripting required
- No need to match the number of ambient and combat tracks
- Track names can be actual song titles – no more confusing letter codes
- Full UI customization – change the look of your pack panel however you want
- You can add your own subtitles in .srt format
- You don’t even need to upload your pack to the Workshop! You can use it locally
Want to create your own pack? You can do it in under a minute
Click here to view the pack creation guide
or
Watch this pack creation tutorial video
Not sure where to start? Here are some packs you can try right away:
You can check out the full list here
The full code is open-source and available on this GitHub Repository[github.com]
Translations can be easily created by editing the included language files
Revisions:
Old revisions of this mod are available below. Click the link to download.

