kaqvuMusic

kaqvuMusic

A professional and lightweight MP3 player mod for Minecraft Fabric 1.21.1+.

Manage and enjoy your music library directly in-game with real-time feedback.

🎵 Features

Music Control | Action Bar Progress | History Tracking | Looping

• High-Quality Playback: Smooth MP3 streaming with minimal performance impact.
• Dynamic Action Bar: Displays song name, progress time, and queue position in real-time.
• Customizable Looping: Play songs once, multiple times, or set it to infinity for endless loops.
• Playback History: Saves your last 3 played songs with timestamps and settings.
• Independent Volume: Adjust mod volume from 0% to 100% without affecting game master volume.
• Easy Management: Simple file system — just drop your MP3s into the config folder.

🚀 Getting Started

1. Install Requirements: Ensure you have Fabric Loader and Fabric API installed.
2. Mod Placement: Drop the kaqvumusic.jar into your .minecraft/mods directory.
3. Add Your Music:

• Launch the game once.
• Go to .minecraft/config/kaqvuMusic/.
• Drop your favorite .mp3 files there.

1. Enjoy: Use /kaqvumusic list and start playing!

💻 Commands

All commands are available via /kaqvumusic

| Command | Argument | Description |
| :— | :— | :— |
| help | – | Displays the command list and usage. |
| list | – | Shows all available MP3 files in your library. |
| history | – | Displays the 3 most recently played songs. |
| play | <file \| last> [count \| infinity] | Starts playing. Use last for the previous song. |
| pause | – | Pauses the current track. |
| resume | – | Resumes from where you left off. |
| stop | – | Completely stops playback. |
| volume | <0-100> | Adjusts the output volume. |

💬 Interface & Messages

📺 Action Bar (Real-time Feedback)

The status bar appears above your hotbar while music is playing:

§b§l♪ §fSong_Name.mp3 §8| §a1:24§7/§23:15 §8| §ekolejka §61/∞

• ♪ Icon: Indicates active playback.
• Progress: Current time vs. total duration.
• Queue: Displays how many repetitions are left.

💬 Chat Messages

The mod provides clean and colorful chat feedback for all actions:

• Library List: Categorized list of all your songs with bullet points.
• History View: Shows song name, playback mode, and the exact date/time it was started.
• Alerts: Instant feedback in the center of the screen (above action bar) for volume changes or status updates.

Developed by kaqvu