Fox Nap

Что это такое?

FoxNap — это простой мод в стиле "Vanilla Plus" для добавления кастомных музыкальных пластинок в Minecraft.

• В отличие от того, чего можно добиться одними ресурспаками, музыкальные пластинки, добавленные через FoxNap, не перезаписывают ванильные пластинки.

• В отличие от похожих модов, FoxNap позволяет вам:

  • добавлять столько пластинок, сколько захотите — хоть много, хоть мало
  • добавлять любую музыку
  • использовать другую музыку, чем у других игроков на том же сервере
  • получить все пластинки в выживании через новую профессию жителя (утилиты для изменения таблиц лута криперов / сундуков с сокровищами запланированы)

FoxNap также добавляет кастомные музыкальные инструменты, на которых можно играть как на козьих рогах, давая вам творческую свободу для организации "живых выступлений".

Установка и настройка

Этот мод уже включает в себя семь новых музыкальных пластинок:

1. "Colors," by Tobu

2. Camille Saint-Saëns: "Danse Macabre," performed by Kevin MacLeod

• Четыре трека в исполнении PM Music из Lud and Schlatts Musical Emporium

  3. Richard Strauss: Theme from Also Sprach Zarathustra
  4. Peter Ilyich Tchaikovsky: Love Theme from Romeo & Juliet
  5. Antonio Vivaldi: "Winter" from The Four Seasons
  6. Richard Wagner: Flight of the Valkyries

7. Nikokai Rimsky-Korsakov: "Flight of the Bumblebee" from Tsar Saltan, performed by The US Army Band

все они распространяются по разрешительным лицензиям на условиях, указанных здесь (я распространяю их через этот репозиторий и мод под совместимой Creative Commons Attribution-ShareAlike 4.0 License).

Если этот встроенный плейлист звучит как раз для вас, и вы не хотите добавлять ничего другого, то поздравляю! Всё просто! Это мод для Fabric со сборками для 1.19+ и зависит только от Fabric API, так что просто скачайте подходящую сборку в папку mods вашего инстанса, запустите игру и найдите деревню.

Но если вам интересна кастомизация, читайте дальше:

Генератор ресурспаков

Если ручное конвертирование mp3 и правка JSON вручную — не ваше представление о весёлом времяпрепровождении, этот проект предлагает альтернативу в виде отдельного и портативного генератора ресурспаков.

Установка

1. Скачайте исполняемый файл со страницы релизов, подходящий вашей операционной системе и версии мода.
2. В зависимости от вашей операционной системы и настроек безопасности, возможно, придётся явно сделать генератор ресурспаков исполняемым (на *nix-системах это можно сделать из терминала, выполнив chmod u+x /path/to/FoxNapRPG, или зайдя в Свойства в большинстве файловых менеджеров).

Генерация ресурспаков и датапаков

Помести исполняемый файл генератора в пустую папку, затем перенеси туда всю музыку, которую хочешь превратить в пластинки. Количество треков не ограничено, и их не нужно заранее конвертировать в Ogg. Единственное требование — файлы должны декодироваться через ffmpeg.

Совет: если в твоих музыкальных файлах есть метаданные, название и имя исполнителя извлекутся автоматически, а обложка альбома будет использована для генерации текстуры музыкального диска.

Когда всё готово, просто дважды кликни по исполняемому файлу FoxNapRPG. Может открыться окно терминала с прогрессом создания ресурспака, и вскоре в текущей директории появятся новые файлы:

• FoxNapRP.zip — ресурспак со всеми сконвертированными песнями и текстурами музыкальных дисков, его можно закинуть в папку resourcepacks Minecraft
• FoxNapDP.zip — датапак, определяющий все свойства самих треков. Его нужно положить в папку datapacks любого мира, где хочешь использовать свою музыку (см. примечание ниже про мультиплеер).
• foxnap.yaml нужно положить в папку config Minecraft. Он сообщает игре, сколько музыкальных дисков включить для тебя.

Продвинутые настройки: параметры командной строки

