sa2

Sonic Advance 2

Это работа, соответствующая декомпиляции Sonic Advance 2

До сих пор строит следующие ПЗУ:

• SA2.GBA sha1: 7bcd6a07af7c894746fa28073fe0c0e34408022d (США) (EN, JA, FR, DE, ES, IT)
• SA2_EUROPE.GBA sha1: b0f64bdca097f2de8f05ac4c8caea2b80c5faeb1 (Европа) (EN, JA, FR, DE, ES, IT)
• SA2_JAPAN.GBA sha1: dffd0188fc78154b42b401398a224ae0713edf23 (Япония) (EN, JA, FR, DE, ES, IT) (: предупреждение: работа в процессе)

Текущее состояние

• ? Сборка сдвигается! Вы можете сделать любые дополнения/модификации кода или активов, которые вам нравятся, и большинство аспектов игры будут продолжать функционировать.
• Код сборки извлечен, разобрался и несколько классифицирован
• Все библиотеки разбиты в C или ссылаются на agbcc
• Большинство аспектов игры, в том числе все взаимодействия, были разбиты до соответствующего C -кода. Большинство не были полностью задокументированы, но основные функции.
• Все песни были извлечены и задокументированы как соответствующие файлы MIDI
• Все рамки анимации Sprite были извлечены в PNG и используются для построения соответствующего ПЗУ
• Большинство тилевых (фонов) были задокументированы и извлекла их плитки

Сообщество

Присоединяйтесь к нам в Discord, чтобы начать помощь

Настройка репозитория

Разработчик контейнер

Если вы используете vscode , рассмотрите возможность использования предоставленного Dev Container, который пропускает требование для любой настройки. Это требует, чтобы Docker был установлен в вашей системе. После бега пропустите, чтобы построить ПЗУ

Установить системные требования (без контейнера Dev)

На Linux Systems

 sudo apt install build-essential binutils-arm-none-eabi gcc-arm-none-eabi libpng-dev xorg-dev libsdl2-dev gcc-mingw-w64 libarchive-tools

На macOS и Windows установить DevKitarm

Установите agbcc в репо

Клонировать репо agbcc в другую папку

Внутри agbcc Repo и запустите ./build.sh , а затем установите компилятор в этом репо ./install.sh path/to/sa2

Построить ПЗУ

На Linux и MacOS запустите, make в корне репо, чтобы построить.

В Windows вы можете построить, используя make в среде MSYS, предоставленную DevKitarm.

Эта команда также создаст все необходимые инструменты в каталоге tools . Справочник tools содержит кучу инструментов (созданных PRET), который используется для создания активов и создания соответствующего ПЗУ.

Если ROM успешно построен, вы увидите этот вывод

sa2.gba: OK

Примечание . Вы можете значительно ускорить начальное время сборки, пропустив количество процессов, которые вы хотите использовать для сборки сборки make -j<number>

Форматирование кода

Весь C-код в этом репо отформатирован с помощью clang-format-13 . При использовании Dev Container он установлен автоматически.

Для формата кода запустить make format

Примечания

• Kirby & The Amazing Mirror Decopilation использует очень похожую кодовую базу, так как она была написана той же командой разработчиков (DIMP)
• https://decomp.me - отличный ресурс для помощи в создании соответствующих функций
• ldscript.txt сообщает линкеру порядок, какой файлы должны быть связаны
• Для получения дополнительной информации см. Раздел FAQS TMC

Кредиты

• Выкрикивайте @froggestspirit для диска, чтобы настроить этот проект
• Особое спасибо @Normmatt за первоначальную настройку репо и разъединение звучит
• Jacecear за его преданность пониманию внутренних групп графического двигателя и инструментов записи для извлечения этих данных, а также огромных усилий для участия в процессе декомпиляции
• Команда Pokemon Reverse Engineering за их помощь в проекте и инструменты для декомпиляций GBA
• Kermalis для их инструмента, который использовался для сброса игры Midis
• 琪姬 За их чрезмерную работу, документируя все причуды соответствующих MIDIS