起步

本页帮助你在最短时间内完成安装、放置音频文件并验证替换是否生效。

安装

• 将本 Mod 放入游戏 Mods/ 目录，确认能正常加载（详见仓库根 README.md）。
• 首次启动会生成 DuckovCustomSounds/settings.json 与各模块的默认配置文件。

最小可用目录

你可以只准备最少量的音频文件，即可验证替换：

DuckovCustomSounds/
├─ TitleBGM/
│  └─ title.mp3                # 标题页音乐
├─ HomeBGM/
│  ├─ 示例曲目A.mp3
│  └─ 示例曲目B.mp3
└─ CustomEnemySounds/
   └─ voice_rules.json         # 首次启动可自动生成模板

• 建议使用 .mp3；不同模块支持的格式略有差异（见各模块页）。
• 文件放置到根目录即“Default”资源；后续可使用“声音包”在多套资源间切换。

声音包切换（可选）

• 在 DuckovCustomSounds/ 下创建一个子文件夹（例如 MyPack/），并放入与根目录一致的模块结构与音频。
• 在子文件夹内创建 pack.json（见“声音包系统”页面的规范与模板）。
• 在游戏的 ModConfig UI 选择你的声音包；重启游戏后生效。

验证

1. 进入标题页，确认 TitleBGM/title.mp3 是否播放。
2. 进入主页，确认 HomeBGM 曲库能够切换（支持自动播放下一首、随机播放等，参见“BGM”页）。
3. 进入对局，测试敌人语音或其他模块（枪械/脚步/物品等）是否触发；如不生效请开启对应模块的 Debug 或查看日志。

日志与排错

• 本 Mod 使用统一日志系统。若遇到路径不匹配、文件未找到等问题，打开相关模块的 Debug 级别查看解析过程。
• 你也可以在 DuckovCustomSounds/ 放置 debug_off 或 .nolog 文件快速关闭日志。
• 详细见“高级 > 日志与排错”。

下一步

• 若需要整套资源快速切换，阅读“模块 > 声音包系统”。
• 若要定制 BGM（标题/主页/撤离/场景/Boss），阅读“模块 > BGM”各页。
• 若要定制敌人语音、脚步声、枪械、近战、手雷、物品与击杀反馈，跳转对应模块页。