VoskLib

VoskLib

一个将VOSK移植到Minecraft的库模组

基础库

🎙️ VoskLib

VoskLib 是一个面向 Minecraft Forge 1.20.1 的高性能离线语音识别库。


✨ 特性

  • 100% 离线: 识别无需 API 密钥或互联网连接。
  • 双模式: 可在字面模式(词汇量大)和语法模式(受限列表)之间切换。
  • 游戏内模型管理器: 直接从模组配置菜单下载和管理 Vosk 模型,内置进度条。
  • 线程安全: 后台音频处理会自动与 Minecraft 主线程同步。
  • 对开发者友好: 提供易于使用的事件,用于获取部分和最终语音结果。

🛠️ 用户安装指南

  1. 安装 Minecraft Forge 1.20.1。
  2. 将 jar 文件放入你的 mods 文件夹。
  3. 下载模型:
  • 打开游戏,进入 Mods -> VoskLib -> Config。
  • 选择一个模型(小、中或大),然后点击 Download。
  • VoskLib 会自动处理下载和解压。

⌨️ 按键绑定

  • V(默认): 开启/关闭语音识别。
  • 可在标准控制菜单的“Vosk Voice Library”分类中进行配置。

💻 开发者 API

要在你的项目中使用 VoskLib,请将其添加到你的 build.gradle,并开始监听事件。

1. 处理语音结果

VoskLib 会在 Forge 事件总线上触发事件。这些事件已在主线程上执行,因此你可以安全地与玩家或世界交互。

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

    if (text.contains("fireball")) {
        // 你的逻辑:在玩家面前召唤一个火球
    }
}

@SubscribeEvent
public void onPartialSpeech(VoskVoiceEvent.Partial event) {
    // 适用于实时 UI 字幕
    String partial = event.getResult();
}

2. 控制状态

你可以通过以下方式请求 VoskLib 开始或停止监听:

String[] spells = {"ignite", "freeze", "thunder", "heal"};
VoskManager.createRecognition(spells); // 为语法模式创建识别(针对特定单词的高准确率)
VoskManager.createRecognition(); // 为字面模式创建识别(通用听写)

VoskManager.startListening(); // 开始监听
VoskManager.stopListening(); // 停止监听

📜 致谢

  • Vosk API: 由 Alpha Cephei 开发。
  • 模组作者: Infinity Two。