AcousticKey
每一次按键,都带有“thock”般的质感。
一个仅客户端的 Fabric 模组,在你在 Minecraft 中打字和点击鼠标时播放机械键盘和鼠标的声音。无需安装服务端或后台程序——只需将模组放入 mods/ 文件夹,你的薄膜键盘就能发出定制键帽般的声音!
为什么选择 AcousticKey?
大多数“键盘音效”解决方案都需要一个独立的桌面应用程序与 Minecraft 协同运行,这会争夺你的音频设备资源。AcousticKey 在游戏内部运行,并直接从游戏引擎读取键鼠输入事件来播放声音。
控制选项
两个热键均为标准的 Minecraft 绑定,你可以在 选项 → 控制 → AcousticKey 中重新绑定它们:
| 操作 |
默认值 |
备注 |
| 打开设置 |
K |
打开设置菜单 |
| 切换静音 |
M |
立即切换音频静音状态 |
设置屏幕的页脚会始终显示你当前的按键绑定(例如 J = GUI │ N = Mute)。
设置
- 包列表: 点击切换音效包 —— 在下次按键时生效。支持滚动浏览。
- 音量: 分别调节键盘和鼠标音频的滑块(0–100%)。
- 静音: 即时全局静音,不会重置音量级别。
- 按键抬起声 (Key-Up): 松开按键时的额外释放音(默认禁用)。
- 鼠标 (Mouse): 独立开关鼠标点击声,不受键盘声音影响。
- 随机 (Random): 细微的音调变化,消除重复听觉疲劳。
- 刷新 (Refresh): 在放入新的自定义文件后,重新扫描音效包文件夹。
- 打开文件夹 (Open Folder): 在你的操作系统文件管理器中打开音效包目录。
所有偏好设置均自动存储在 .minecraft/config/acoustickey.json 中:
{
"keyboardPackId": "cherrymx-blue-pbt",
"mousePackId": "default-mouse",
"keyboardVolume": 80,
"mouseVolume": 80,
"muted": false,
"keyUpEnabled": false,
"mouseSoundsEnabled": true,
"randomSoundsEnabled": false
}
音效包
内置包
AcousticKey 包含来自 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
添加自定义音效包
- 按下
K → 点击 打开文件夹(或手动打开 .minecraft/config/acoustickey/soundpacks/)。
- 添加包含 MechVibes++ 风格
config.json 和相应音频文件的文件夹。
- 在游戏中点击 刷新 以加载新包。
支持的格式: 仅支持 .ogg 和 .wav 音频格式。.m4a 和 .mp3 文件将被自动忽略。
使用 Audacity (导出 → Ogg) 或 ffmpeg 转换文件:
ffmpeg -i sound.m4a -c:a libvorbis sound.ogg
别忘了更新包内 config.json 中的文件扩展名路径为 .ogg。
目录结构
键盘和鼠标音效包是分开存储的:
.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
安装步骤
- 为你的游戏版本安装 Fabric Loader。
- 将
fabric-api.jar 放入 .minecraft/mods/ 目录。
- 将模组放入
.minecraft/mods/ 目录。
- 启动 Minecraft。
常见问题
我可以重新绑定菜单或静音键吗?
可以。前往 Esc → 选项 → 控制 → AcousticKey,选择对应操作,然后按下你想要的按键。
为什么没有声音播放?
- 按下
M 确保静音功能未激活。
- 检查
K 菜单中的两个音量滑块。
- 打开你选择的包的目录,确保音频文件严格为
.ogg 或 .wav 格式。
- 切换到内置包(如
cherrymx-blue-pbt)以查看问题是否特定于该音效包。
为什么鼠标点击无声,但键盘按键正常?
确保在控制面板中选择 鼠标: ON,并确保你当前使用的鼠标音效包包含有效的 .ogg 或 .wav 音频文件。切换到 default-mouse 可解决缺失音频的问题。
致谢
AcousticKey
Every key press, now with a thock.
A client only Fabric mod to play mechanical keyboard and mouse sounds as you type and click. No server install or background program is required - simply place the mod in mods/ and your membrane keyboard will sound like a custom build!
Why AcousticKey?
Most "keyboard sound" solutions require a separate desktop application to run in conjunction with Minecraft which competes for your audio device. AcousticKey runs inside the game and reads key and mouse input events directly from the game engine to play the sounds.
Controls
Both hotkeys are standard Minecraft binds, you can rebind them under Options → Controls → AcousticKey:
| Action |
Default |
Notes |
| Open Settings |
K |
Opens settings menu |
| Toggle Mute |
M |
Instantly toggles audio |
The footer of the settings screen displays your current keybinds (e.g. J = GUI │ N = Mute) at all times.
Settings
- Pack Lists: Click to switch packs — applies on the next key press. Scrollable list.
- Volume: Separate sliders for keyboard and mouse audio (0–100%).
- Mute: Instant master mute without resetting volume levels.
- Key-Up: An extra release sound when keys are unpressed (disabled by default).
- Mouse: Toggle mouse click sounds independently of keyboard sounds.
- Random: Subtle pitch variations to eliminate repetitive audio fatigue.
- Refresh: Rescans the soundpacks folder after dropping in new custom files.
- Open Folder: Opens the soundpacks directory in your OS's file manager.
All preferences are automatically stored in .minecraft/config/acoustickey.json:
{
"keyboardPackId": "cherrymx-blue-pbt",
"mousePackId": "default-mouse",
"keyboardVolume": 80,
"mouseVolume": 80,
"muted": false,
"keyUpEnabled": false,
"mouseSoundsEnabled": true,
"randomSoundsEnabled": false
}
Soundpacks
Included Packs
AcousticKey includes 4 pre-bundled packs from Mechvibes:
- Cherry MX Blue - Clicky (
cherrymx-blue-pbt)
- Cherry MX Brown - Tactile (
cherrymx-brown-pbt)
- Cherry MX Red - Linear (
cherrymx-red-pbt)
- EG Oreo - Creamy (
eg-oreo)
- Built-in Defaults -
default-keyboard / default-mouse
Adding Custom Soundpacks
- Press
K → click Open Folder (or manually open .minecraft/config/acoustickey/soundpacks/).
- Add a folder containing a MechVibes++ style
config.json and corresponding audio files.
- Click Refresh in-game to load the new pack.
Supported Formats: Only .ogg and .wav audio formats are supported. .m4a and .mp3 files are automatically ignored.
Convert files using Audacity (Export → Ogg) or ffmpeg:
ffmpeg -i sound.m4a -c:a libvorbis sound.ogg
Don't forget to update the file extension paths inside your pack's config.json to .ogg.
Directory Structure
Keyboard and mouse soundpacks are stored separately:
.minecraft/
└── config/
├── acoustickey.json
└── acoustickey/
├── soundpacks/ <-- Keyboard packs
│ ├── cherrymx-blue-pbt/
│ ├── eg-oreo/
│ └── my-pack/
└── mousepacks/ <-- Mouse packs
├── logi-g502/
└── my-mouse/
Installation
Prerequisites
- Fabric Loader:
≥ 0.19.3
- Java:
21
- Fabric API
Setup Steps
- Install Fabric Loader for your game version.
- Place
fabric-api.jar into your .minecraft/mods/ directory.
- Place the mod into your
.minecraft/mods/ directory.
- Launch Minecraft.
FAQ
Can I rebind the menu or mute key?
Yes. Go to Esc → Options → Controls → AcousticKey, select the action, and press your desired key.
Why is there no sound playing?
- Press
M to make sure mute is not active.
- Check both volume sliders in the
K menu.
- Open your selected pack's directory and make sure the audio files are strictly
.ogg or .wav.
- Switch to a bundled pack (such as
cherrymx-blue-pbt) to see if the problem is pack-specific.
Why are mouse clicks silent while keyboard keys work?
Make sure Mouse: ON is selected in the control panel, and make sure your active mouse's soundpack has valid .ogg or .wav audio files. Switching to default-mouse resolves missing audio problems.
Credits
- MechVibes - Original soundpack framework
- MechVibes++ - Extended soundpack specification & editor
- Built using OpenAL and a custom OGG decoder for low-latency playback
评论 0
登录后参与评分
还没有评论,来抢沙发吧