MCMidi

MCMidi

MCMidi — это мод для Minecraft на Fabric, который позволяет проигрывать MIDI-файлы прямо в игре с высоким качеством звука и визуализацией в реальном времени.

Возможности

• Воспроизведение MIDI: Проигрывайте файлы .midi или .mid прямо в клиенте Minecraft.
• Свои SoundFont: Поддержка файлов .sf2 SoundFont для настройки звучания инструментов.

• Визуализация в реальном времени: Отдельный «Midi Control Center» с несколькими вкладками визуализации:

  • Detail: Журнал MIDI-сообщений в реальном времени, BPM и позиция воспроизведения.
  • Nodes: Визуальное отображение активных MIDI-узлов. (Не реализовано.)
  • Piano: Виртуальная пиано-ролл с активными нотами. (Не реализовано.)
  • Waveform: Динамическая визуализация волновой формы. (Не реализовано.)
• Настройка в игре: Интеграция с Mod Menu и Cloth Config для удобной настройки параметров.
• Клиентские команды: Быстрое управление воспроизведением через консольные команды.

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

Управляйте воспроизведением MIDI с помощью следующих клиентских команд:

• `/midi play `: Проигрывает MIDI-файл из вашей локальной библиотеки.
• /midi stop: Останавливает текущее воспроизведение MIDI.

Как использовать

1. Подготовьте файлы:

   • Поместите файлы .midi или .mid в папку midi/musics/ внутри папки вашего экземпляра Minecraft.
   • (Опционально) Поместите файлы .sf2 SoundFont в папку midi/soundfonts/.
2. Запустите Minecraft: Откройте Midi Control Center, нажав , (клавиша по умолчанию).
3. Настройте параметры: Откройте Mod Menu из главного меню, найдите MCMidi и нажмите на иконку шестерёнки, чтобы настроить громкость или выбрать свой SoundFont.

Реализованная архитектура

MCMidi построен с упором на модульность и удобство поддержки:

• Внедрение зависимостей: Использует абстрактный IConfigManager для управления конфигурацией без глобального статического состояния.
• Абстрактная система вкладок: Использует интерфейсы ITabBar и ITabContent из KarasunikiLib для гибкого и расширяемого интерфейса.
• Отвязанный MIDI-движок: Использует интерфейс IMidiEngine, что позволяет моду в будущем поддерживать разные MIDI-драйверы или внешние устройства.

Зависимости

Для работы мода требуются следующие библиотеки:

• Fabric API
• KarasunikiLib
• Cloth Config API
• Mod Menu (опционально, рекомендуется для интерфейса настройки)

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

Мы рады вашему вкладу! Если у вас есть предложения, сообщения об ошибках или вы хотите отправить pull request, следуйте этим шагам:

1. Форкните этот репозиторий и создайте свою ветку от master.
2. Внесите изменения с понятными сообщениями коммитов.
3. Убедитесь, что ваш код собирается и проходит существующие проверки.
4. Отправьте pull request с описанием ваших изменений.

Для крупных изменений сначала откройте issue, чтобы обсудить, что вы хотите изменить.

Лицензия

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