[BTW Addon] Music Player

# BTW Music Player BTW Music Player is a dynamic music engine created as an addon for the Better Than Wolves Community Edition 3.0.0 mod for Minecraft 1.6.4. It replaces the standard, repetitive in-game music, allowing for custom tracks to be played based on the gameplay context. Players can create and install their own "Music Packs" containing music files and a songs.json file that defines when each track should be played. The mod features smooth transitions between songs and intelligently manages combat music, reacting to actions from both the player and monsters. ### Features - Full Music Customization: Replace the entire game's soundtrack with your own `.ogg` files. - Smart Playlist Logic: Tracks are shuffled globally at launch (like a deck of cards). The mod ensures every song for a specific context plays at least once before looping. The playback state is remembered even if you leave and return to an area, preventing repetitive music and ensuring you hear your entire library. - Smooth Transitions: Music gently fades in and out when the context changes, eliminating abrupt cuts. - Intelligent Combat System: Combat music is triggered not only when the player is attacked but also when they initiate a fight. The system sustains the combat theme as long as a threat is nearby. - Context-Aware Playback: Define music playback rules based on a wide range of conditions: - Dimension: Overworld, Nether, The End. - Time of Day: Day or night. - Biome: Any biome in the game (e.g., Forest, Desert, Taiga). - Weather: Clear skies or a storm. - Location: Play different music on the surface versus in caves. - Combat: Dedicated music for encounters with monsters, wolves, or squids. - Boss Battles: Unique tracks for fights against the Ender Dragon and the Wither. - Victory: A special theme plays after defeating a boss. - Menu Music: Define tracks to play in the Main Menu, World Selection screen, and options when outside of the game world. - Low Health Overlay: A heartbeat sound effect (or any other sound) plays simultaneously with the background music when the player's health drops to 5 hearts or below. - Smart Biome Logic: Biome variants (e.g., Forest Hills, Desert Hills) are automatically treated as their main biome, simplifying configuration. - Seamless Travel: Rivers and Beaches are considered "transparent". The music from the previous biome (e.g., Forest) continues to play while crossing a river, preventing constant music switching. - Advanced Validator: The mod checks if your .ogg files exist and are valid, reporting errors directly in the Music Pack selection menu. - Multi-Music Pack Support: Load tracks from a single, specific music pack or from all installed packs at once. - In-Game Configuration: Manage settings, select music packs, and open the music folder directly from the game options menu via a new gear icon. - Global Condition Toggles: Enable or disable specific conditions (e.g., disable all Biome music or Combat music) directly from the in-game configuration menu. - Diagnostics Commands: Use `/bmp debug` to view the current music state (biome, combat, song priority) in real-time, and `/bmp reload` to reload configuration and music packs without restarting the game. - Now Playing Notifications: A stylish pop-up appears on the right side of the screen when a new song starts, displaying the track title and the name of the Music Pack. - Custom Song Titles: You can now define a custom display title for each song in the `songs.json` file. ### Downloads - BTW Music Player Mod: **Click the green download buuton!** - Sample Music Pack (`RadogostMusicPack.zip`): (https://github.com/BardRadogost/BTW-Music-Player/releases/download/RadogostMusicPack_1.0.0/RadogostMusicPack.zip) - Source Code: (https://github.com/BardRadogost/BTW-Music-Player) ### Requirements - Better Than Wolves Community Edition 3.0.0 installed ### Mod Installation 1. Download the latest `.jar` file for the mod from the Downloads section. 2. Open your Minecraft directory. 3. In your `.minecraft` directory, find the `mods` folder. 4. Move the downloaded `btw-music-player-x.y.z.jar` file into the `mods` folder. 5. Launch the game. ### Music Pack Installation After successfully installing the mod, you can add any number of music packs to customize the in-game music. 1. Download a music pack (e.g., RadogostMusicPack.zip) from the Downloads section. 2. Navigate to your main Minecraft game directory (`.minecraft`). 3. In the `.minecraft` directory, find a folder named `musicpacks`. **If it does not exist, you must create it**. 4. Unzip the downloaded `.zip` archive. Inside, you will find a folder with the music pack's name (e.g., `RadogostMusicPack`). 5. **Important**: Move the **entire folder** (e.g., `RadogostMusicPack`) into the `musicpacks` directory. Do not copy individual `.ogg` files or the `songs.json` file directly. After restarting the game, the music packs will be loaded automat