alice tools

爱丽丝工具

这是一个命令行工具的集合，用于查看和编辑 AliceSoft 游戏中使用的文件格式。

建筑

首先安装依赖项（括号内对应Debian包）：

• 野牛（野牛）
• 弯曲（弯曲）
• 介子（介子）
• libpng（libpng-dev）
• libturbojpeg (libturbojpeg0-dev)
• libwebp (libwebp-dev)
• zlib（zlib1g-dev）

然后获取 git 子模块，

 git submodule init
git submodule update

（或者，在克隆此存储库时传递--recurse-submodules ）

然后用介子构建工具，

 mkdir build
meson build
ninja -C build

视窗

alice-tools 可以使用 MSYS2 在 Windows 上构建。

首先安装MSYS2，然后打开MINGW64 shell并运行以下命令，

 pacman -S flex bison 
    mingw-w64-x86_64-gcc 
    mingw-w64-x86_64-meson 
    mingw-w64-x86_64-pkg-config 
    mingw-w64-x86_64-libpng 
    mingw-w64-x86_64-libjpeg-turbo 
    mingw-w64-x86_64-libwebp

要构建 GUI，您还必须安装 Qt：

 pacman -S mingw-w64-x86_64-qt5

然后用介子构建可执行文件，

 mkdir build
meson build
ninja -C build

alice可执行文件（位于build/src/alice.exe ）应该是独立且可移植的。

由于 Qt， galice可执行文件需要附带一些额外的文件。运行以下命令复制 Qt 所需的文件，

 mkdir deploy
cp build/src/galice.exe deploy/
windeployqt deploy/galice.exe

此时， deploy目录中仍然缺少一些 DLL。您可以运行以下命令来确定所需的 DLL，

 ldd build/src/galice.exe | grep mingw64

安装

从源头

如果您已按照上述说明从源代码构建 alice-tools，请运行

 ninja -C build install

安装它。

尼克斯

alice-tools 可以通过 nix 使用以下命令安装：

 nix profile install git+https://github.com/nunuhara/alice-tools.git?submodules=1

您必须启用 Flakes（有关如何启用 Flakes 的信息，请参阅 nix 文档）。

视窗

提供的 Windows 版本是可移植的，因此无需安装。只需从命令提示符运行提供的可执行文件 (alice.exe)。

用法

所有工具都可以通过单个alice可执行文件访问。运行alice或任何不带参数的命令将打印相关的使用说明。例如

 alice
alice ain
alice ain dump

目前实现的命令有：

 alice acx     build     - Build a .acx file from a .csv
alice acx     dump      - Dump the contents of a .acx file to .csv
alice ain     compare   - Compare .ain files
alice ain     dump      - Dump various info fram a .ain file
alice ain     edit      - Edit a .ain file
alice asd     build     - Build a save file
alice asd     dump      - Dump a save file
alice ar      extract   - Extract an archive file
alice ar      list      - List the contents of an archive file
alice ar      pack      - Create an archive file
alice cg      convert   - Convert a CG file to another format
alice cg      thumbnail - Create a thumbnail for a CG file
alice ex      build     - Build a .ex file
alice ex      compare   - Compare .ex files
alice ex      dump      - Dump the contents of a .ex file
alice flat    build     - Build a .flat file
alice flat    extract   - Extract the contents of a .flat file
alice project build     - Build a .pje project file

编辑 .ain 文件

请参阅 README-ain.md

编辑 .ex 文件

请参阅自述文件-ex.md

编辑 .acx 文件

请参阅自述文件-acx.md

编辑 .flat 文件

请参阅自述文件-flat.md

提取档案

请参阅自述文件-alice-ar.md

建设项目 (.pje)

请参阅自述文件-project.md

已知限制/错误

• aindump 仅支持转储到单个文件，该文件可能非常大。

源代码

源代码可以在 github 上找到。

报告错误

您可以在 github 上的问题跟踪器上报告错误，通过电子邮件联系我 [email protected]，或者在 /haniho/ 上找到我。

版本历史

版本0.13.0

• 添加asd dump和asd build命令以进行保存文件编辑
• 正确实施afa版本1档案的打包
• 修复存档清单中多次列出同一输出目录时的错误
• 允许在清单文件中指定选项（例如#BATCHPACK --afa-version=1 --backslash ）
• 改进对非 ASCII 命令行输入的处理
• 修复使用--split选项进行ex dump时的错误
• 修复影响 Oyako Rankan 存档文件的错误

版本0.12.1

• 修复从 Dohna Dohna 提取 .dcf 和 .pcf 图像的问题
• 向ain dump添加选项以转储 xsystem4 的 HLL 存根

