# 音效文件夹（随插件打包发布）

插件会读取这个目录里的 `.mp3`，用于点击、开关箱子等界面音效。

## 目录内容

本插件**自带** 5 个 Minecraft 游戏音效，开箱即用（总计约 60 KB）：

| 用途 | 文件名 | 大小 |
| --- | --- | --- |
| 点击（按钮 / 导航 / 任务卡片） | `ui-stonecutter-select_recipe-1.mp3` | 5.4 KB |
| 打开（控制台展开 / 弹窗打开 / 开关打开） | `block-chest-open-1.mp3` | 9.6 KB |
| 关闭（控制台收起 / 弹窗关闭 / 开关关闭） | `block-chest-close-1.mp3` | 10.8 KB |
| 成功 / 成就达成 / 升级 | `entity-firework_rocket-launch-1.mp3` | 27.2 KB |
| 出错 | `block-wooden_door-open-1.mp3` | 6.6 KB |

`hover`（悬停极轻的一下）不采样，由 WebAudio 现场合成，免得划过列表时太吵。

## 版权与许可（重要）

这 5 个文件是 **Mojang Studios / Microsoft 的游戏素材**，不属于本项目的 MIT 许可范围。
本插件是**非官方粉丝作品**，与 Mojang / Microsoft 无任何关联或背书；把它们随包
分发只是为了「主题听起来像原版游戏」这一粉丝目的，并没有取得权利方的单独授权。

- 如果你要 **fork / 二次发布**：请自行判断是否能保留这些文件。**删掉 `assets/sfx/*.mp3`
  也可以**——插件对每个音效都有合成兜底，删掉后界面照样有声，只是不那么像原版。
- 如果你想换成别的音色：直接替换同名文件即可，不用改代码、不用重新 build。
  想换文件名，就同步改 `src/30-audio.js` 顶部的 `MC_SAMPLE_NAMES` 映射。

## 缺失时的行为

某个文件缺失时，**只有那一个音效**退回合成音（WebAudio 现场合成）：

| 缺失的音效 | 兜底合成音 |
| --- | --- |
| click | 28 ms 噪声瞬态 + 196→150 Hz 三角波，约 90 ms 木质轻叩 |
| open / close / toggle | 咔哒 + 两音上/下行，约 126 / 130 ms |
| success | C5-E5-G5 上行琶音，约 345 ms |
| levelUp | C5-G5-C6 上行琶音，约 355 ms |
| error | 130→98 Hz 三角波 + 低频噪声，约 205 ms |

每个音效最多打一条 `console.warn`，不会刷屏、也不会抛错。