Audio Synth

Audio Synth — модуль звукового синтезатора

Audio Synth — это мод для Minecraft Forge, добавляющий особый блок, способный синтезировать и воспроизводить несколько звуковых волн — звуковой синтезатор. Он поддерживает синусоидальную, квадратную, треугольную, пилообразную волны и белый шум, а также частотную модуляцию, смешанный вывод, независимую регулировку громкости, активацию редстоуном, затухание звука в зависимости от расстояния и простой интерфейс настройки. Общую громкость можно регулировать через экран конфигурации мода, а каждый блок может иметь собственный уровень усиления в децибелах.

✨ Возможности

• 🎵 Несколько звуковых волн: синусоидальная, квадратная, треугольная, пилообразная, белый шум
• 🎛 Частотная модуляция: поддержка FM-синтеза с настраиваемой глубиной и частотой модуляции
• 🔀 Смешанный вывод: настраиваемый коэффициент смешивания (зарезервировано для расширения; в текущей версии используется одна волна)
• 🔊 Независимая регулировка громкости: настройка усиления в децибелах для каждого блока (-60 дБ ~ +60 дБ)
• 📏 Затухание по расстоянию: настраиваемая дальность распространения звука (в блоках); за пределами дальности звук не слышен, громкость снижается с расстоянием
• 🔴 Активация редстоуном: начинает воспроизведение при получении сигнала редстоуна, останавливается при потере сигнала
• 🖥 Настройка через GUI: нажмите ПКМ по блоку, чтобы открыть интерфейс настройки, изменяйте параметры в реальном времени, нажмите «Применить», чтобы сохранить и закрыть
• ⚙️ Общая громкость: регулировка глобального множителя громкости для всех блоков через экран конфигурации мода (Моды → Audio Synth → Конфигурация)
• 🧩 Условные рецепты: автоматически адаптируется к трём разным рецептам крафта в зависимости от наличия мода Create и его версии
• 🧵 Потокобезопасность: воспроизведение звука работает в отдельных потоках, поддерживая одновременное звучание нескольких блоков

📦 Зависимости

• Minecraft Forge 47.4.4+ (для 1.20.1)
• Create (опционально): если установлен, рецепт автоматически подстраивается в зависимости от его версии

Примечание: экран настройки общей громкости требует поддержки меню «Моды» в Forge; дополнительные моды не нужны.

🔧 Установка

1. Установите Minecraft Forge 1.20.1.
2. Скачайте .jar-файл этого мода и поместите его в папку mods.
3. (Опционально) Установите соответствующую версию мода Create, если хотите использовать его рецепты.
4. Запустите игру.

---

🎮 Руководство по использованию

Получение блока

• Скрафтите звуковой синтезатор по его рецепту (см. ниже).

Установка и активация

• После установки нажмите ПКМ, чтобы открыть GUI и настроить параметры.
• Подайте сигнал редстоуна (например, рычагом, редстоуновой пылью), чтобы начать воспроизведение.
• Уберите сигнал редстоуна, чтобы остановить воспроизведение.

Параметры GUI

Параметр	Описание	Диапазон
Частота (Гц)	Базовая частота	20 ~ 2000
Форма волны	Выбор типа волны	Синусоида/Квадрат/Треугольник/Пила/Шум
Коэффициент смешивания	Зарезервировано (сейчас фиксировано на 0.5)	0.0 ~ 1.0
Глубина модуляции	Глубина частотной модуляции	0.0 ~ 1.0
Частота модуляции (Гц)	Частота модуляции	0.1 ~ 20
Дальность (блоки)	Дальность распространения звука	1 ~ 64
Громкость (дБ)	Независимое усиление громкости для каждого блока	-60 ~ +60

Настройка общей громкости

• Из главного меню нажмите Моды → Выберите Audio Synth → Нажмите Конфигурация.
• Отрегулируйте глобальный множитель громкости с помощью ползунка (0.0 ~ 2.0), нажмите «Готово» для сохранения.

---

🔨 Рецепты крафта

Рецепт автоматически адаптируется в зависимости от наличия мода Create и его версии.

Случай 1: Create версии ≥ 6.0

• Тип рецепта: Бесформенный

• Материалы:

  • 1 × Латунный корпус (create:brass_casing)
  • 1 × Нотный блок (minecraft:note_block)
  • 1 × Импульсный таймер (create:pulse_timer)
  • 1 × Электронная лампа (create:electron_tube)

Случай 2: Create версии ≥ 0.5 и < 6.0

• Тип рецепта: Бесформенный

• Материалы:

  • 1 × Латунный корпус (create:brass_casing)
  • 1 × Нотный блок (minecraft:note_block)
  • 1 × Электронная лампа (create:electron_tube)
  • 1 × Удлинитель импульса (create:pulse_extender)
  • 2 × Повторители импульса (create:pulse_repeater)

Случай 3: Create не установлен или версия < 0.5

• Тип рецепта: Форменный (3×3)

• Схема:

  G C G
  R N R
  G C G

• Материалы:

  • G = Золотой слиток (minecraft:gold_ingot)
  • R = Редстоуновый повторитель (minecraft:repeater)
  • N = Нотный блок (minecraft:note_block)
  • C = Редстоуновый компаратор (minecraft:comparator)
• Результат: 1 × Звуковой синтезатор Игра автоматически определяет окружение и загружает правильный рецепт. Такие моды, как JEI, отобразят соответствующий рецепт.

---

⚙️ Файл конфигурации

Клиентский файл конфигурации находится по адресу .minecraft/config/audiosynth-client.toml:

[Audio Settings]
    # Global volume multiplier for all sound generator blocks (0.0 - 2.0)
    globalVolume = 1.0

Его можно изменить через кнопку «Конфигурация» в меню «Моды» или отредактировав файл напрямую.

🧪 Информация для разработчиков

• Mod ID: audiosynth
• Главный класс: top.hibermod.audiosynth.AudioSynth
• MCP-маппинги: official 1.20.1
• Версия Forge: 47.4.4

Сборка

Используйте Gradle для сборки:

./gradlew build

Результат будет в build/libs/.

📄 Лицензия

Этот проект распространяется с открытым исходным кодом под лицензией MIT. Подробности см. в файле LICENSE.

🙏 Благодарности

• Спасибо команде Forge за фреймворк для разработки модов
• Спасибо моду Create за его превосходные механические компоненты
• Спасибо всем игрокам, которые используют и тестируют этот мод

---

📮 Обратная связь и поддержка

По вопросам или предложениям, пожалуйста, оставляйте их на странице GitHub Issues проекта.

Приятных звуковых экспериментов! 🎶