Утилита для моддинга игр на C/C++

Эта утилита призвана упростить написание модов для игр консолей 5-го и 6-го поколений на C/C++.

Она берёт на себя всю утомительную настройку, позволяя вам сосредоточиться на написании кода.
Без ручной настройки кросс-компилятора.
Без ручной пересборки ISO.
Без сложных процессов тестирования.

Возможности

• Поддержка PS1, PS2, GameCube и Wii
• Автоматическая загрузка необходимых компиляторов/инструментариев для выбранных платформ
• Интерфейсы GUI и CLI
• Пересборка ISO-образов игр с вашими изменениями кода
• Прямая инъекция в поддерживаемые эмуляторы для быстрого тестирования
• Поиск кодовых пещер и поиск перехватчиков каждого кадра
• Управление символами для нескольких версий
• И многое другое!

Нажмите здесь, чтобы перейти в Wiki

Быстрый старт:

Создание проекта

1. Нажмите «Create New Project» и дайте ему имя
2. Выберите платформу вашей игры
3. Нажмите «Extract ISO File» и выберите файл .iso/.bin/.ciso и т.д. вашей игры

2. Настройка кодовых пещер и перехватчиков

Нужна помощь в поиске кодовых пещер и перехватчиков? Инструмент включает:

• Поиск кодовых пещер — сканирует свободное пространство памяти и отладочные строки
• Автообнаружение перехватчиков — автоматически находит функции, выполняемые каждый кадр

3. Написание первого мода

Инструмент автоматически сгенерировал проект со всем необходимым. Отредактируйте src/main.c:

// src/main.c
void ModMain(void) {
    // Your mod code here
    player_health = 100;  // Invincibility
}

Работа с игровыми символами: Определите адреса в symbols/default.txt, объявите типы в include/symbols.h, затем используйте их как обычные переменные. Полное руководство по символам

3. Тестирование вашего мода

Нажмите Compile на вкладке сборки, чтобы скомпилировать ваш мод. Затем вы можете либо внедрить его в эмулятор для тестирования, либо собрать ISO!

Рекомендуемые инструменты

• Ghidra — это швейцарский армейский нож для реверс-инжиниринга. В сочетании с плагинами ниже он может сделать декомпиляцию игр гораздо более приятной: ~ PS1 Ghidra Plugin ~ PS2 Ghidra Plugin ~ Gamecube/Wii Ghidra Plugin ~ N64 Ghidra Plugin
• Bizhawk для поиска в памяти в играх PS1
• Cheat Engine для поиска в памяти в играх PS2 и других программах
• Dolphin Memory Engine для поиска в памяти в играх Gamecube/Wii
• P64 Dev для поиска в памяти в играх Nintendo 64
• VSCode или Sublime текстовые редакторы для автоматической интеграции с проектами

Поддерживаемые эмуляторы

Эмуляторы Gamecube/Wii

• Dolphin

Эмуляторы PS2

• PCSX2

Эмуляторы PS1

• Duckstation
• Mednefan 1.31
• Mednefan 1.29
• Bizhawk 2.6.1

Встроенные инструменты

• devkitPro — инструментарий GCC для процессора PowerPC Gamecube/Wii, а также утилиты для анализа .dol файлов
• ps2toolchain — инструментарий GCC для процессора Emotion Engine PS2.
• mkpsxiso для извлечения и пересборки образов дисков PS1.
• Ps2IsoTools для пересборки образов дисков PS2.
• gc_fst для извлечения и пересборки образов Gamecube.
• wiimms-iso-tools для извлечения и пересборки образов дисков Wii.
• DolphinTool для конвертации между различными форматами образов GC/Wii.
• dolphin-memory-engine для взаимодействия с памятью эмулятора Dolphin.
• pine для взаимодействия с памятью эмулятора PCSX2.
• xdelta для создания патч-файлов xdelta
• 7zip для решения величайших загадок жизни
• Real N64 CRC Tool для обновления CRC N64-образов

Особая благодарность

• Ebbe — за тестирование инструмента, сообщение об ошибках и предложение функций на протяжении его разработки
• Wafflewizard1 — за создание иконки

Контакт

Если вам нужна помощь в использовании этой утилиты, присоединяйтесь к сообществу в Discord: Присоединиться к Discord