Iron’s Voicebound Spells – Iron’s Spells ‘n Spellbooks

Iron’s Voicebound Spells

将你的声音化为魔法。Iron’s Voicebound Spells 是一款非官方语音施法附加模组，专为 Iron’s Spells ‘n Spellbooks 制作。说出已配置的咒语，附加模组便会使用 Iron 官方的快速施法系统施放对应法术。

语言支持

Iron’s Voicebound Spells 通过独立的语言版本支持 英语和巴西葡萄牙语（PT-BR）。

打开 Files 或 Versions 菜单，下载与你使用的语言对应的文件：

• 仅英语：英语语音识别、界面和默认咒语。

• 仅 PT-BR：巴西葡萄牙语语音识别、界面和默认咒语。

每次只能安装一个语言版本。CurseForge App 可能会自动选择最新的兼容文件，因此安装前请检查文件名。

功能

• 使用麦克风施放可用的 Iron’s 法术。

• 提供英语和巴西葡萄牙语版本。

• 使用 Vosk 快速离线识别，并在遇到难识别的词语时回退到本地 Whisper。

• 语音识别无需云服务、账户或网络连接。

• 根据所选语言设置默认咒语。

• 为每个法术自定义词语或短语，多个选项之间用逗号分隔。

• 可通过法术原名或已配置的任意语音咒语搜索法术。

• 临时转录 HUD 会显示识别到的内容。

• 支持精确匹配、句子匹配和保守的近似词匹配模式。

• 支持玩家个人配置文件、麦克风选择和输入音量计。

• 语音测试模式可识别法术，但不会施放。

• Iron’s 原有规则仍然生效，包括魔力、冷却时间、法术等级、已装备物品和施法时间。

快速教程

1. 从 Files/Versions 菜单下载仅英语或仅 PT-BR文件。

2. 将其与 Iron’s Spells ‘n Spellbooks 及其所需前置库一同安装。

3. 进入地图，并装备一本包含可用法术的法术书或其他物品。

4. 按一次 V 开始聆听。

5. 说出已配置的咒语：

   • 英语版本：“fireball”

   • PT-BR 版本：“bola de fogo”

6. 再次按下 V 停止聆听。

要中断正在进行的施法，请说：

• 英语版本：“cancel spell”

• PT-BR 版本：“cancelar magia”

语音选项

按下 O 打开语音选项。在此界面中，你可以：

• 在当前可用法术与完整法术目录之间切换。

• 按法术名称或语音施法短语搜索。

• 添加多个以逗号分隔的咒语。

• 要求短语完全匹配，或允许短语出现在较长句子中。

• 启用保守的近似词识别。

• 显示或隐藏转录消息。

• 启用或禁用确认音效。

• 选择麦克风并监控输入音量。

• 使用 Test Voice 测试识别效果，而不会施放任何法术。

多个咒语示例：

• 英语：fireball, flame orb, blaze

• PT-BR：bola de fogo, fogo, brasa

绿色指示器使用快速 Vosk 路径，黄色指示器可能需要 Whisper，红色指示器标识无效、保留或重复的短语。按 保存 应用更改，或按 取消 放弃更改。

要求

• Minecraft 1.20.1

• Forge 47.4.x

• Java 17

• Iron’s Spells ‘n Spellbooks 1.20.1-3.15.4 至 3.16.x

• Iron’s 必需的前置库：GeckoLib、Curios、Player Animator 和 Iron’s Libraries

多人游戏时，请在客户端和服务端安装相同语言版本。麦克风采集和语音识别仍在客户端进行；只有解析后的法术请求会发送到服务端进行验证。

隐私

语音处理在您的计算机本地进行。音频不会上传到互联网，也不会被永久录制。内置的本地识别模型使下载体积大于普通附加模组。

兼容性说明

这是一个非官方附加模组，与 Iron’s Spells ‘n Spellbooks 的创作者无关，也未获得其认可。需要 Iron’s Spells ‘n Spellbooks；本项目不添加独立法术，也不打算在没有它的情况下运行。