Modhold
7 Days to Die
Freev1.0.5b-RC1

Context Music Manager (CMM) for 3.4.0 b10 - 2.6 b12 - A20 - A21

Live hot-swap music tracks - selectively replace 7 Days vanilla music for various contexts. Supports: MP3 OGG OGA OPUS FLAC WAV AIF AIFF AAC M4A MP4 M4V MOV 3GP MKV WEBM

Velasha3 @Velasha
0Unique downloads
0Downloads
6Views
0Vouches
–no scores yetScore
Context Music Manager

No music on Windows 11? Smart App Control may be blocking it

If the mod loads but no music plays, open your game's log (%APPDATA%\7DaysToDie\logs on current versions, or the game's 7DaysToDie_Data folder on A20/A21) and look for this line:
LoadLibrary(CMM_Decoder.dll) failed (Win32 error 4551)
If it's there, Windows 11's Smart App Control is blocking the mod's audio decoder (CMM_Decoder.dll). Smart App Control blocks program files that aren't signed with a code-signing certificate. The file hasn't been flagged as a virus; it just isn't signed. Windows can switch Smart App Control on by itself, which is why the mod can suddenly stop working after it worked fine before.

To turn Smart App Control off:
  1. Open Windows Security (Start menu, type "Windows Security").
  2. Go to App & browser control.
  3. Click Smart App Control settings.
  4. Select Off and confirm.
  5. Restart 7 Days to Die.

Before you decide:
  • Smart App Control is an extra layer of protection. Turning it off does not turn off Microsoft Defender Antivirus, which keeps scanning files as normal.
  • Can I turn it back on later? On Windows 11 with the April 2026 update or newer, yes. Just switch it back to On on the same page (the mod's music will be blocked again while it's on). On older Windows 11 builds, turning it off is permanent unless you reset Windows. If the switch is greyed out when you try to turn it back on, your Windows build doesn't support re-enabling it yet.
  • Windows 10 doesn't have Smart App Control and isn't affected.
Your own music, chosen by what you're doing. CMM watches your situation — fighting, driving, swimming, standing in a trader after dark, hiding in an infested POI — and plays from the matching folder. Drop files in, they play. Nothing to restart, no playlists to build, no menus.

Alpha 20.7, Alpha 21.2 and 2.6 have not been thoroughly tested
V1.0.6 is on hold. If 7 Days to Die is updated and the mod stops working, I will post a fix immediately. I'm working on another project that is consuming all my time.

