OngekiVoiceConverter

本工具旨在自动化以下流程：

1. 解包游戏资源文件（.acb + .awb）到独立目录
2. 将解包后的音频文件（.hca 和 .adx）转换为通用的 .wav 格式

---

安装与依赖

依赖

1. Python 3.10+
2. acb
3. vgmstream

使用说明

1. 配置脚本

修改脚本头部的变量以匹配你的环境：

PYTHON="C:/Python313/python.exe"        # Python 路径
VGMSTREAM="E:/Tools/vgmstream-cli.exe"  # vgmstream 路径
SOUND_DIR="D:/Game/Sound"               # 游戏音频目录（含 .acb 和 .awb 文件）
EXTRACTED_DIR="./extracted"             # 解包输出目录

2. 执行脚本

在 Bash 环境（Windows 可使用 Git Bash 或 WSL）下执行：

./converter.sh

3. 输出结构示例

extracted/  
├── ?/
│   ├── ?.hca  
│   ├── ?.wav  
│   └── ...  
├── ?_Story/  
│   ├── ?.adx  
│   └── ?.wav  
└── ...  

---

注意事项

• 路径问题：
  • Windows 路径建议使用正斜杠 / 或双反斜杠 \\
  • 确保 acb 和 vgmstream 路径正确且可执行
• 错误处理：
  • 如果解包失败，检查 .acb 和 .awb 文件是否成对存在
  • 转换失败时，错误信息会直接显示

---

贡献指南

• 提交 Issue：报告 bug 或提出新需求
• Pull Request：欢迎优化代码或添加功能
• 许可证：CC BY-NC 4.0

---

许可证

本作品采用 知识共享署名-非商业性使用 4.0 国际许可协议。 禁止用于商业目的，详情见LICENSE文件。