Audio Controller Mod

Мод для Minecraft 1.20.1 Forge, который позволяет добавлять кастомную музыку и управлять ею через удобный интерфейс.

Автор: skaletun

Скачать с CurseForge [https://www.curseforge.com/minecraft/mc-mods/audiocontroller]

Возможности

• 🎵 Воспроизведение кастомных OGG файлов напрямую через LWJGL OpenAL
• 📁 Автоматическое сканирование папки с музыкой
• 🎼 Создание и управление плейлистами
• 🎲 Автоматическое воспроизведение плейлистов со случайным выбором треков (как в оригинальном Minecraft)
• 🔄 Замена стандартной музыки Minecraft
• 🎚️ Интеграция с настройками громкости Minecraft (настройка "Музыка")
• ⏸️ Автоматическая пауза музыки при паузе игры
• 🚪 Автоматическая остановка музыки при выходе из мира
• ⚙️ Настройки мода через меню модов (Mods → Config)
• ⌨️ Горячие клавиши для открытия GUI
• 🌍 Полная локализация (Русский, English)

Установка

1. Установите Minecraft Forge 1.20.1 (версия 47.2.0+)
2. Поместите файл мода в папку mods
3. Запустите игру

Использование

Добавление музыки

1. Поместите OGG файлы в папку config/audiocontroller/music/
2. Откройте GUI мода (клавиша M по умолчанию)
3. Нажмите кнопку обновления (🔄) для сканирования новых файлов

Управление музыкой

Горячие клавиши:

• M - Открыть GUI управления музыкой

Автоматическое воспроизведение плейлистов

Мод работает по принципу оригинального Minecraft - музыка воспроизводится автоматически:

1. Откройте GUI мода (клавиша M)
2. Нажмите кнопку "Плейлист"
3. Выберите плейлист из списка
4. Нажмите "Выбрать плейлист"
5. Плейлист автоматически начнёт воспроизводиться со случайным выбором треков
6. После окончания каждого трека автоматически запускается следующий случайный трек из плейлиста
7. Интервал между треками контролируется автоматически (как в оригинальном Minecraft - ~10 минут)

Создание плейлистов

1. Откройте GUI мода
2. Нажмите кнопку "Плейлист"
3. Введите имя плейлиста и нажмите "Создать плейлист"
4. Выберите плейлист и нажмите "Редактировать" для добавления треков
5. Настройте параметры плейлиста:
   • Shuffle - случайный порядок воспроизведения треков
   • Repeat - повтор плейлиста после окончания всех треков

Настройки

Настройки мода находятся в файле config/audiocontroller-client.toml:

• replaceVanillaMusic - Заменять ли стандартную музыку Minecraft
• autoPlay - Автоматически запускать музыку при входе в игру

Важно: Громкость кастомной музыки контролируется через стандартную настройку "Музыка" в настройках Minecraft (Настройки → Звуки → Музыка). Изменение громкости в настройках Minecraft автоматически применяется к кастомной музыке.

Особенности:

• Музыка автоматически ставится на паузу при паузе игры (клавиша ESC)
• Музыка автоматически останавливается при выходе из мира в главное меню
• Музыка воспроизводится только когда игрок находится в мире

Структура файлов

config/
├── audiocontroller/
│   ├── music/              # Папка для OGG файлов
│   ├── playlists/          # Папка для JSON файлов плейлистов
│   └── active_playlist.txt # Файл с именем активного плейлиста (автоматически создается)
└── audiocontroller-client.toml  # Конфигурация мода

Формат плейлиста

Плейлисты сохраняются в формате JSON:

{
  "name": "My Playlist",
  "tracks": ["track1.ogg", "track2.ogg"],
  "shuffle": false,
  "repeat": true,
  "currentIndex": 0
}

Технические детали

• Мод использует LWJGL OpenAL для прямого воспроизведения OGG файлов, полностью обходя SoundManager Minecraft
• Воспроизведение реализовано через STB Vorbis для декодирования OGG файлов
• Громкость синхронизируется с настройками Minecraft в реальном времени
• Плейлисты автоматически сохраняются и загружаются при входе в мир
• Музыка автоматически ставится на паузу при паузе игры и останавливается при выходе из мира
• Настройки мода доступны через меню модов (Mods → Config)

Разработка

Сборка

./gradlew build

Готовый файл мода будет в build/libs/

Запуск в режиме разработки

./gradlew runClient

Лицензия

MIT

Поддержка

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