铁之咒语：咏唱

铁之咒语：吟唱

说出法术之名。释放它。

吟唱（Incantation）会监听你的简易语音聊天（Simple Voice Chat）麦克风，将音频输入离线语音识别器（Vosk），然后释放你所说出的任何铁之咒语（Iron's Spells 'n Spellbooks）中的法术。无需语音训练、无需额外按键绑定，除了将模型解压到配置文件夹之外，无需任何其他设置。

工作原理

当简易语音聊天正在传输你的音频时，吟唱会将音频帧输入到一个由注册表中所有法术名称构建的 Vosk 识别器中。识别出的内容随后会与你实际装备的物品进行比对——包括你在 Curios 槽中的法术书、手中的法术书，或你手持的附魔武器——任何你未装备的法术都会在你的客户端上被拒绝，永远不会发送到服务器。

语法结构特意保持宽泛。将其缩小到仅识别你已装备的法术听起来更安全，但当只剩下两三个短语时，识别器会将任何音频——咳嗽声、脚步声、其他人的说话声——强行匹配到其中最近似的一个。保留所有法术名称可以稀释这种误匹配，而真正的防错机制是装备检查，它能阻止未拥有的法术被释放。

整个处理流程在本地运行。无网络请求。无账户。你的声音永远不会离开你的电脑。

功能特性

• 说出任意已收录法术 - 兼容铁之咒语、其所有附加模组，以及任何通过铁之氏族的 API 注册法术的模组。
• 仅限已装备法术释放 （默认开启） - 只有位于 Curios 槽、主手或副手中的法术才会被释放。其他所有法术在离开你的客户端前都会被拒绝。
• 支持附魔武器 - 手持附魔剑或法杖，说出其所携带的法术，即可通过与右键点击相同的机制来释放。
• HUD 界面芯片 - 固定在角落的芯片，显示上次释放的法术、排队法术、未命中提示、别名建议以及实时音频计量器。
• 主题系统 - 强调色预设（奥术、繁花、海洋、薄荷、鎏金，以及通过释放里程碑解锁的凤凰 / 冰霜 / 翠绿 / 死灵）和基础调色板（暗黑、午夜、石板）。
• 原版进度 用于语音释放里程碑和连招释放。
• 法术列表界面 - 显示注册表暴露的所有法术，并配有 Vosk 监听的精确短语。
• 语音法典 - 个人统计（释放次数最多的法术、连续天数、平均延迟）。
• 测试竞技场 - 安全的练习模式。
• 首次启动欢迎向导。
• 别名与自定义短语 - 可将模型能发音的词语绑定到任意法术 ID。
• 配置快捷方式 - 说出一个词，即可从列表中释放第一个可释放法术。
• 宏命令 - 录制释放序列，通过一个按键即可重放。
• 语音指令 - “法术一”…“法术九”切换法术书槽位；“是”/“否”控制释放队列。
• 服务端控制 - 白名单、黑名单、速率限制、附近广播、释放日志。

前置需求

• Minecraft 1.21.1
• NeoForge 21.1.x
• 简易语音聊天（henkelmax，2.5.x+）
• 铁之咒语（iron431，3.x+）
• 一个较小的 Vosk 英文模型（约 40 MB）
• 推荐安装 Curios API

安装设置

1. 将吟唱模组的 jar 文件放入你的 mods/ 文件夹中，与 SVC 和铁之咒语放在一起。
2. 从 https://alphacephei.com/vosk/models 获取一个 Vosk 模型 - vosk-model-small-en-us-0.15.zip 对于原版法术名称来说绰绰有余。
3. 解压并将内容复制到 config/voicespells/model/ 中，最终目录结构应为 config/voicespells/model/am/、config/voicespells/model/conf/ 等。
4. 启动游戏，加入世界，触发 SVC，然后说出一个你已装备的法术。

许可证

MIT。

源代码

https://github.com/Hoggormino/incantation

致谢

• Vosk - Alpha Cephei（Apache 2.0）
• 简易语音聊天 API - Maximilian Henkel（MIT）
• 铁之咒语 - iron431