VoskLib

🎙️ VoskLib

VoskLib — это высокопроизводительная библиотека офлайн-распознавания речи для Minecraft Forge 1.20.1

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

• 100% офлайн: для распознавания не нужны API-ключи или подключение к интернету.
• Два режима: переключение между Literal Mode (широкий словарь) и Grammar Mode (ограниченные списки).
• Менеджер моделей прямо в игре: скачивайте модели Vosk и управляйте ими прямо из меню конфигурации мода со встроенным индикатором прогресса.
• Потокобезопасность: фоновая обработка звука автоматически синхронизируется с главным потоком Minecraft.
• Удобно для разработчиков: простые в использовании события для промежуточных и финальных результатов распознавания.

🛠️ Установка для пользователей

1. Установите Minecraft Forge 1.20.1.
2. Поместите jar-файл в папку mods.

3. Скачайте модель:

• Откройте игру и перейдите в Mods -> VoskLib -> Config.
• Выберите модель (Small, Medium или Large) и нажмите Download.
• VoskLib автоматически скачает и распакует её.

⌨️ Клавиши

• V (по умолчанию): включает и выключает распознавание речи.
• Настраивается в стандартном меню управления в категории "Vosk Voice Library".

💻 API для разработчиков

Чтобы использовать VoskLib в своём проекте, добавьте её в build.gradle и начните слушать события.

1. Обработка результатов речи

VoskLib вызывает события в Forge Event Bus. Эти события уже выполняются в главном потоке, так что вы можете безопасно взаимодействовать с игроком или миром.

@SubscribeEvent
public void onVoiceResult(VoskVoiceEvent.Result event) {
    String text = event.getResult().toLowerCase();

    if (text.contains("fireball")) {
        // Your logic: Summon a fireball in front of the player
    }
}

@SubscribeEvent
public void onPartialSpeech(VoskVoiceEvent.Partial event) {
    // Useful for real-time UI subtitles
    String partial = event.getResult();
}

2. Управление состоянием

Вы можете попросить VoskLib начать или прекратить прослушивание так:

String[] spells = {"ignite", "freeze", "thunder", "heal"};
VoskManager.createRecognition(spells); // Create Recognition for Grammar Mode (High Accuracy for specific words)
VoskManager.createRecognition(); // Create Recognition for Literal Mode (General Dictation)

VoskManager.startListening(); // Start Listening
VoskManager.stopListening(); // Stop Listening

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

• Vosk API: разработан Alpha Cephei.
• Автор мода: Infinity Two.