V1.0.6 All hands on "Deck" (on hold)
  • Linux support. The native audio engine currently ships as a Windows library, which is the only thing keeping the mod on Windows; a Linux build is the plan for 1.0.6
  • Add a new context from inside the game. Pick the conditions - a storm, a biome, enemies nearby, a POI tier, one specific POI, day, night, horde night - point it at a folder, and it plays. No XML, no Lua.
  • A settings panel with everything in one place: every setting, every context, and when each one should play.
  • Unions: contexts can share folders, so a general pool stays in circulation alongside the specific one instead of being shadowed by it.
  • Music packs can ship their own settings and the mod adapts to them, so a pack arrives sounding the way its author intended. Applies only when exactly one installed pack brings its own.
  • A volume control on every speaker, so one radio can sit under another instead of all of them competing.
  • Left, right or mono on every speaker, so you can build a real stereo field anywhere you happen to be.
  • Pick a speaker back up and put it somewhere else.
  • A cap on how many random radios play at once in the world in case you only have a few radio stations (right now, if you have one station, they'll all play the same thing. None will be silent)

Music Packs

Don't have a soundtrack ready? Start with one of these.A music pack can be its own mod. CMM reads music from your MusicPath folder and the Music folder of every installed mod, so a pack installs like any other mod, survives updating CMM, and works with MO2/Vortex/Wabbajack. The cmm roots console command shows which folders are in use and which mod each came from.

If you put your own pack together — your own composition, or royalty-free and AI-generated content you're legally able to distribute — I'll link to it here.
Requirements
  • EAC must be OFF
  • 7 Days to Die 3.4.0 b10 - 2.6 b12 - A21.2 b37 - A20.7 b1 (one build runs on all of them)
  • Windows. The native audio engine ships as a Windows library; Linux support is planned for 1.0.6

Keybinds (defaults)
  • Alt+Num7 - Now Playing overlay
  • Alt+Num8 - Coverage panel: which contexts have music, how many tracks, and what plays when they're empty. Radio stations are listed individually, so an empty station shows as dead air. It reads from disk live, so adding or moving music updates it within a second — even on the main menu
  • Alt+Num9 - Context status / debug HUD
  • Alt+Page Up / Page Down - Switch stations on your carried radio (Off → station → station → Off)
  • Your normal Activate key (E by default) - Tune a speaker you're looking at. Hold it for the station wheel, tap it to switch that speaker off. See Tuning a speaker below
  • Alt+Home - Cycle combat music: combat + tension off → combat off → both on (tension is combat music that hasn't started yet)
  • Alt+Insert - Favourite the current track — it plays more often, roughly once an hour in a 50+ track folder
  • Alt+Delete - Ban the current track in the current context (never plays there again)
  • Alt+End - Unban the last banned track
  • Alt+Left / Right - Previous / next track in the current context
  • Alt+Up / Down - Adjust the saved volume trim for the playing track
Both debug panels show their own keybinds, and follow yours if you rebind them.
Getting your music in
  • Drop files into the folder for the situation you want them in — see the folder map below. You don't have to fill every folder; empty ones fall back automatically, so ambient and combat alone are a perfectly good start
  • No restart needed — add, remove or replace files while the game runs and CMM picks them up within seconds, even the track currently playing
  • Radio stations are subfolders of Music/radio/ — the folder name is the station name. Alt+PgUp / Alt+PgDn dials through them, and any speaker block in the world plays them too
  • Your music can live anywhere — set MusicPath in Config/settings.xml to any folder, even on another drive
  • Not sure whether CMM sees a folder? Open the coverage panel with Alt+Num8 — it lists every context, its track count, and what it's falling back to
Folder Map
Music/
├── ambient/      Exploration default (lowest priority)
│  ├── _night/      Night-only exploration tracks (generic)
│  ├── forest/      Pine forest (day + everyday)
│  │  └── _night/      Forest, night only
│  ├── burnt_forest/
│  │  └── _night/
│  ├── desert/
│  │  └── _night/
│  ├── snow/
│  │  └── _night/
│  └── wasteland/
│      └── _night/
│
├── radio/      Stations for the personal radio AND world speakers
│  ├── <station name>/      One subfolder per station - the folder name IS the name
│  └── <station name>/
│
├── home/      Near your bedroll / land claim
│  └── night/      Home base, night only
│
├── poi/      Inside a cleared / non-infested POI
│  ├── t0/  t1/  t2/  t3/  t4/  t5/  By POI difficulty tier
│  └── infested/      Inside a POI with live sleepers
│      └── t0/ t1/ t2/ t3/ t4/ t5/  By POI difficulty tier
│
├── trader/      Inside any open trader
│  ├── joel/  jen/  rekt/  bob/  hugh/  Per-trader themes
│
├── vehicle/      Riding any vehicle
│  ├── gyrocopter/  bicycle/  minibike/  motorcycle/  4x4/
│
├── swimming/      Deep enough to swim
│
├── tension/      Enemies alert & nearby, not yet fighting
│
├── combat/      Combat — Low intensity (the combat root IS the Low tier)
│  ├── _high/      Combat — High intensity
│  ├── _boss/      Combat — Boss intensity
│  ├── blood_moon/      Combat during a Blood Moon night (no biome split)
│  ├── forest/      Pine forest — biome combat (Low)
│  │  ├── _high/      Forest — High
│  │  └── _boss/      Forest — Boss
│  ├── burnt_forest/      Burnt forest — biome combat (Low)
│  │  ├── _high/
│  │  └── _boss/
│  ├── desert/      Desert — biome combat (Low)
│  │  ├── _high/
│  │  └── _boss/
│  ├── snow/      Snow — biome combat (Low)
│  │  ├── _high/
│  │  └── _boss/
│  └── wasteland/      Wasteland — biome combat (Low)
│      ├── _high/
│      └── _boss/
│
├── events/
│  ├── death/      Plays once on death
│  ├── low_health/      Critically low HP during combat
│  ├── spawn/      Plays once on spawn
│  └── poi_cleared/      Sting when the last sleeper dies
│
└── menu/      Main menu (loops)

Highlights
  • Live hot-swapping — add, remove or replace music without restarting, even the track that's currently playing. CMM picks up changes in seconds. Just drop files in folders
  • Music in the world — radios and speaker blocks play positionally, occluded by walls and doors, with room reverb
  • Tune any speaker by hand — look at it, hold your Activate key, pick a station from the game's own wheel
  • Craft your own radios and speakers — single player, no schematic needed
  • A radio you carry — the same broadcast wherever you are, on every supported game version
  • Music packs as mods — install a soundtrack like any other mod
  • Squad-shared combat music — your music reacts to your whole team's fight, client-side only
  • Every track plays before any track repeats — a large soundtrack finally sounds large
  • Room to breathe (new, switched off by default) — a stretch of silence between tracks while you explore, instead of wall-to-wall music. Combat and events still play the moment they happen
  • Playlists — point a context at a .m3u/.m3u8 file instead of a folder
  • Smart resume — leave and return, the track picks up where it left off
  • Smooth crossfades everywhere — up to four tracks overlapping, no hard cuts
  • Loudness-matched — tracks from different albums and sources play at a consistent volume
  • Native streaming decoder — every format handled outside the game's frame loop, with almost no garbage-collection pressure, so big libraries don't cost you FPS
  • Plays nice with vanilla Dynamic Music, section by section, if you keep it enabled
  • Hot-reload config — tune volume, fades and priorities while playing

Using the radio

There are two radios: the one you carry, and the speakers in the world. Both play from the same place — the station folders in Music/radio/ — and both stay on the same broadcast, so a song you hear in a shop is at the same point in the same track as the one in your pocket.

1. Set up your stations

Make a subfolder inside Music/radio/ for each station. The folder name is the station name. That's the whole setup — no config file, no restart.
Music/radio/
├── Cathedral FM/
├── Dust Bowl Country/
└── Wasteland Pop/
2. The radio you carry

Alt+PgUp / Alt+PgDn dials through Off → station → station → Off. It works on every supported game version, including the alphas that have no speaker blocks at all.

Turning it on holds your place in whatever context music was playing, and turning it off drops you back exactly where you left it, however long you listened. While it's on, it owns the music layer — your normal soundtrack waits.

3. Tuning a speaker in the world

Look at a ham radio or a speaker and you'll get the game's normal prompt, telling you what it's playing:
( E ) Tune Radio (Dust Bowl Country)
  • HOLD your Activate key (E by default) — the game's own selection wheel opens
  • Move the mouse to a station and let go — that speaker retunes
  • TAP the key instead of holding — the speaker switches off. Tap again to switch it back to what it was playing
Each disc on the wheel shows a short form of the station name — Cathedral FM becomes CaFM, Dust Bowl Country becomes DBC — and the full name appears in the middle of the wheel as you move over it. If you have more stations than fit on one wheel, the ◀ and ▶ discs page through them, and the middle of the wheel tells you which page you're on.

A few things worth knowing:
  • Most radios you find are switched off. About 1 in 10 of the speakers that come with a POI is playing when you find it, so a building with fifteen speakers isn't fifteen radios at once. The rest stay dark until you tune them. It's decided per speaker, so the same ones are dark on every visit and for everyone in multiplayer. Change the share with WorldEmitterActiveByDefaultPercent in radio.xml (100 = all of them on)
  • Every radio remembers its own station, and keeps it until you change it — through save and reload. That means you can build a base inside a POI and set your own radio without disturbing the building's
  • Until you tune one, a building's speakers all agree. An untouched POI assigns one station to all of its speakers, so a shop sounds like one shop rather than five arguing ones
  • Three stations can play at once. Stand where four are audible and the nearest three win
  • Delete a station folder and the radios tuned to it say off air and go quiet — they don't pick something else. Put the folder back and they return to it
  • Changing your mind is per radio. To hand a speaker back to the automatic assignment, delete its line from Cache/emitters.xml
4. Building your own

Single player only. Both are craftable in your backpack from the start — no schematic, no perk:
  • Ham Radio — 2 Electrical Parts, 2 Mechanical Parts, 6 Scrap Polymers, 2 Duct Tape
  • Speaker — 2 Electrical Parts, 3 Scrap Polymers, 2 Wood, 1 Duct Tape
A radio you place starts switched off; tune it to bring it to life. In multiplayer these recipes are withdrawn automatically — on a client, on a dedicated server, and on a host the moment somebody joins. They come back when you're alone again. You can still tune any speaker you find in multiplayer; you just can't craft new ones.
Music in the world

In-game radio objects emit music from tracks stored in /Music/radio (or whichever path you define) as real positional, diegetic sound layered on top of your normal soundtrack — walk toward a speaker and it gets louder, pans across your ears, muffles behind walls, and picks up room reverb. A shared "station" keeps broadcasting even while you're out of range, so you rejoin mid-song when you come back.
  • Speaker character — the sound is squeezed into a small driver in a small box, with the boxy resonance a cheap cone actually has. Ham radios are voiced harder still. (Considering a DJ system like Fallout 3/4 — maybe in 1.0.6)
  • Doors matter — an open door is air and a closed one is solid, damaged doors leak sound, and sliding doors muffle gradually as they travel. Occlusion follows how much of the doorway is actually open, so a garage door and a closet door behave consistently, both leaves of a double door count, and tilted doors like the wood cellar hatch are measured properly. Standing in a doorway that has swung open sounds like standing in it, not behind it. (I'm not sure how this behaves for doors other players control.)
  • A real switch sound — power on, power off and the tuning dial each have their own click, synthesized fresh on every press so no two sound quite alike, with their own volume controls in radio.xml
  • Live tuning — the whole spatial feel (range, falloff, occlusion, reverb) is hot-tunable from radio.xml while the game runs
  • Volume — world speakers follow the game's Ambient slider rather than Music, with their own WorldEmitterVolume trim (default 0.5)

Squad-shared combat music (multiplayer)
  • Purely client-side — no server mod needed
  • Your combat music reacts to your whole squad, not just the enemies on you personally. When a nearby teammate is under attack you drop into combat music too, even if their zombies are well outside your own detection range
  • The music scales with the size of the fight: soloing a swarm and battling shoulder-to-shoulder with a full squad are different musical moments
  • Works for players joining a server, not just the host — combat is detected even though the enemy AI runs server-side
  • Fully configurable: how close a teammate must be to share their combat (default 30 units), and whether it counts only party members and friends or any nearby player
  • Single-player is completely unaffected

The audio engine

Nearly the entire audio pipeline lives outside the game's managed (C#/Unity) environment, in a purpose-built native C library. The music doesn't compete with the game for the main thread and isn't interrupted by garbage-collection pauses — the biggest source of stutters.
  • Decoding, mixing and output all run in the mod's own engine (CMM_Decoder.dll) on threads the mod owns, completely outside the frame loop. CMM doesn't use Unity's audio system at all
  • Crossfades don't get clobbered. The mixer holds up to four simultaneous voices, so a new track can start while three older ones finish fading naturally. Ambient → tension → combat in two seconds sounds like one continuous handoff instead of an abrupt cut. If transitions pile up past the limit it drops only the quietest voice, already nearly silent at the tail of its fade — the incoming track is never the one sacrificed
  • Every format decoded natively — ogg, opus, flac, mp3, wav, m4a/aac, Apple Lossless (ALAC), and the audio inside mp4/m4v/mov/mkv/webm containers
  • Per-track loudness normalization (EBU R128) — measured once per track and cached, with a manual per-track trim on a keybind
  • Music survives loading freezes — tracks keep playing, and even advance, while the game's main thread is frozen during world load
  • Device changes are handled — unplugging a headset or switching the default output no longer strands the music
  • Gapless — the next track is decoded in advance, and the silent padding encoders add to the start and end of AAC files (iTunes, qaac, FFmpeg) is trimmed instead of played
  • Background work — loudness scanning, pre-loading, folder and config watching — is fully off the game loop, and libraries of 100,000+ files scan without hitching
  • The game's Overall Volume slider is applied by hand, since CMM's audio leaves through its own output device and the master slider never reached it

Your config files are yours

settings.xml, radio.xml and contexts.xml are created on first run instead of shipping in the download, so an update never wipes what you set — it only appends what a new version actually added. When a version changes the layout of contexts.xml, it's upgraded in place with your values, comments and edits kept, and the original saved beside it as a backup.
The contexts (highest priority first)

Death (100) - plays once on death, then returns to the previous music. Interrupts everything.

POI Cleared (91) - a one-shot sting when you kill the last sleeper in a POI.

Low Health Panic (90) - fires when you're badly hurt (default 30%, configurable) and in combat.

Blood Moon Combat (71) - combat during a Blood Moon night; the highest combat priority, overriding normal combat tiers.

Vehicles (70 / base 69)
  • Gyrocopter, Bicycle, Minibike, Motorcycle, 4x4 each have their own music → fall back to the generic Vehicle track if their folder is empty
Biome Combat (62 / 61 / 60) - optional per-biome versions of each combat tier (Forest, Burnt Forest, Desert, Snow, Wasteland). Fighting in a biome that has its own combat music plays it instead of the matching generic tier below; an empty folder falls straight back to the generic tier. The biome locks in when the fight starts, so crossing a border mid-fight won't swap the track, and re-locks if you leave combat and re-engage somewhere new (the intensity tier still resumes where it left off). Blood Moon combat stays generic.

Combat - intensity is chosen by scoring the enemies targeting you. Three tiers, each falling back to the one below so missing folders degrade gracefully:
  • Combat Boss (52) → Combat High
  • Combat High (51) → Combat Low
  • Combat Low (50) → vanilla combat music if the game is "panicked," otherwise back to the stack
The combat/ root folder is itself the Low tier; _high and _boss subfolders hold the escalations, and each biome mirrors this under combat/<biome>/.

Spawn (45) - plays once when you spawn in.

Radio - the personal radio and the world speakers both broadcast from Music/radio/. While the personal radio is on it owns the music layer; world speakers play alongside your normal soundtrack.

Tension (30) - enemies stalking you and close by. Short stand-offs are ignored thanks to warmup (2 seconds), so a quick rush straight into a fight goes directly to combat.

Traders (26 / base 25)
  • Joel, Jen, Rekt, Bob, Hugh each get their own theme → fall back to the generic Trader track → which falls back to vanilla trader music (when the game's Dynamic Music is on)
Swimming (23) - plays while you're deep enough to swim; short dips are ignored thanks to warmup (5 seconds).

Points of Interest - two layers, each tiered T0–T5 by POI difficulty:
  • Infested POIs (22 → base 20) — plays while live sleepers remain. Each tier (T5…T1) falls back to POI_Infested, which falls back to the stack. T0 always falls back to the stack
  • Non-infested POIs (18 → base 16) — the ordinary tier for whichever POI you're in. It stays on the stack even while the place is infested, sitting underneath the infested tier, so if an infested folder is empty the music can land on the matching ordinary tier instead of dropping out of the POI layer entirely. Each tier falls back to the generic POI track (excludes T0)
Home base (15) - near your bedroll or land claim, and it keeps its music even when your base is inside a POI.
  • Home Night plays night-exclusive tracks → falls back to Home, your default base music
Ambient / Biome (12 → base 10) — your everyday exploration music, the lowest custom layer:
  • Each biome (Forest, Burnt Forest, Desert, Snow, Wasteland) has a day track and an optional _Night variant
  • A biome's night track → falls back to the generic Ambient Night → which falls back to Stack (the biome's day track if it exists)
  • A biome's day track → falls back to Ambient
  • Ambient → falls back to vanilla music (when Dynamic Music is on)
Menu (0) - loops in the main menu; falls back to vanilla menu music.

Sentinels (built-in, don't remove) — Silence and Vanilla are the two ultimate fallbacks: play nothing, or hand back to the game's own music.
How the music is chosen

CMM keeps a stack of everything currently true about your situation (in combat, in a desert, at night, near a trader…) and plays the highest-priority one that has music. Equal priorities never interrupt each other, so whatever is already playing keeps going until something genuinely more important happens.

If a context's folder is empty it doesn't go silent — it follows that context's fallback to the next-best choice. A few shared rules:
  • Warmup - some contexts must stay active for a few seconds before they take over, so a quick dip in water or a duck into a doorway doesn't interrupt your music
  • WarmGroup - a shared tag for contexts that hand off to each other, like a day/night pair. Members share one warmup timer so swapping between them stays seamless instead of briefly dropping to lower-priority music. Each context still keeps its own Warmup — set grouped members equal for the smoothest result. Used by Home and Home_Night, and by the infested / non-infested POI tiers
  • Reentry - combat and event music wait a few seconds after you leave them before they can fire again, preventing rapid flicker
  • Cooldown (new, switched off by default) - a stretch of silence between one track ending and the next one starting in the same context. Ambient, Home and POI music ship with 3 minutes of it; everything else plays back to back. The silence belongs to the context: combat, a stinger or walking into another biome still plays straight away, and when you come back you only wait out what's left. Next/Prev track ends it immediately. Turn it on with TrackCooldownsEnabled in settings.xml
  • Resume - most contexts pick up where they left off when you re-enter them; short events restart fresh
  • Stale - a context is only eligible to resume from its saved position until it times out. It can be disabled per context so a context never expires while inactive
  • Once - event stingers play to completion, then hand back to whatever was playing before
  • Fade length follows the context. Anything that comes and goes quickly — Tension, every Combat tier, POI_Infested and its tiers, the online-player contexts — fades in fast (1.2 s) so you actually hear it before it's gone. Music tied to where you are or what time it is keeps its slow fade
Attributes you can customize per context in contexts.xml:
  • Name - the context's ID
  • Source - its subfolder, or a .m3u/.m3u8 playlist file. A folder containing playlists also picks up their tracks alongside the loose files, with no duplicates, and edits to a playlist take effect within seconds — including on USB, network and other non-standard drives
  • Subfolders - if enabled, plays everything in the folder's subfolders too
  • Fallback - where it goes when it has no files: another context, the Stack, Vanilla, or Silence
  • FadeInTime - how long it takes to fade in when activated
  • Priority - its priority while on the stack
  • Loop - one track is chosen and repeats until the context goes stale (unused by default, but the option is there)
  • Reentry - seconds before the context can fire again after you leave it (called cool before 1.0.5b; the old name still loads)
  • Bypass - skips the reentry wait, for stingers and events
  • Cooldown - seconds of silence between tracks: 0 = none, -1 = use DefaultTrackCooldown from settings.xml
  • CooldownReset - whether leaving the context clears its silence, so coming back plays straight away. Home and Ambient ship with it off, so walking in and out of your base or across a biome border doesn't restart their music
  • CooldownYield - while the context is resting, music already playing underneath it carries on instead of being faded out. Home ships with it on: walk home during Home's silence and the biome music keeps going until Home's next track crossfades in
Settings in settings.xml worth mentioning:
  • VolumeModifier - how loud CMM tracks play relative to the game's music slider (0.0–1.0, default 0.5)
  • MusicPath - the music root. Relative or absolute, so your files can live outside the mod directory or on another drive
  • AddonMusicScanEnabled - whether music packs installed as separate mods are read
  • TrackNoRepeatMemory - how much of a folder must play before a track can repeat (-1 = the whole folder)
  • FavouriteWeight - how much more often a favourited track plays
  • TrackCooldownsEnabled / DefaultTrackCooldown - the master switch for silence between tracks (default off) and the length a context set to -1 uses (default 180 seconds). Both apply live
  • DisabledVanillaSections - turn off individual vanilla Dynamic Music sections (Exploration, Suspense, Combat, Bloodmoon, Trader) rather than all or nothing
  • EnemyDetectRange - max distance (game units) at which an enemy counts toward combat/tension
  • HomeDetectRange - distance (game units) from your bedroll or land claim that counts as "home"
  • PlayerHealthDangerThresholdPercent - health fraction (0.0–1.0) below which combat escalates to Low_Health_Panic
Settings in radio.xml — the radio and world-speaker half, split out so it doesn't bury the rest:
  • WorldEmitterEnabled / WorldEmitterVolume / WorldEmitterRange - world speakers on/off, their own volume trim (they follow the Ambient slider, not Music), and how far they carry
  • WorldEmitterActiveByDefaultPercent - how many of the radios that come with POIs are playing when you find them (default 10%); the rest start switched off until you tune them
  • WorldEmitterColorVoice / ColorDrive / ColorStatic - how much like a small cheap speaker they sound, with a separate set for ham radios
  • RadioClickOnVolume / RadioClickOffVolume / RadioClickDialVolume - how loud the power and dial clicks are (default 1.3, up to 4)
  • The rest of the acoustic model — occlusion, doors, reverb — and every knob of the station-change sound

FAQ & Troubleshooting

Q: Do I have to fill every folder?
No. Fill only the ones you care about — empty folders fall back automatically, and ultimately to the game's vanilla music. You can start with just ambient and combat.

Q: How do I set up radio stations?
Make a subfolder inside Music/radio/ for each station; the folder name is the station name. The personal radio (Alt+PgUp / Alt+PgDn) and any speaker block in the world both use them.

Q: How do I change what a speaker in the world is playing?
Look at it and hold your Activate key (E by default). The game's selection wheel opens with your stations on it — move to one and let go. A quick tap of the same key switches that speaker off instead, and tapping again switches it back on. Each speaker remembers its own station across saves.

Q: Why are most of the radios I find silent?
On purpose: only about 1 in 10 of the speakers that come with a POI is playing when you find it, so the map isn't wall-to-wall music. Hold your Activate key on a silent one and pick a station to switch it on. To have more of them playing, raise WorldEmitterActiveByDefaultPercent in radio.xml (100 = all of them).

Q: Which blocks can I tune?
Ham radios and the two electronics-shelf speakers. If a block is tunable you'll see Tune in the prompt when you look at it, along with whatever it's currently playing.

Q: My station names are shortened to four letters on the wheel.
That's deliberate — the wheel's discs are small. The full name shows in the middle of the wheel as you move over each one. Cathedral FM shows as CaFM, Dust Bowl Country as DBC, KPOP Top as KTop.

Q: How do I put a speaker back to its original station?
Delete that speaker's line from Cache/emitters.xml. Deleting the whole file resets every speaker in that save.

Q: A speaker went quiet and says "off air".
It's tuned to a station whose folder is no longer there — renamed, deleted, or on a drive that isn't plugged in. It deliberately doesn't pick a different station; put the folder back and it returns to it.

Q: Why can't I craft the radio or speaker?
The recipes are single-player only, and are withdrawn on a client, on a dedicated server, and on a host as soon as somebody joins. They come back when you're playing alone. You can still tune any speaker you find in multiplayer.

Q: Do I need speakers in the world to use the radio?
No. The personal radio works on every supported version, including the alphas that have no speaker blocks at all.

Q: Does the addon work on MacOS or Linux?
Not yet. The native audio engine currently ships as a Windows library, and Windows is the only tested and supported platform. Linux support is planned for 1.0.6.

Q: What audio formats are supported?
MP3, OGG (Vorbis), Opus, FLAC, WAV/AIFF, AAC and Apple Lossless (ALAC) — including .m4a / .mp4, and even the audio track of an MP4/MOV/MKV/WebM video.

Q: Can I really change music without restarting?
Yes. Add, remove or replace files while the game runs — CMM detects the change within a few seconds, even for the track currently playing.

Q: I added a file but nothing happened.
  • Make sure it's in the correct folder and a supported format
  • That situation may not be active yet (a blood_moon track only plays on horde night)
  • A higher-priority situation may be overriding it (combat beats ambient, and so on)
  • Corrupt files are auto-rejected — re-export the track if it won't play
  • If it's a music pack installed as its own mod, cmm roots will tell you whether CMM can see it
  • The coverage panel (Alt+Num8) shows exactly which contexts have music and which are falling back
Q: Multiple tracks in one folder — how are they picked?
Every track plays before any track repeats. Each context deals from a shuffled bag and reshuffles once it runs out. Favourites get extra turns and scale to the size of the folder; banned tracks are skipped. Next/Prev walk your play history in that context, like a music player, rather than rolling a fresh random track. You can switch to Sequential or pure Random in Config/settings.xml — only shuffled-bag has been thoroughly tested.

Q: The music never stops. Can I have some quiet between tracks?
Yes. Set TrackCooldownsEnabled to true in Config/settings.xml. Exploring, home and POI music then wait 3 minutes after a track ends before the next one starts, while combat and events still play the moment they happen. Change the length with DefaultTrackCooldown, or per context with cooldown in contexts.xml. It applies while the game runs.

Q: It's too loud / too quiet.
CMM follows your in-game Music volume slider, plus a VolumeModifier in Config/settings.xml (default 0.5, matching the game's normal music level). World speakers follow the Ambient slider instead, with their own WorldEmitterVolume trim (default 0.5). Save the file and the change loads immediately if the game is running. Individual tracks are loudness-matched automatically, and Alt+Up/Down saves a per-track trim on top.

Q: Does this replace the vanilla music entirely?
Only where you provide tracks. Empty folders hand off to vanilla Dynamic Music, so the two coexist — and you can disable individual vanilla sections rather than all of them.

Q: I left an area and came back — why did the music restart / not restart?
Tracks resume where you left off if you return quickly; after a context goes "stale" (configurable per context, and disableable) CMM picks a fresh track instead.

Q: Can I store my music outside the mod folder?
Yes — set MusicPath in Config/settings.xml to any folder, even on another drive. You can also install music as a separate mod entirely.

Q: Will updating CMM wipe my settings?
No. The config files are created on first run rather than shipped in the download, so an update only appends settings that are genuinely new and leaves your choices alone.

Q: Does it work with the game's Dynamic Music setting?
Yes. Some folders fall back to vanilla only when Dynamic Music is enabled, so your choice in the options menu is respected.

Q: Is the source code available?
Yes, under the MIT License: github.com/chris61701/ContextMusicManager.

Q: Was AI used to make this mod?
AI was used to help write this description page, and it amounts to ~80% of the mod's code.
Third-Party Libraries

This mod wouldn't be possible without the open-source libraries it's built on. Huge thanks to their authors:Audio is decoded and played by a small native library (CMM_Decoder.dll) bundled with the mod, which compiles in these components:
  • libopus / libopusfile (BSD) — Xiph.Org Foundation — Opus decoding. github.com/xiph/opusfile
  • libvorbis / libvorbisfile (BSD) — Xiph.Org Foundation — OGG Vorbis decoding. github.com/xiph/vorbis
  • libogg (BSD) — Xiph.Org Foundation — Ogg container framing used by Opus and Vorbis. github.com/xiph/ogg
  • dr_flac / dr_mp3 / dr_wav (public domain) — David Reid (mackron) — FLAC, MP3 and WAV/AIFF decoding. github.com/mackron/dr_libs
  • FFmpeg (LGPL 2.1 or later) — the FFmpeg developers — MP4 / M4A / MOV demuxing and AAC / ALAC decoding. ffmpeg.org
  • miniaudio (public domain) — David Reid (mackron) — cross-platform audio playback. github.com/mackron/miniaudio
Full license texts are included in THIRD_PARTY_NOTICES.txt inside the mod download. FFmpeg is linked in under the LGPL; the mod's full source and build scripts are on GitHub, so anyone can rebuild CMM_Decoder.dll against their own copy of FFmpeg.

Permissions

Patches and translations welcome. List this mod as a required mod on your page, link it and credit me.

Modhold needs you: authors wanted
Modhold is growing

Authors, we need you

Players are joining every day and they're looking for mods. Post yours on a site with written rules, fair moderation and free downloads for players. Nothing gets pulled for the tools you used.

11Joined today
873Joined all time