Tools+

📝 DEVLOG • Version 1.0.2.2

🔍 How it works in Singleplayer

You no longer need a dedicated server to create your own music discs. Minecraft's integrated server will handle everything directly inside your local world.

1. Initialization: On the first command execution, the mod automatically checks for and creates any missing folders (toolsplus/music_input/ and toolsplus/resourcepack/) in your launcher's root directory (.minecraft/ or your instance folder).

2. Processing: Drop your .mp4 file into toolsplus/music_input/<id>.mp4 and type /tools music <id> in the chat.

3. Conversion Magic: The mod calls ffmpeg/ffprobe to extract metadata tags (title, artist, album, duration), converts the audio to .ogg, and generates two packs on the fly:

   • Datapack: Registers the new song via the jukebox_song registry (with the correct duration).

   • Resourcepack: Generates sounds.json and compiles everything into a .zip archive.

4. Result: The mod automatically reloads datapacks (/reload) and gives you a vanilla music disc with a custom title and lore generated directly from the track's metadata.

⚠️ Prerequisite: ffmpeg must be installed on your PC and available in your system's PATH. For Linux (Fedora/RHEL): sudo dnf install ffmpeg.

🎵 To hear the audio: You need to manually move the generated toolsplus_music.zip archive from the toolsplus/resourcepack/ folder into your standard .minecraft/resourcepacks/ directory and enable it in the game settings.

🛠 CHANGELOG • v1.0.2.2+26.1.2

+ [Added]  * [Changed]  ~ [Fixed]  ! [Important]

• [+] MusicCommand.java — Added the new /tools music <id> command. Triggers the full pipeline: metadata reading -> conversion -> music disc generation.

• [+] FfmpegBridge.java — Core integration module. A safe wrapper for ffmpeg and ffprobe using ProcessBuilder.

• [+] MusicMetadata.java — New record class for clean storage of track tags: Title, Artist, Album, Duration.

• [+] MusicPackManager.java — Pack architect. Automatically creates the required directory structure if missing, generates the datapack layout, and zips the resourcepack.

• [*] EnchantCommand.java — Registered the new sub-command within the main dispatcher via MusicCommand.register(dispatcher).

• [~] LoreCommand.java — Code cleanup: removed a dead (unused) import of the Style class. The .withStyle() method is now called correctly without redundant dependencies.

• [!] Folder Auto-Creation — If music_input or resourcepack folders are missing, the mod will create them automatically on the first command run to prevent game crashes.

• [!] Environment Dependency — The mod checks for ffmpeg presence in the system. If the utility is missing, it will output a clear error message in chat instead of crashing the game.

📂 Singleplayer Paths:

• Vanilla Launcher: ~/.minecraft/toolsplus/music_input/

• Prism / MultiMC: instances/<instance_name>/.minecraft/toolsplus/music_input/