Генератор можно запускать и из командной строки — это даёт доступ к куче дополнительных настроек, например к указанию директорий для поиска музыки или мест сохранения сгенерированного ресурспака и конфига мода.

Подробности смотри, выполнив:

$ ./FoxNapRPG --help

из папки, куда сохранён исполняемый файл генератора.

А что насчёт мультиплеера?

Играя на сервере, именно датапаки и конфиг *сервера* определяют:

• как долго будет играть каждая песня
• силу редстоун-сигнала с музыкальных блоков, играющих каждый диск
• количество треков, доступных у Maestro

но именно ресурспак и конфиг *каждого игрока* управляют:

• песнями, которые будет играть каждый диск
• внешним видом (и описанием) каждого диска
• тем, какие диски отображаются как «заглушечные» пластинки

Конкретно:

• если на сервере указано больше дисков, чем задано в твоём конфиге, некоторые диски будут показываться у тебя с заглушечными текстурами и звуковыми файлами
• если в твоём ресурспаке больше дисков, чем настроено на сервере, то не все треки будут доступны в вашей общей игре
• некоторые музыкальные диски могут продолжать играть беззвучно после окончания песни, а некоторые могут обрываться

Но помимо количества дисков нет причин, по которым каждый игрок не мог бы зайти с полностью своим плейлистом песен похожей длины!

Получение пластинок и не только!

Итак, теперь, когда ты зарегистрировал эти кастомные пластинки в игре, как их вообще получить? Помимо команд (например, /give @s foxnap:track_1) и режима Creative, единственный способ получить пластинки FoxNap — торговля с Maestro, новым жителем, у которого музыкальный блок служит рабочим местом (учти, что Maestro сейчас не спавнится естественным образом, но эта функция запланирована).

Maestro заплатит щедро за тонвуд — очищенные блоки редких пород дерева — козьи рога и пластинки, не относящиеся к FoxNap, а продаёт, помимо твоих кастомных музыкальных дисков, широкий выбор играбельных музыкальных инструментов (с текстурами, позаимствованными из классического мода mxTune).

Отключение The Maestro

Если вы предпочитаете не добавлять The Maestro в свою игру (и хотите получить свои музыкальные диски каким-либо другим способом, например, с помощью датапака), вы можете отключить эту часть мода, отредактировав свой foxnap.yaml config file и добавив следующую строку:

enable_maestro: false

Fox Nap Vanilla

С выходом Minecraft 1.21 музыкальные диски теперь полностью управляются данными! Таким образом, ресурспаки и датапаки, созданные Fox Nap Resource Pack Generator, полностью совместимы с ванильной игрой. Подробности можно найти на вики.

Участие в разработке

Нашли баг? Есть предложение или вопрос? Хотите добавить новую функцию или улучшение? Откройте issue!

Лицензия и благодарности

Весь код в этом репозитории распространяется под лицензией GPLv3.

Сборки FoxNap Resource Pack Generator (FoxNapRPG) включают бинарные файлы ffmpeg, который распространяется под GNU Lesser General Public License (LGPL) версии 2.1 или более поздней и включает компоненты, лицензированные под GNU General Public License (GPL) версии 2 или более поздней.

Все ресурсы в этом репозитории распространяются под Creative Commons Attribution-ShareAlike 4.0 License, если не указано иное.

Иконки инструментов взяты из мода mxTune от @AeronicaMC.

Звуки инструментов предоставлены Philharmonia's библиотекой звуковых сэмплов.

Большое спасибо @FoundationGames за то, что код его крутого мода Sandwichable так легко понять и учиться на нём, а также Modding by Kaupenjoe за его крутые и подробные туториалы по моддингу Minecraft, в данном случае его туториал по добавлению кастомной профессии жителя.

Также выражаю благодарность @Siphalor и jSdCool с Reddit за это обсуждение о добавлении внешних библиотек, не являющихся модами, в Fabric мод. Добавить библиотеку SnakeYAML в мод не должно было быть настолько сложно.