版本0.12.0

• 添加用于存档、ain 文件、ex 文件等的 GUI 查看器（“galice”）
• 实施对 AAR 档案的支持
• 实施适当的 DCF 图像支持
• 实施 PCF 图像支持
• 添加cg thumbnail命令用于缩略图 AliceSoft 的图像格式
• 修复了无法打开 Healing Touch ain 文件的问题
• 各种编译器改进

版本0.11.1

• 在 .pje 文件中实现 AinInput 和 PactInput 的文件大小检查
• 实现对 pact archive modding 的支持
• 修复影响 .flat 文件的问题

版本0.11.0

• 将--function选项添加到ain dump以仅转储特定函数
• 添加ex edit命令以对 .ex 文件进行增量编辑
• 允许列出 .txtex 文件作为 .pje 构建过程的一部分
• 允许在 .inc 文件中指定存档源目录
• .inc 文件中允许（有限）目录通配符模式
• 允许在 .inc 文件中指定 .jam 源文件
• 为 .pje 构建实现字节码注入功能

版本0.10.2

• 修复在清单文件中使用带引号的字符串时的编码问题

版本0.10.1

• 支持提取DLF和ALK档案
• 修复 Windows 上的日语文件名问题
• 允许在存档清单文件中使用带引号的字符串
• 对 .jaf 编译器的各种改进

版本0.10.0

• 为ar pack命令添加“BATCHPACK”清单格式
• 支持 ain v1 文件 (Mamanyonyo)
• 添加用于编辑 .flat 文件的工具（ flat extract和flat build ）
• 支持通过.pje项目文件替换字节码函数（.jam）
• 支持通过 .pje 项目文件构建档案和 .ex 文件
• 添加用于构建 .pje 文件的project build命令（替换ain edit -p ）
• 添加cg convert命令以在 CG 类型之间进行转换
• 对（仍处于实验阶段）.jaf 编译器的各种改进

版本0.9.1

• 修复在 Windows 上使用ar pack命令时的编码问题

版本0.9.0

• 更改 ain v12+ 指令/类型的命名以更好地反映其语义
• 实现 ain v14+ 版本的各种宏
• 解压存档时自动转储 .ex/.pactex 文件
• 现在提取时可以覆盖存档的目录
• ain edit 命令现在按照命令行上给出的顺序处理文件
• ain edit 命令现在接受 --jam 选项来修补代码部分
• 对（实验性）.jaf 编译器的许多改进/修复
• 各种错误修复

版本0.8.0

• 添加ar pack命令用于创建 AFAv2 存档
• 修复 Windows 上的 ALD 文件问题
• 使用ain edit -t命令时支持按值索引字符串表

版本0.7.0

• 将所有命令组合成单个二进制“alice”
• 修复 Dohna Dohna 试用版 .ain 文件的问题
• 修复输出中未转义回车符的问题
• 改进错误消息

版本0.6.0

• 添加 acxdump/acxbuild 工具用于编辑 .acx 文件
• 支持从 afa v3 档案中提取 .ogg 文件
• 修复从 MangaGamer 版本的 Sengoku Rance 中提取 CG 存档时的崩溃问题
• 支持转储/编辑 Hentai Labyrinth 和 Evenicle 2 临床试验版的 .ain 文件

版本0.5.1

• 修复了转储具有与 ascii 不兼容编码的 ain 文件时的问题

版本0.5.0

• ！！！破坏了与以前版本的字节码兼容性！
• 从 aindump 和 ainedit 中删除了--inline-strings选项
• 字符串现在内联在S_PUSH指令等中。
• 添加了更多字节码宏

版本0.4.0

• 添加了 alice-ar 工具用于提取存档文件

版本0.3.0

• 现在支持高达版本 14 的 ain 文件（Evenicle 2、Haha Ranman）
• 改进了 ex 文件兼容性，现在可与 Rance 03、Rance IX 和 Evenicle 2 配合使用
• aindump 现在默认发出宏指令（使字节码更易于阅读）
• 大多数错误消息现在都包含行号

版本0.2.1

• 添加了--input-encoding和--output-encoding选项来控制输入和输出文件的文本编码
• 向 ainedit 添加了--transcode选项以更改 ain 文件的文本编码
• 修复了 exdump 的--split选项会在 Windows 上产生乱码文件名的问题

版本0.2.0

• 添加了 exdump 和 exbuild 工具

版本0.1.1

• 修复了无法使用ainedit -t重新插入非 ASCII 字符的问题

版本0.1.0

• 初次发布
• 支持转储/编辑 .ain 文件直至版本 12 (Rance X)