Audio Navigation

Этот модификационный проект для Minecraft вводит систему звуковой навигации, которая значительно облегчает взаимодействие со игрой для незрячих и слабовидящих игроков. Разработка создавалась в качестве дополнения, а не замены другому популярному проекту Minecraft Access. Концепция некоторых элементов была вдохновлена технологией Microsoft Soundscape.

Системные требования и зависимости

Модификация поддерживает работу как на клиенте, так и на сервере. Совместимость охватывает Fabric, NeoForge, а также Paper и Purpur серверы.

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

• Fabric API (используется только с Fabric)
• Fabric Language Kotlin (требуется для Fabric)
• Kotlin for Forge (необходим для NeoForge)
• Architectury API (нужен для Fabric и NeoForge)
• Fzzy Config (поддерживает Fabric и NeoForge)
• Eclipse (обязателен для Paper и Purpur)

Дополнительно используется специальная библиотека для синтеза речи, которая автоматически скачивается при первом запуске. Библиотека доступна для Windows, MacOS и Linux на архитектурах x86_64 и aarch64. Для работы выделенных серверов данная библиотека не требуется.

Важная информация

Для полной функциональности необходимо установить модификацию как на клиенте, так и на серверной части. Точки интереса, такие как деревья и другие игровые объекты, создаются только в тех регионах мира, которые генерируются при уже установленной модификации. Прогресс создания точек сохраняется в файле poi.db в директории .minecraft или корневой папке сервера Minecraft.

Основные возможности

• Автоматическое озвучивание точек интереса при приближении к ним пользователя. Каждый тип объекта сопровождается уникальным звуковым сигналом перед объявлением.
• При озвучивании точка всегда называет своё название. Дополнительно сообщается расстояние до неё и направление - с различными вариантами форматов: по часовому циферблату, направлениям компаса, углам с вертикальной проекцией или отдельно вертикальной или горизонтальной компонентой.
• Во время генерации мира автоматически создаются точки интереса для различных природных объектов: деревья, ледяные глыбы, эндер-острова, жилы руд. Поддержка сооружений планируется в будущих обновлениях.
• При нажатии F7 сообщаются все ближайшие точки интереса вокруг игрока с увеличенными параметрами радиуса и лимита вертикального расстояния по сравнению с обычными автоматическими оповещениями.
• Озвучивание можно немедленно остановить нажатием F9.
• Создание пользовательских ориентиров выполняется через меню, открываемое на F6, с опцией выбора видимости для других игроков.
• Управление ранее созданными точками осуществляется через то же меню с функцией удаления отдельных элементов.
• Активация аудиомаяка для ориентира включает непрерывный сигнал с постоянно изменяющимся тембром при изменении направления от игрока. Каждые 30 секунда автоматически сообщается информация о расстоянии и направлении маяка.
• Остановка маяка выполняется через пункт меню. Состояние маяка проверяются нажатием F8.
• Рядом с направлением маяка отображается дополнительная коррекция перемещения между континентами введена группа сопровождения целей более заходя на режимов дзет.
• Обширные настройки системы доступны через меню конфигурации, где можно детально настраивать практически все параметры модификации.
• Система поддерживает выбор между несколькими синтезаторами речи. Стандартные eSpeak NG и дополнительно, для определённых операционных систем, SAPI 5 на Windows, или AVSpeechSynthesizer на MacOS.
• Доступные голоса фильтруются по языковым настройкам Minecrafа - по умолчанию используется версия текущей игровой локализации.

Настройка сервера

Администраторы выделенных серверов могут настраивать максимальный радиус отправки точек интересов клиентам, а также запрещать передачу определённой информации. Режим Fabric или NeoForge используют конфигурационный файл в config/audio_navigation/server_config.toml, Paper или Purpur работают с настройками через plugins/AudioNavigation/config.yml. Управление величинами юнируют управление компактном порядке.