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)