EquipmentTimers —— 完成提示音
================================

本目录（Assets/Audio）存放可编辑的完成提示音映射与你自己的 .wav 文件。这里不会下载任何内容，也不会上传任何内容：自定义音效只从本目录读取，并且只在本机播放。

文件
----
ready-sounds.json   每个计时完成时播放什么声音
<你的文件>.wav     可选的自定义音效，请放在本目录内

cue 名称（只有这些）
--------------------
weapon   主武器 / 副武器换弹完成
scanner  BioTracker 充能完成（默认：角色自己的 Scan 台词）
melee    近战蓄力达到满伤害
default  任何未在文件中单独列出的 cue 使用它

在 "cues" 中每行一个条目；每个条目都必须有 "type"：

  { "type": "native" }
      由 BepInEx 配置中的 ReadySoundEvent 选择的 Wwise 事件
      （默认 IMPLANTREADY）。这是 1.0.9 之前的行为。

  { "type": "playerVoice", "event": "PLAY_CL_SCAN" }
      当前角色自己的原生 "Scan" 台词，经游戏的 PlayerVoiceManager 播放。
      仅接受这些符号：PLAY_CL_SCAN。

  { "type": "wwise", "event": "BUTTONGENERICBLIPONE" }
      原版 Wwise 事件。接受的符号：IMPLANTREADY、IMPLANTREADYSMALL、
      HUD_SCAN_COMPLETE_INDICATION、BUTTONGENERICBLIPACTIVATED、
      BUTTONGENERICBLIPONE、PLAY_CL_SCAN。

  { "type": "wav", "file": "my ready.wav", "volume": 1.0 }
      来自本目录的本地文件（允许子目录，例如 "custom/melee.wav"）。
      "volume" 可省略，范围 0.0 - 1.0。

  { "type": "none" }
      该 cue 静音（绿色 READY 标签仍会出现）。

WAV 格式
--------
标准 RIFF/WAVE，PCM 8/16/24/32-bit 或 32-bit float，单声道或双声道，
8 kHz - 192 kHz，最长 30 秒、最大 32 MB。压缩格式（ADPCM、MP3 等）
一律拒绝。文件缺失或损坏时会改为播放原生事件，并只记录一条警告；
它绝不会打断计时。

限制与安全
----------
* 只读取本目录内的文件。绝对路径、盘符与 ".." 一律拒绝。
* 本 MOD 不会向本目录写入任何内容，也绝不会为音效发起任何网络请求。
* 插件加载时读取改动；编辑后请重启 GTFO。

如果该 JSON 无法解析，先前生效的映射会继续使用，并记录一条警告。
在 BepInEx 配置中把 CustomReadySounds=false 可完全忽略本文件，
并让所有 cue 都使用 ReadySoundEvent。