MusicPVPmod

🎵 Music PVP Mod — Battle Music for Minecraft

Turn every PVP encounter into an epic showdown! This mod brings dynamic battle music to Minecraft 1.21.11, creating an immersive combat experience with custom tracks, ambient playlists, and full control over your soundscape.

✨ Features

⚔️ Battle Music

· Automatically plays when you hit another player · Stops when combat ends (timeout or enemy death) · Smooth fade-in for natural volume transitions

🎧 Ambient Music

· Separate playlist for peaceful moments outside of battle · Can be toggled on/off independently · Perfect for exploring, building, or relaxing

💀 Kill Sound

· Plays a custom sound when you defeat an opponent · Supports multiple .mp3 files — random selection each time

🎛️ Full Control

· Separate volumes for battle and ambient music · Adjustable timeout — music stops after N seconds of no hits · Fade-in duration — customize smoothness (0–5 seconds)

🎶 Track Selection Modes

· Random — surprise yourself every time · Selected — pick your favorite track · Cycle — play through your playlist in order

📁 Preset System

· Each preset is a folder with battle/, idle/, and kill/ subfolders · Switch presets instantly to change your entire music collection · Create, select, and delete presets right from the in-game menu

🖥️ In-Game Menu

· Open with M key (rebindable in Controls settings) · Browse and preview tracks · Adjust all settings in real-time · Open music folders with one click

📦 Installation

Requirements

· Minecraft 1.21.11 · Fabric Loader 0.19.3 or higher · Fabric API 0.141.6 or higher · Java 21

Steps

1. Install Fabric Loader and Fabric API for Minecraft 1.21.11
2. Place musicpvpmod-1.0.0.jar in your mods folder
3. Launch the game

Note: Only .mp3 files are supported (decoding via JLayer, no additional installation required).

🎮 How to Use

Getting Started

1. Press M to open the mod menu
2. Add your .mp3 files to preset folders or fallback folders
3. Start a PVP fight — battle music plays automatically!

Music Folder Structure

Presets (recommended): musicpvp/presets/<preset-name>/

<preset>/
├── battle/   — PVP combat music
├── idle/     — Ambient background music
└── kill/     — Kill sound effects (random selection)

Create a preset: Mod menu → Presets… → enter name → Create preset Click any preset in the list to activate it.

Fallback folders (used when no preset is active):

musicpvp/
├── music/    — Battle music
├── idle/     — Ambient music
└── kill.mp3  — Kill sound (optional)

Mod Menu (M key)

Section What You Can Do Track List Click to preview a track Volume Adjust battle music volume Timeout Set seconds of no hits to stop music Fade-in Customize fade duration (0.0–5.0 s) Mode Switch between Random / Selected / Cycle Play / Stop Preview selected track or stop playback Open Folder Open the battle music folder Ambient Music… Configure ambient music settings (toggle, volume, mode, track list) Presets… Create, select, and delete presets

All settings are automatically saved to musicpvp/config.properties.

🎯 Why Choose Music PVP Mod?

· Immersive — transforms every battle into a cinematic experience · Customizable — use your own music, your own rules · Lightweight — no external players or dependencies · Preset-friendly — switch between different playlists for different moods · Intuitive — clean in-game menu with real-time controls

💬 Support

Found a bug or have a suggestion? Feel free to reach out! This mod is designed for players who want to personalize their Minecraft experience with epic soundtracks.

🎧 Ready to make every fight legendary? Install Music PVP Mod today!