StateMusic - Change all the theme as you want

Description

State Music let you play your own song while playing Monster Hunter Wilds, chosen automatically by what you're doing. It plays one track while you explore and another during combat — and you can even set different music for each region, for both exploration and fights. All main features are listed below !

Installation instructions

1. Install REFramework (required — see Requirements below).

2. Extract this mod into your game folder.

3. Put your audio files (mp3, wav, ogg, flac) into:

MonsterHunterWilds/reframework/data/StateMusic/4. Launch the game, open the REFramework menu and find State Music.

5. Pick your tracks from the dropdowns. If you add files while the game is running, click Refresh files.

Start with a LOW volume — the audio can be extremely loud at max.

Main features

• []Your own music by game state — a track for exploration, a track for combat, switched automatically.[/]

  []Per-monster battle themes — a dedicated track for the exact monster you're fighting, read straight from the game's own battle music (not an HP guess). You can also assign a theme to any monster in advance from a dropdown, no need to fight it first.[/]

  []Per-zone music — set a separate exploration and combat theme for each region (Windward Plains, Scarlet Forest, Oilwell Basin, and more).[/]

  []Monster low-HP theme — trigger your "Proof of a Hero" hype moment when the monster is nearly dead (15% by default, fully adjustable, I also like Haikyuu Direct Confrontation ost when the monster is low).[/]

  []Chase theme — plays when a monster flees.[/]

  []Death theme — plays when you faint.[/]

  []Quest outcome themes — separate tracks for Complete / Failed / Abandoned.[/]

  []Crossfade between tracks.[/]

  []Per-file volume leveling — even out songs recorded louder than others, with a "Test (8s)" preview so nothing jumpscares you.[/]

  []Alphabetical, name-filterable file lists everywhere — find a track instantly even with a huge library.[/]

  []Download from a link or a whole playlist — optional, via yt-dlp (see the V2 note below).[/]

  []Volume control — Ctrl+Click the slider to type an exact value.[/]

  []Works with mp3 (should also work with wav, ogg, flac but I haven't tried).[/]

  []Auto mute the game's BGM when yours is playing ![/]

• []REFramework for Monster Hunter Wilds.[/]

  []Lower the game's BGM in Options → Audio so it doesn't play over your music. I haven't found a way to mute the game automatically, but i'll keep trying a bit more to make it as good as possible.

  The game's own BGM is now muted automatically while your music plays (on by default, toggle in Settings & mixing). Your saved Options > Audio setting is never changed, you can put it back to the settings you want.[/]

It's getting pretty long, and i'm a bit too lazy to write all the details rn, i'll do it later if i don't forget

For upcoming patches just read the changelog tab

V6. 5 : FIx some bugs

Fixed loops playing until a "Reset scripts" was done — a looped track now starts from the actual beginning of the file.

Made loop reading dynamic: editing or removing a loop while it plays now updates instantly, no more Reset scripts after every change.

Loop end cannot be lower than loop start.

V6. 4 : Fix global Low HP and Mid HP theme not playing if the monster you are hunting is a monster that is in the dropdown of the per monster theme. Thx gintama for the report.

V6. 3: Some fix and grant some request

- Per-monster phase themes: each monster can now have its own Mid-HP and Low-HP theme on top of its combat theme, each with its own HP % threshold (falls back to the global one if left unset).

- Global Mid-HP theme: a new phase between the combat theme and the Low-HP one.

- Ogg Vorbis support: .ogg files now play.

- New "Resume tracks where they left off" toggle: turn it off to have the music restart from the beginning on every zone or monster change.

- Clearer error when the file list comes up empty: it now names the cause (a filename with a special character) and points to the batch tool on the mod page.