VoiceAttackAPI

Minecraft VoiceAttack 集成模组

重要！ 本模组在没有 VoiceAttack 配套插件的情况下无法工作，配套插件可在此处找到。

概述

Minecraft VoiceAttack 集成模组是一个客户端实用工具，旨在通过允许 VoiceAttack 直接与 Minecraft 通信来增强无障碍性和游戏体验。该模组使玩家能够使用语音命令执行按键绑定操作，让玩家更容易在不完全依赖传统输入方式的情况下操作游戏。这对使用手柄模组的玩家尤其有益，因为它消除了记住复杂按键组合来访问各种模组和 UI 的需要。

功能

• 无缝集成：与手柄模组开箱即用，无需复杂的按键组合即可轻松访问游戏功能。
• 语音命令执行：使用 VoiceAttack 触发 Minecraft 中的按键绑定操作，增强不同需求玩家的无障碍性。
• 自动端口配置：模组会自动在特定的静态端口上建立与 VoiceAttack 的连接，并在握手过程中生成一个用于通信的唯一端口。

工作原理

1. 建立连接：启动带有该模组的 Minecraft 后，它会尝试在预定义的静态端口上连接到 VoiceAttack。

2. 握手过程：模组向 VoiceAttack 发送握手请求，并附带一个随机生成的端口号用于后续通信。

3. 按键命令执行：握手成功后，VoiceAttack 将使用提供的端口向模组发送按键命令，从而实时执行按键绑定操作。

4. Socket 管理按键绑定：

• 重启 Socket 服务器：用于重启 socket 服务器的按键绑定，确保与 VoiceAttack 的稳定连接。默认按键为 R。
• 更新映射：用于将 voiceattack_translation_keys.json 文件导出到 configs 文件夹的按键绑定，该文件包含导出时任何已绑定按键的翻译键。默认按键为 U。

设置说明

Minecraft 模组

• 无需设置：只需在 Minecraft 客户端中安装该模组，它会自动处理与 VoiceAttack 的连接。

VoiceAttack 配置

要设置 VoiceAttack 以配合本模组使用，你需要为每个命令配置以下参数：

1. 翻译键：创建一个名为 keybind 的文本变量，对应你想在 Minecraft 中触发的操作。该变量应保存所需按键绑定的翻译键。

2. 执行命令：使用 VoiceAttack 的 Minecraft 插件执行命令。传递上下文 execute_keybind 以及你之前创建的 keybind 变量。

示例命令设置

1. 在 VoiceAttack 中创建一个新命令。
2. 添加一个名为 keybind 的文本变量，其值为所需的 Minecraft 操作（例如 key.inventory）。
3. 添加一个执行 Minecraft 插件的操作，上下文为 execute_keybind，并引用 keybind 变量。

导出翻译键

要导出任何已绑定按键的翻译键：

1. 使用指定的按键绑定导出 voiceattack_translation_keys.json 文件。
2. 在 configs 文件夹中找到导出的文件。
3. 参考此文件以通过 VoiceAttack 准确地向 Minecraft 发送数据。

使用场景

• 无障碍性：非常适合有行动障碍、可能觉得传统控制方式难以使用的玩家。
• 免手操作游戏：允许玩家无需使用双手即可执行命令，使多任务处理或更放松的姿势游玩变得更容易。
• 增强游戏体验：简化访问各种模组和 UI 的过程，提高整体游戏效率。

限制

• 该模组不支持所有按键绑定方式，包括：
  • 玩家移动控制（例如行走、奔跑）。
  • 鼠标视角功能。
  • 需要按住按键的按键绑定（例如放大世界地图）。

VoiceAttack 徽标经所有者许可使用。