如何快速解密游戏音频文件？acbDecrypter完整使用指南 🎮

acbDecrypter是一款免费开源的游戏音频解密工具，能够帮助用户将.acb和.awb格式的加密音频文件快速转换为通用的WAV格式。无论是游戏音乐爱好者还是开发者，都能通过这款工具轻松提取和播放游戏中的原声音乐。

🚀 一键安装步骤

1. 克隆仓库
   首先通过以下命令获取项目源码：

   git clone https://gitcode.com/gh_mirrors/ac/acbDecrypter
   

2. 环境准备
   确保系统已安装Python环境，通过项目根目录下的requirements.txt安装依赖：

   pip install -r requirements.txt
   

3. 启动工具
   直接运行根目录下的t.bat文件或执行python acbDecrypter.py即可启动程序。

📝 简单使用教程

基础操作流程

acbDecrypter提供两种便捷的文件处理方式：

• 拖拽解密
  将.acb或.awb文件直接拖拽到程序窗口，工具会自动分析文件类型并启动转换流程。

• 手动选择
  启动程序后通过文件选择对话框浏览并选择目标文件，适合批量处理多个音频文件。

转换完成后，WAV文件会自动保存到原文件同级目录下的同名文件夹中，并自动打开文件夹方便查看。

高级功能：密钥管理

若音频文件需要解密密钥，可通过以下步骤添加自定义密钥：

1. 打开hcaToWav/復号鍵リスト.txt
2. 按照密钥: 标题格式添加新密钥（例如：ABCD1234: 游戏主题曲）
3. 重启工具后即可自动识别新密钥

🛠️ 核心功能解析

多格式支持

工具集成了多个解码器组件，支持主流游戏音频格式：

• ACB/AWB解析：通过acbToHca/afs2.exe提取音频流
• HCA解码：使用hcaToWav/hca.exe转换为WAV格式
• ADX处理：通过adxToWav/adx.exe支持特殊加密音频

自动化处理流程

acbDecrypter的自动化处理流程示意图，展示从文件输入到WAV输出的完整路径

工具通过src/service/目录下的解密服务模块（如adxDecrypt.py、hcaDecrypt.py）实现全流程自动化，无需用户手动干预转换过程。

💡 常见问题解决

转换失败怎么办？

1. 检查文件完整性：确保.acb和.awb文件成对存在且未损坏
2. 更新密钥列表：某些游戏音频需要特定密钥，可在hcaToWav/復号鍵リスト.txt补充
3. 查看日志信息：转换过程中的详细日志会保存在service/目录下的临时文件中

支持哪些操作系统？

acbDecrypter基于Python开发，兼容Windows、macOS和Linux系统。Windows用户可直接使用预编译的批处理文件，其他系统需通过命令行运行Python脚本。

📚 项目结构说明

核心功能模块路径：

• UI界面：ui/目录下包含图形界面布局文件（如main.ui）
• 解密服务：service/目录实现核心解密逻辑
• 配置管理：src/config/scriptPath.py定义外部工具路径
• 文档说明：docs/目录包含流程图和操作指南

🌟 为什么选择acbDecrypter？

• 完全免费：开源项目无任何功能限制
• 简单高效：无需复杂配置，拖拽即可完成转换
• 持续更新：开发者定期维护，支持新游戏音频格式
• 多平台兼容：Windows/macOS/Linux全系统支持

无论是提取游戏原声收藏，还是研究音频编码技术，acbDecrypter都是您的不二之选！现在就尝试用它解锁游戏中的隐藏音乐吧～ 🎵