使用说明

预准备

注

本项目无特殊依赖，只需要正确安装 Python 3 即可。

脚本下载

你可以在 Arcaea-Bundler 项目仓库中直接下载文件 main.py。考虑到易用性，本项目至今为止仍然是单文件脚本。

拆包文件准备

你需要准备捆绑包本体 *.cb 与其对应的元数据文件 *.json，后缀名并无特殊作用，仅对人类来说更容易分辨。

若你考虑拆解官方捆绑包，可以通过请求官方 API 的 /<Game API Prefix>/game/content_bundle 端点来获取下载链接，在此不会详细说明。

打包文件准备

打包需要提供一个文件夹，其中的内容和文件夹结构必须与 assets 文件夹一致，必须包含文件 songs/songlist、songs/packlist 和 songs/unlocks，请参考详细说明获取更多信息。

使用

可以使用 python main.py -h 来查看脚本总说明。

拆包

使用以下命令

python main.py d -i input.cb -m input.json -o output_dir

可解包一对内容捆绑包和元数据，其中 input.cb 是内容捆绑包的相对路径，input.json 是对应的元数据的相对路径，output_dir 是输出文件夹的相对路径。

解包

使用以下命令

python main.py b -i input_dir -o output_file_name -av app_verion -bv bundle_version

可对文件夹 input_dir 进行打包，其中 output_file_name 是输出的内容捆绑包与元数据的文件名（后缀固定），app_verion 是指定的客户端版本号，bundle_version 是指定的此捆绑包的版本号。

没写完且不知道要写啥.jpg

# 解包一对内容捆绑包和元数据
python main.py d -i input.cb -m input.json -o output_dir

# 打包一个文件夹
python main.py b -i input_dir -o output_file_name
# 打包一个文件夹，指定其相应版本
python main.py b -i input_dir -o output_file_name -av app_verion -bv bundle_version

# 获取所有参数说明
python main.py -h  # 总说明
python main.py d -h  # 解包器说明
python main.py b -h  # 打包器说明

当你第一次打包一个文件夹的时候，请指定版本信息，用 -av 指定此包用于的客户端版本号，用 -bv 指定包的版本号。第一次之后，程序会在 metadata.oldjson 中记录下过去的元数据，下次打包这个文件夹的时候就会自动生成版本号了。同时这意味着，往后对于此文件夹的打包只包含其中的改动项，而非全整合

打包文件夹等同于 assets 文件夹，必须包含文件 songs/songlist、songs/packlist 和 songs/unlocks