DCME

[DCME] Dynamic Contextual Music Engine

DCME replaces Minecraft's vanilla music system with a fully dynamic, context-aware soundtrack. Music adapts in real time to what you're doing: exploring, fighting, caving, facing a boss, or watching the credits roll.

Important: Resource Pack Required

DCME is a music engine and does not include music tracks. You need a compatible resource pack to hear music in-game. Search for [DCME] on CurseForge or Modrinth to find community-made soundtracks.

If you create a music pack, add [DCME] to your project title so users can find it.

Contextual Music

The mod evaluates dozens of conditions every second and plays the right music for the moment:

Overworld - Day, night, dawn, and dusk each have their own soundtrack
Weather - Rain triggers a dedicated atmosphere
Underground - Caves and the Deep Dark get unique music
Dimensions - Nether and The End have distinct soundscapes
Combat (PVE) - Dynamic music kicks in when hostile mobs target you
Combat (PVP) - Music triggers for both attacker and victim, with team protection and configurable timeout
Bosses - Wither, Ender Dragon, and Elder Guardian each have dedicated boss themes
Screens - Main menu and credits have their own music

Smooth Transitions

3 transition modes - Crossfade (simultaneous fade), Gap (silence between tracks), or Hybrid (crossfade within same group, gap between groups)
Combat overlay - Base music fades to near-silence while combat plays, then resumes where it left off
Boss fights - Base music is released during long boss encounters to free resources
Dimension transitions - Audio state resets cleanly when entering portals
End-of-track fade - Tracks fade out gracefully near the end instead of stopping abruptly

PVP Combat Detection

DCME tracks player-vs-player combat server-side. When a player hits another player, both receive the PVP combat music signal.

Bidirectional - both players get combat music
Team protection - players on the same scoreboard team won't trigger PVP music against each other
Configurable timeout - music stays active for a configurable duration after the last hit (default: 5s)

Play Once (Smart Groups)

Contexts can finish their current track before transitioning, but only within the same group. Changing dimension or going from surface to underground always crossfades immediately.

Groups: overworld_surface, overworld_underground, nether, end, screen, combat, boss

Configuration

JSON config at config/dcme.json - master volume, fade durations, gap between tracks, combat radius, PVP timeout, team protection, per-context toggles, and more
In-game config screen via Mod Menu - toggle every context on/off, adjust PVP settings, and change transition modes without editing files
Per-context overrides - each context can define its own volume, fade times, and gap duration

100% Customizable via Resource Packs

Replace tracks - swap any OGG file via a resource pack
Add new contexts - create JSON files to define new music triggers
Override existing contexts - replace any default context with your own
Custom conditions - biome, dimension, time of day, weather, altitude, sky light, combat, boss, structure, season, advancement, and more

See the included example resource pack and datapack for a complete guide.

Config Folder Overrides

Drop context JSONs into config/dcme/contexts/ to override any context without a resource pack. Highest priority - overrides both defaults and resource packs.

Third-Party Music Blocking

DCME blocks other mods from playing their own music to prevent conflicts. Configurable per-namespace in config/dcme.json. Jukebox music is never blocked.

Context Priority System

Context Priority Layer Group Ender Dragon 100 Override boss Wither 95 Override boss Elder Guardian 90 Override boss Combat (Warden) 85 Override combat Combat (Generic) 80 Override combat Credits 70 Base screen Menu 60 Base screen Deep Dark 50 Base overworld_underground Underground 40 Base overworld_underground Rain 38 Base overworld_surface Dawn 22 Base overworld_surface Dusk 22 Base overworld_surface Night 20 Base overworld_surface Day / Nether / End 10 Base (varies)