Dynamic Music Reneoforged - custom songs
========================================

Drop .ogg files (Ogg Vorbis) into this folder and restart the game. Each new file
is auto-registered in config/dynmus/music.json with a default entry that plays as
general overworld music. Edit that entry to control WHEN your song plays:

  "contexts": {
    "dimension":   "minecraft:overworld"  | "minecraft:the_end" | any dimension id | "any"
    "cave":        "any" | "none" | "cave" | "shallow" | "mid" | "deep"
    "time":        "any" | "day" | "night"
    "weather":     "any" | "clear" | "rain" | "thunder"
    "temperature": "any" | "cold" | "temperate" | "hot"
    "submerged":   true | false   (omit for: does not matter)
    "gamemode":    "any" | "survival" | "creative"
  },
  "weight": 1   (higher = plays more often when several songs match)

Entries that name MORE specific conditions win over broader ones when both match.
Songs play through Minecraft's normal music system, so the Music volume slider,
jukebox suppression and music-delay mods all apply.

Note: music a dimension supplies itself - another mod's tracks OR vanilla's
biome-specific music (Nether/End/lush caves etc.) - is never overridden, except
when your entry explicitly names that dimension id (or you set that dimension's
"overrideDimensionMusic": true, see below).

Modded dimensions work automatically: a dimension with no music of its own
borrows a pool - nether-like dimensions borrow the Nether pool, end-like the End
pool, everything else the pool set by settings.defaultDimensionFallback
(default: overworld). Cave depth, time, weather etc. still apply there, so
borrowed pools stay context-aware. Adding any entry that names the dimension
replaces the borrowed pool entirely.

Per-dimension rules in music.json:

  "dimensions": {
    "somemod:some_dimension": {
      "enabled": true,                 false = dynmus never touches this dimension
      "fallback": "",                  pool to borrow: "" = automatic,
                                       "none" = never borrow, or a dimension id
      "overrideDimensionMusic": false  true = dynmus songs may replace even music
                                       this dimension supplies itself
    }
  }
