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 можно собрать в Windows с помощью MSYS2.

Сначала установите MSYS2, затем откройте оболочку MINGW64 и выполните следующую команду:

 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

Чтобы создать графический интерфейс, вам также необходимо установить Qt:

 pacman -S mingw-w64-x86_64-qt5

Затем создайте исполняемый файл(ы) с помощью мезона,

 mkdir build
meson build
ninja -C build

Исполняемый файл alice (расположенный по адресу build/src/alice.exe ) должен быть автономным и переносимым.

Исполняемый файл galice требует поставки некоторых дополнительных файлов из-за Qt. Выполните следующие команды, чтобы скопировать необходимые файлы для 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

У вас должны быть включены флейки (о том, как включить флейки, см. в документации 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

См. README-ex.md.

Редактирование файлов .acx

См. README-acx.md.

Редактирование .плоских файлов

См. README-flat.md.

Извлечение архивов

См. README-alice-ar.md.

Строительные проекты (.pje)

См. README-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
• Исправлена ​​ошибка, затрагивающая архивные файлы Ояко Ранкан.

Версия 0.12.1

• Устранение проблем с извлечением изображений .dcf и .pcf из Dohna Dohna
• Добавлена ​​опция в ain dump для дампа заглушек HLL для xsystem4.

Версия 0.12.0

• Добавьте программу просмотра графического пользовательского интерфейса («galice») для архивов, файлов AIN, ex-файлов и т. д.
• Реализация поддержки архивов AAR.
• Реализуйте правильную поддержку изображений DCF.
• Реализация поддержки изображений PCF.
• Добавьте команду cg thumbnail для создания миниатюр изображений в форматах AliceSoft.
• Исправлена ​​ошибка, из-за которой невозможно было открыть файлы Healing Touch ain.
• Различные улучшения компилятора

Версия 0.11.1

• Реализовать проверку размера файлов для AinInput и PactInput в файлах .pje.
• Реализовать поддержку моддинга архива пакта.
• Устранение проблем, затрагивающих файлы . Flat.

Версия 0.11.0

• Добавьте параметр --function в ain dump для дампа только определенной функции.
• Добавьте команду ex edit для поэтапного редактирования файлов .ex.
• Разрешить отображение файлов .txtex в процессе сборки .pje
• Разрешить указание исходных каталогов архива в файлах .inc.
• Разрешить (ограниченно) шаблоны подстановочных знаков каталога в файлах .inc
• Разрешить указание исходных файлов .jam в файлах .inc
• Реализация функции внедрения байт-кода для сборок .pje.

Версия 0.10.2

• Исправлена ​​проблема с кодировкой при использовании строк в кавычках в файлах манифеста.

Версия 0.10.1

• Поддержка извлечения архивов DLF и ALK.
• Устранение проблем с японскими именами файлов в Windows
• Разрешить использование строк в кавычках в архивных файлах манифеста.
• Различные улучшения компилятора .jaf.

Версия 0.10.0

• Добавить формат манифеста «BATCPACK» для команды ar pack
• Поддержка файлов v1 (Mamanyonyo)
• Добавить инструменты для редактирования .плоских файлов ( flat extract и flat build )
• Поддержка замены функции байт-кода (.jam) через файлы проекта .pje.
• Поддержка создания архивов и файлов .ex через файлы проекта .pje.
• Добавить команду project build для создания файлов .pje (заменяет ain edit -p )
• Добавьте команду cg convert для преобразования между типами компьютерной графики.
• Различные улучшения (все еще экспериментального) компилятора .jaf.

Версия 0.9.1

• Исправлена ​​проблема с кодировкой при использовании команды ar pack в Windows.

Версия 0.9.0

• Измените названия инструкций/типов ain v12+, чтобы лучше отражать их семантику.
• Реализуйте версии v14+ различных макросов.
• Автоматически выгружать файлы .ex/.pactex при распаковке архивов.
• Оглавление архива теперь можно переопределить при извлечении.
• Команда редактирования ain теперь обрабатывает файлы в порядке, указанном в командной строке.
• Команда редактирования ain теперь принимает опцию --jam для исправления раздела кода.
• Множество улучшений/исправлений (экспериментального) компилятора .jaf.
• Различные исправления ошибок

Версия 0.8.0

• Добавьте команду ar pack для создания архивов AFAv2.
• Устранение проблем с файлами ALD в Windows
• Поддержка индексации таблицы строк по значению при использовании команды ain edit -t

Версия 0.7.0

• Объедините все команды в один двоичный файл «Алиса».
• Исправлена ​​проблема с файлом .ain пробной версии Dohna Dohna.
• Исправлена ​​проблема с неэкранированными символами возврата каретки в выводе.
• Улучшение сообщений об ошибках

Версия 0.6.0

• Добавьте инструменты acxdump/acxbuild для редактирования файлов .acx.
• Поддержка извлечения файлов .ogg из архивов afa v3.
• Исправлен сбой при извлечении архива CG из версии Sengoku Rance для MangaGamer.
• Поддержка дампа/редактирования файлов .ain для Hentai Labyrinth и Evenicle 2 Clinical Trial Edition.

Версия 0.5.1

• Устранена проблема при выгрузке файлов AIN с кодировкой, несовместимой с ascii.

Версия 0.5.0

• !!! Нарушает совместимость байт-кода с предыдущими версиями!!!
• Удалены опции --inline-strings из aindump и ainedit.
• Строки теперь встраиваются в инструкции S_PUSH и т. д.
• Добавлено еще несколько макросов байт-кода.

Версия 0.4.0

• Добавлен инструмент alice-ar для извлечения архивных файлов.

Версия 0.3.0

• Теперь поддерживает файлы AIN до версии 14 (Evenicle 2, Haha Ranman).
• Улучшена совместимость файлов ex, теперь работает с Rance 03, Rance IX и Evenicle 2.
• aindump теперь по умолчанию генерирует инструкции макроса (облегчает чтение байт-кода)
• Большинство сообщений об ошибках теперь включают номера строк.

Версия 0.2.1

• Добавлены параметры --input-encoding и --output-encoding для управления кодировкой текста входных и выходных файлов.
• В ainedit добавлена ​​опция --transcode для изменения кодировки текста файла AIN.
• Исправлена ​​проблема, из-за которой параметр --split для exdump приводил к искажению имен файлов в Windows.

Версия 0.2.0

• Добавлены инструменты exdump и exbuild.

Версия 0.1.1

• Исправлена ​​проблема, из-за которой символы, отличные от ASCII, нельзя было повторно вставить с помощью ainedit -t

Версия 0.1.0

• Первоначальный выпуск
• Поддерживает создание дампов/редактирование файлов .ain до версии 12 (Rance X).