口误

口误

将词语放入列表,以便当玩家通过麦克风说出该词语时,将运行一系列命令

游戏机制

口误

基于语音控制的 Minecraft 命令执行模组。

口误(Slip of a Tongue) 允许玩家使用自己的真实语音触发服务端命令和自定义旁白。通过利用 VoskLib 客户端语音识别引擎,你所说的话会在本地转换为文本,并发送至服务器进行安全验证与执行。


🎤 工作原理

  1. 客户端: 使用 VoskLib(本地)将麦克风输入转换为文本字符串。
  2. 桥梁: 客户端将该字符串发送至服务器。
  3. 服务器: 将词语与预定义列表进行验证。若匹配成功,服务器则执行关联的命令与旁白。

🛠 安装

客户端(必需)

  1. 安装 VoskLib。
  2. 安装 口误。
  3. 重要: 在游戏内打开 VoskLib 配置 (点击 模组 -> VoskLib -> 配置),并下载语言模型以使语音识别正常工作。
  4. 加入世界后,语音识别将自动启用。

服务端(必需)

  1. 安装 口误(服务端 不需要 VoskLib)。
  2. 在服务器的配置文件夹中配置你的词语列表。

⚙️ 命令语法

服务端配置使用特定格式来映射语音触发词:

word:[command1, command2, command3 %player%]text to narrate

详细说明:

  • word:由客户端 STT 检测到的关键词。
  • [...]:服务端命令列表(无需 /)。
  • %player%:替换为说出该词的玩家名称。
  • text to narrate:成功时将被旁白/发送回的消息。

示例条目:

ascend:[effect give %player% levitation 5 1, say %player% is ascending!]Up we go!


🔒 安全与隐私

  • 客户端 STT: 语音处理完全通过 VoskLib 在你的计算机上进行。音频数据绝不会发送至服务器或云端。
  • 服务端验证: 为防止玩家伪造命令,服务器仅对服务端配置文件中明确定义的词语执行操作。

📜 鸣谢

  • VoskLib: 由 InfinityTwo 制作
  • 语音引擎: 由 Vosk 提供支持。
  • 许可证: GNU General Public License v3.0