arcfutil

# 命令行工具

本节将介绍arcfutil提供的几个使用的CLI工具，它们被设计用于批量处理Arcaea相关的文件。

您的包管理工具应当自动创建这些CLI工具的二进制文件并处理环境变量，使得您在安装了arcfutil的Python环境下能够直接使用这些工具。如果环境变量没有被正确配置，pip在安装完毕可能会产生以下提示：

WARNING: The scripts arcadeclean, arcfutil, songlist and sortassets are installed in '/home/direwolf/.local/bin' which is not on PATH.
Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.

此时需要您手动将引号内的路径添加进环境变量，具体方法根据您使用的操作系统而有所不同。

当然，通过python3命令直接运行这些工具对应的.py模块也是可行的。

# arcadeclean

arcadeclean命令用于清理Arcade（或者其衍生版本）在谱面文件夹下产生的自动保存文件和备份文件。

在默认情况下，arcadeclean扫描当前的工作目录。如果想指定一个目录，则将目录作为参数传入：

arcadeclean ~/path/to/your/charts/

# sortassets

如果您查看过Arcaea的下载资源文件，则应该会注意到它们不太方便被可视化制谱器读取。sortassets命令可以将这些文件整理成方便被读取的形式。这个命令接受一个-d参数，指向您想要整理的/dl/文件夹:

sortassets -d ~/arcaea_output/blahblah/dl/

# songlist

注意

这是一个过时的模块。其中一些内容可能已经不再适用于当前版本的Arcaea。

songlist命令提供在songlist和songconfig.txt之间互相转换的功能。songconfig.txt是一种不受官方支持的，描述曲目信息的配置文件。它接受Arcaea资源文件夹作为必选参数（通常，这个文件夹内包含song，img等文件夹）。

同时，这个命令还给出了几个开关：

  • -r: 读取songlist，并为每个曲目创建songconfig.txt

  • -p: 自动建立packlist文件

  • -b: 自动检查并复制背景文件

  • -t: 在songlist中追加id为tempestissimo的曲目

假设有以下的目录结构。

 .
 ├- assets
 |     ├- img
 |     |   ├- bg
 |     |   └- ...
 |     ├- song
 |     |   ├- song1
 |     |   ├- song2
 |     |   └- ...
 |     └- ...
 └- ...

要创建songlist及自动处理所有文件：

songlist -pbt ./assets/

要从songlist创建songconfig.txt：

songlist -r ./assets/

← 图像处理 →