语音命令模组

语音指令模组

说些不该说的话，看有什么东西生成。由 Xeroh 最佳展示

语音指令模组在你玩《我的世界》时会监听麦克风。当检测到触发词时，它会随机选择一个生物并生成在你附近。无需 Python、无需外部程序，只需将 JAR 文件放入模组文件夹即可完成安装。

专为直播主打造，但也适合任何想管住自己嘴巴的人。

工作原理

该模组使用 Vosk 进行离线语音识别。所有处理都在你的电脑本地运行。首次启动时，一个约 40MB 的小型语音模型会自动解压到你的 .minecraft 文件夹。语音检测无需网络连接，也不会将任何音频数据发送到任何地方。

系统要求

• Minecraft 1.20.1
• Forge 47.3.0 或更高版本
• wonderland.jar（用于生成预设生物，但可在配置中改为任意生物 ID）
• 一个正常工作的麦克风，并在 Windows 中设置为默认录音设备

功能特性

• 语音触发生物生成：说出一个触发词（可在配置中更改），该词对应的生物池中就会生成一个生物。每个词语组都有一个生物列表，每次随机选择其一。
• 子串检测：模组能够在较长的词语中识别出触发词。如果没有这个功能，模组会略显乏味。加入此功能是为了增加一些额外的混乱效果。
• 诅咒抽奖：每触发第 10 个词就会激活诅咒抽奖。此时不会生成单个生物，而是从整个生物池中快速生成 3 到 5 个随机生物。
• 羞辱标题：每次触发词出现时，聊天栏中会显示一条消息，包含你的总骂人次数和你说出的词语。
• 良好记录追踪器：每次触发后，热键栏上方会显示距离上次触发词的时间，让你和观众都能看到你保持了多久的良好行为。
• 完全可配置的词语和生物列表（自版本 2.1.1 起，拥有游戏内配置菜单）。首次启动时，模组会在以下位置创建一个纯文本配置文件：

.minecraft/config/voicecommand_words.txt

用记事本打开即可添加词语、删除词语、更改每个触发词生成的生物，以及控制生物是生成在你身上还是前面。无需 JSON、无需特殊语法，纯文本即可。 添加新触发词的示例：

chicken = the_wonderland:carrier_aggro, the_wonderland:eyeless

• 游戏内设置：通过 Forge 模组配置界面（Mods -> Voice Command Mod -> Config）可进行的其他设置：
  • 完全启用或禁用模组
  • 触发冷却时间（秒）
  • 抽奖频率
  • 切换骂人次数显示
  • 切换良好记录显示

首次启动

在安装模组后首次启动时，Vosk 语音模型会自动解压到你的 .minecraft 文件夹。这将在后台进行，耗时几秒钟。当准备就绪时，你会在游戏日志中看到以下信息：

[VoiceMod] 麦克风已启动 - 正在监听触发词！

面向直播主

本模组专为直播场景设计。羞辱标题会出现在聊天栏中，便于观众在直播中看到。良好记录追踪器让观众有东西可以关注和积累。诅咒抽奖则随着骂人次数接近下一次大奖，营造出自然的紧张时刻。

词语和生物配置文件让你无需重新编译任何内容，就能轻松为你的特定整合包定制模组。

故障排除

我说话时没有任何反应

• 确保你的麦克风已在 Windows 声音设置中设为默认录音设备
• 检查游戏日志中是否有 "[VoiceMod] 麦克风已启动" 这一行
• 确保你已经完全加载进入一个世界，而不是停留在标题界面

生物没有生成

• 确保已安装 wonderland.jar（除非在配置中更改过）
• 检查配置文件，确认生物 ID 是否正确
• 检查游戏日志中是否有任何以 [VoiceMod] ERROR 开头的行
• 确保你有生成生物的权限（仅限版本 2.0.0）

我想使用其他模组的生物

• 打开 .minecraft/config/voicecommand_words.txt
• 将生物 ID 替换为你的整合包中的任何有效实体 ID
• 格式为 modid:entityname，与 /summon 命令相同

隐私说明

本模组使用完全离线的 Vosk 语音识别库。不会将任何音频录制到磁盘。不会将任何音频或转录数据发送到任何服务器。一切数据都保留在你的电脑上。

报告 Bug

你可以在我的 Discord 提交 Bug 报告，也可以在那里提交模组的改进建议。

致谢

语音识别由 Alpha Cephei 的 Vosk 提供。模组生物来自 wonderland.jar。