声学键

AcousticKey

每一次按键，都伴随一声 咕咚。

一款客户端 Fabric 模组，在您打字和点击时播放机械键盘与鼠标的声音。无需安装服务端，无需后台程序——只需将其放入 mods/ 文件夹，您的薄膜键盘就能发出客制化键盘的声音。

为什么选择 AcousticKey？

大多数“键盘音效”方案都需要运行一个独立的桌面程序，与 Minecraft 争夺音频设备。AcousticKey 则完全在游戏内部运行：它直接挂钩键盘和鼠标输入，并通过游戏自身的音频引擎播放声音。这赋予了它三个后台程序无法比拟的特性：

控制

两个快捷键均为标准的 Minecraft 键位绑定——您可以在 选项 → 控制 → AcousticKey 下像其他键位一样重新绑定。

设置界面底部始终显示您当前的键位绑定（例如 J = 界面 │ N = 静音），因此即使在重新绑定后也不会显示错误信息。

设置界面

在任何地方按下 K（或您绑定的按键）：

┌─────────────────────────────────────────────────┐
│  AcousticKey — Sound on every keystroke          │
│  [ KEYBOARD PACKS ]      [ MOUSE PACKS ]        │
│  ┌─────────────┐        ┌─────────────┐         │
│  │ • blue-pbt  │        │ • default-  │         │
│  │ • brown-pbt │        │   mouse     │         │
│  │ • oreo      │        │ • creamy    │         │
│  └─────────────┘        └─────────────┘         │
│  Volume  [━━━━━━●━━] 80%                         │
│  [Mute: OFF] [Key-Up: OFF] [Mouse: ON] [Random: OFF] │
│  [Refresh]  [Open Folder]            [Done]     │
└─────────────────────────────────────────────────┘

• 音效包列表 — 点击即可切换，在下次按键时生效。支持滚动。
• 音量 — 键盘和鼠标分别有独立的滑块，范围 0–100。
• 静音 — 完全静音，不会影响您的音量设置。
• Key-Up — 按键释放时额外播放声音。默认关闭；开启后可能会显得嘈杂。
• 鼠标 — 关闭鼠标点击声，不影响按键声音。
• 随机 — 轻微的音调变化，使重复按键听起来不那么机械。
• 刷新 — 添加新音效包后重新扫描音效包文件夹。
• 打开文件夹 — 在您的文件管理器中打开音效包文件夹。

所有设置会自动保存到 .minecraft/config/acoustickey.json：

{
  "keyboardPackId": "cherrymx-blue-pbt",
  "mousePackId": "default-mouse",
  "keyboardVolume": 80,
  "mouseVolume": 80,
  "muted": false,
  "keyUpEnabled": false,
  "mouseSoundsEnabled": true,
  "randomSoundsEnabled": false
}

音效包

内置音效包

此模组内置了来自 Mechvibes 的 4 个音效包：

• Cherry MX Blue — 清脆青轴 (cherrymx-blue-pbt)
• Cherry MX Brown — 段落茶轴 (cherrymx-brown-pbt)
• Cherry MX Red — 线性红轴 (cherrymx-red-pbt)
• EG Oreo — 绵软奶油轴 (eg-oreo)

此外还内置了 default-keyboard / default-mouse 配置。如果未选择任何音效包或音效包文件缺失，则不会播放任何声音——绝不会播放错误提示音。

添加您自己的音效包

1. 按 K → 打开文件夹（或手动打开 .minecraft/config/acoustickey/soundpacks/）
2. 放入一个包含 MechVibes++ 风格 config.json 及其音频文件的文件夹
3. 点击 刷新 — 它就会出现在列表中

想要更多音效包？可前往 https://mechvibes.com/sound-packs/ 浏览并下载。

格式很重要： 仅支持 ogg 和 wav 格式。m4a/mp3 文件会被静默跳过。可使用 Audacity（导出 → Ogg）或 ffmpeg 进行转换：

ffmpeg -i sound.m4a -c:a libvorbis sound.ogg

然后将音效包 config.json 中的文件扩展名相应修改。

.minecraft/
└─ config/
   ├─ acoustickey.json
   └─ acoustickey/
      ├─ soundpacks/      <- 键盘音效包
      │  ├─ cherrymx-blue-pbt/
      │  ├─ eg-oreo/
      │  └─ my-pack/
      └─ mousepacks/       <- 鼠标音效包
         ├─ logi-g502/
         └─ my-mouse/

安装

前置要求： Fabric Loader ≥ 0.19.3 · Java 21 · Fabric API

1. 为您对应的游戏版本安装 Fabric Loader。
2. 将 fabric-api-*.jar 放入 mods/ 文件夹（如果已有可跳过）。
3. 将对应版本的 acoustickey-*.jar 放入 mods/ 文件夹：

1. 启动游戏 → 选项 → 控制 → AcousticKey → 设置您的按键 → 按 K。

单人游戏和服务器均可正常使用——服务器端无需安装此模组。

常见问题

致谢

• MechVibes — 原始音效包项目
• MechVibes++ — 扩展音效包格式及编辑器
• OpenAL 及自定义 OGG 解码器用于音频播放

许可证：MIT — 详见 LICENSE。