订阅以下载
MusicPlayer - 自定义播放器

🎵 自定义音乐播放器 | Custom Music Player

想在游戏中播放你最喜欢的音乐吗？这个Mod允许你使用自己的音乐文件替换或添加游戏背景音乐！
支持MP3、WAV、OGG、FLAC等多种音频格式

📝 使用方法：
1. 订阅此Mod，并打开游戏的根目录(在Steam上面，右键游戏--管理--浏览本地文件)
2. 在根目录下面，创建文件夹：`MusicPlayer`
3. 将想要的音乐放在这个文件夹中
4. 进入游戏，在留声机直接切换即可！

📁 文件结构：
[游戏根目录]/
├── Duckov.exe # 游戏主程序
└── MusicPlayer/ # 创建此文件夹
├── MusicPlayer/music_config.json # 自动生成的配置文件
├── MusicPlayer/Bgm1.mp3
├── MusicPlayer/Bgm2.mp3
└── MusicPlayer/Bgm3.ogg

⚙️ 配置说明：
首次启动游戏后会自动生成 `music_config.json` 配置文件，你可以：
• shuffle_playback：设置为 true 开启随机播放
• custom_music_list：指定播放列表（留空则播放所有音乐）
• loaded_music：自动生成的可用音乐列表（方便你复制到自定义列表）

配置示例：
{
"shuffle_playback": false, // 是否随机播放
"custom_music_list": ["歌曲1", "歌曲2"], // 自定义播放列表（留空播放全部）
"loaded_music": [] // 自动生成，无需修改
}

🎉 2025/10/22 v1.3 更新内容：
1. ✅ 新增多格式支持：mp3, wav, ogg, flac, aiff, aif, mid, midi, it, s3m, mod, xm, fsb
2. ✅ 新增轮播功能：支持顺序/随机播放，通过 music_config.json 配置
3. ✅ 新增自定义播放列表：可指定播放特定歌曲
4. ✅ 新增配置持久化：你的设置会被保留，不会被覆盖
5. ✅ 新增配置容错机制：配置文件损坏时自动备份并重建
6. ✅ 修复只能看到一首歌曲的bug

🔮 后续计划：
1. 支持大厅自定义音乐
2. 支持不同地图的自定义音乐

💡 提示：
• 配置文件写错了？不用担心，游戏会自动备份损坏的文件并创建新的
• 想恢复默认配置？直接删除 music_config.json 即可
• 你的播放设置（shuffle_playback 和 custom_music_list）不会被覆盖


English：
Please use translation to utilize this guide. Thank you (It is recommended to use an LLM language model for translation!).

Español：
Por favor, utilice la traducción para usar esta guía. Gracias (¡Se recomienda utilizar un modelo de lenguaje LLM para la traducción!).

Français：
Veuillez utiliser la traduction pour utiliser ce guide. Merci (Il est recommandé d'utiliser un modèle de langage LLM pour la traduction !).

Deutsch：
Bitte verwenden Sie die Übersetzung, um diese Anleitung zu nutzen. Danke (Es wird empfohlen, ein LLM-Sprachmodell für die Übersetzung zu verwenden!).

日本語：
このガイドを利用するには翻訳をご利用ください。ありがとうございます（翻訳にはLLM言語モデルの使用をお勧めします！）。

한국어：
이 가이드를 사용하려면 번역을 이용해 주세요. 감사합니다 (번역에는 LLM 언어 모델 사용을 권장합니다!).

Português：
Por favor, use a tradução para utilizar este guia. Obrigado (Recomenda-se o uso de um modelo de linguagem LLM para tradução!).

Italiano：
Si prega di utilizzare la traduzione per usare questa guida. Grazie (Si consiglia di utilizzare un modello linguistico LLM per la traduzione!).

Русский：
Пожалуйста, используйте перевод для использования этого руководства. Спасибо (Рекомендуется использовать языковую модель LLM для перевода!).