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.

1. 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/

📝 DEVLOG (Дневник разработки) • Версия 1.0.2.2

🔍 Как это работает в одиночном мире

Теперь для создания своей пластинки не нужен выделенный сервер. Интегрированный сервер Minecraft сделает всё сам прямо внутри вашего мира.

1. Инициализация: При первом вызове команды мод автоматически проверяет и создаёт недостающие папки (toolsplus/music_input/ и toolsplus/resourcepack/) в корне твоего лаунчера (.minecraft/ или папки инстанса).
2. Обработка: Вы кидаете .mp4 файл в toolsplus/music_input/<id>.mp4 и пишешь в чат /tools music <id>.
3. Магия конвертации: Мод обращается к ffmpeg/ffprobe, вытягивает теги (название, артист, альбом, длительность), конвертирует звук в .ogg и генерирует на лету два пака:

• Datapack: Регистрирует новую песню через систему jukebox_song (с правильной длительностью).
• Resourcepack: Создаёт sounds.json и упаковывает всё в .zip.

1. Результат: Мод сам обновляет датапаки (/reload) и выдаёт тебе в руки ванильную пластинку, но с кастомным названием и лором из метаданных трека.

⚠️ Важное требование: На твоём ПК должен быть установлен ffmpeg и доступен в переменной окружения (PATH). Для Linux (Fedora/RHEL): sudo dnf install ffmpeg. 🎵 Чтобы услышать звук: Сгенерированный архив toolsplus_music.zip из папки toolsplus/resourcepack/ нужно вручную перекинуть в обычную папку .minecraft/resourcepacks/ и включить в настройках игры.

---

🛠 CHANGELOG (Список изменений) • v1.0.2.2+26.1.2

+ [Добавлено]  * [Изменено]  ~ [Исправлено]  ! [Внимание]

• [+] MusicCommand.java — Добавлена новая команда /tools music <id>. Запускает полный пайплайн: чтение метаданных -> конвертация -> создание пластинки.
• [+] FfmpegBridge.java — Ядро интеграции. Безопасная обёртка над ffmpeg и ffprobe через ProcessBuilder.
• [+] MusicMetadata.java — Новый класс-запись (record) для удобного хранения тегов трека: Title, Artist, Album, Duration.
• [+] MusicPackManager.java — Архитектор паков. Автоматически создаёт структуру папок, если их нет, генерирует структуру датапака и пакует ресурспак в .zip.
• [*] EnchantCommand.java — Проведена регистрация новой подкоманды в основном диспетчере (MusicCommand.register(dispatcher)).
• [~] LoreCommand.java — Очищен код: удалён мёртвый (неиспользуемый) импорт класса Style. Метод .withStyle() теперь вызывается корректно без лишних зависимостей.
• [!] Авто-создание папок — Если папки music_input или resourcepack отсутствуют, мод создаст их самостоятельно при первом запуске команды, предотвращая краш игры.
• [!] Зависимость окружения — Мод проверяет наличие ffmpeg в системе. Если утилита не найдена, в чат выведется понятная ошибка вместо падения игры.

---

📂 Пути для одиночной игры:

• Ванильный лаунчер: ~/.minecraft/toolsplus/music_input/
• Prism / MultiMC: instances/<имя_сборки>/.minecraft/toolsplus/music_input/