StateMusic - Change all the theme and BGM as you want

Description

State Music let you play your own song, chosen automatically by what you're doing. Everything switches on its own based on the game's real state (combat, the exact monster, the zone, your HP, quest outcome, and more), with smooth crossfades and seamless loops. All main features are listed below, and new feature can be requested in the comment section. 

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). [/]

  []Per-zone music : set a separate exploration and combat theme for each region but also title screen.[/]

  []Ambience by time of day & weather : combinable rules that pick music based on the in-game time (morning / daytime / evening / night) and weather, optionally tied to a specific zone.[/]

  []Camp / tent theme : your own music at a field camp or inside a tent (base camps and pop-up tents included). Villages and hubs keep their own zone music.[/]

  []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). There's a Mid-HP phase too.[/]

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

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

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

  []Playlists : assign a whole playlist to any state, with optional shuffle. A "Lock playlist per quest" option keeps the same random track for a whole quest, even if combat pauses and resumes (a new one is picked each new quest).[/]

  []Resume feature, to avoid having the song restarting from the beginning every change of state. [/]

  []Crossfade between tracks.[/]

  []Seamless looping : set loop points per file, with an optional "play the track once first, then loop a section" mode (like game music), plus a "Test loop" preview.[/]

  []Per-file volume leveling : even out songs recorded louder than others, with a "Test (8s)" preview so nothing jumpscares you. A single default volume sets every file at once, override just the odd ones.[/]

  []Non-ASCII file names supported — Japanese, Chinese, Korean, Cyrillic and accents all display, save and play correctly (the mod ships a font for this, just extract everything).[/]

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

  []Presets : save and reload named configurations.[/]

  []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, wav, ogg and flac.[/]

  []Auto mute the game's BGM when yours is playing, allowing to mix the game BGM and your own seamlessly. [/]

Requirements

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

  []The game's own BGM is 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.[/]

Priority: how a theme is chosen

Themes are checked from top to bottom. The first one that has a track assigned wins, and everything below it is skipped. An empty theme is passed over, so the next one down gets its turn.

Global order

[]Quest outcome (Complete / Failed / Abandoned)[/]

[]Monster slain (one-shot, plays once)[/]

[]Death (you faint)[/]

[]Low-HP (per-monster first, then global. Holds until death)[/]

[]Mid-HP (per-monster first, then global. Yields to chase)[/]

[]Chase (a monster is fleeing)[/]

[*]In combat? The check then splits into the two sta