Ambience Mini

Вдохновлённый модом "Ambience" от Vazkii и "Ambience - Extras" от viniciusgf1, этот мод позволяет проигрывать свою музыку в зависимости от состояния игры: битвы с боссами, бой, нахождение под землёй, сон, рыбалка, время суток и многое другое, но с куда более гибкой системой настройки по сравнению со старыми версиями. Эта версия не добавляет никаких блоков, предметов или команд из старых модов, и я пока не планирую их возвращать — отсюда и «Mini» в названии (хотя мод уже не такой уж и «mini», ну да ладно).

На CurseForge есть только минимум информации для начала работы с модом, но больше всегда можно найти в Ambience Mini Wiki или задать вопросы в Discord-сервере Ambience Mini. Сообщайте об ошибках в Discord или на GitHub.

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

Мод слегка переусложнён? Возможно. Было ли интересно его делать? Да!

Обзор возможностей

Полные возможности мода описаны в вики, но вот примерный обзор.

Последняя версия умеет определять/считывать:

• Некоторые открытые меню (главное меню, подключение, отключение, титры, пауза).
• Некоторую информацию о мире (сложность, id измерения, id и теги биомов).
• Время суток (день, ночь, закат, рассвет).
• Погоду (дождь, снег, гроза).
• Некоторые состояния игрока (здоровье, сон, рыбалка, под водой, ездовые животные/транспорт, эффекты зелий/(де-)баффы, Elytra и другое).
• Состояние боя (количество сражающихся мобов, активные боссы и есть ли рядом warden).
• Деревни и ранчо по подсчёту сущностей поблизости.
• Находится ли игрок в пещере, по окружающим блокам и освещению.
• Все заданные пользователем зоны/регионы, в которых сейчас находится игрок. (некоторые функции требуют поддержки сервера)
• Находится ли игрок в автоматически сгенерированных структурах вроде деревень и крепостей. (требует поддержки сервера)
• Флаги (именованные текстовые/строковые значения), хранящиеся на сервере и задаваемые командами. (требует поддержки сервера)

Определение пещер: алгоритм определения пещер использует окружающее освещение и блоки, чтобы определить, насколько вероятно, что игрок находится в пещере, что позволяет гораздо точнее определять пещеры по сравнению с другими музыкальными модами, которые обычно полагаются только на освещение и/или высоту.

Система зон: игроки могут задавать именованные зоны с помощью полностью клиентской системы на основе привязок клавиш и меню, даже если мод не установлен на сервере. При поддержке сервера зонами можно делиться между игроками.

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

Поддерживаемые форматы файлов: MP3, OGG и FLAC.

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

Основные привязки клавиш:

• P перезагружает Ambience Mini и музыкальный пак прямо в игре, так что можно применить изменённый конфиг музыки без перезапуска игры или восстановиться, если музыкальный движок упадёт.
• End ставит на паузу/возобновляет текущую играющую музыку.
• Page Up выбирает новую музыку в текущем плейлисте.
• Page Down выводит всё состояние Ambience Mini (события и свойства) в логи Minecraft, позволяя увидеть, что видит мод.

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

Видеогайд: https://www.youtube.com/watch?v=Addpe8c0gQQ

Для начала нужно скачать и установить 1) сам мод и 2) музыкальный пак. До версии 2.2.0 мод следовало устанавливать только на клиент. Начиная с версии 2.2.0 мод можно ставить на клиент, на сервер или и туда, и туда. При установке на сервер включается несколько дополнительных функций (и клиенты без мода всё равно могут заходить).

Далее можно либо скачать пример музыкального пака для Ambience Mini 2.7.x, либо попробовать сделать свой. В любом случае убедитесь, что папка ambience_music лежит в папке .minecraft рядом с папкой mods.

Список ниже показывает файлы и папки, используемые этим модом. Музыкальные файлы находятся в .minecraft/ambience_music/music/. Файл .minecraft/ambience_music/music_config.txt описывает, какая музыка должна играть при каких условиях.

- .minecraft
  - ambience_music    // <-- Пример можно скачать по ссылке выше
    - music
      - Music1.mp3
      - Music2.mp3
      - ...
      - MusicN.mp3
    - music_config.txt
  - config
    - ambience_mini-client.toml
  - mods
    - AmbienceMini-McVersion-ModVersion.jar

Если возникнут проблемы с настройкой мода или музыкальных паков, смотрите также страницу troubleshooting.

На заметку

По умолчанию мод игнорирует настройку общей громкости в Minecraft, поскольку музыка обычно становится слишком тихой по сравнению с другими звуками, и было куда проще отключить музыку от общей громкости, чем подстраивать всё остальное. Это поведение можно изменить в файле конфигурации "ambience_mini-client.toml".