Настройка AnyPS5: скачивание, конвертация и подготовка запуска

Настройте AnyPS5, преобразовав исполняемый файл игры и модули, а затем разместив загружаемые библиотеки и ресурсы. Разделение этих частей упрощает поиск причины неудачного запуска.

Инструкция настройки AnyPS5 использует официальные файлы v0.1.2 и руководство по использованию, чтобы подготовить результат для Windows или Linux.

Перед началом

Подготовьте:

• Чистый расшифрованный ELF с сопутствующими модулями и ресурсами, с необходимыми правами на их использование. Зашифрованный пакет или контейнер SELF/fSELF не является готовым входом конвертации.
• Согласованные релинкер и пакет библиотек целевой системы из AnyPS5 GitHub.
• Проверенную среду по странице Требования AnyPS5, включая Vulkan и нужные инструкции CPU.
• Title ID, версию содержимого и сборку из Игр AnyPS5, если повторяете отчёт. Держите специальные аргументы и условия патчей рядом с инструкциями.

Шаг 1: скачайте файлы одного релиза

Откройте официальный релиз v0.1.2 и выберите релинкер и библиотеки для целевой системы:

Пакеты предлагаются и в другом формате архива. Распакуйте библиотеки и сохраните содержимое для шага 4. Windows-пакет содержит libgcc_s_seh-1.dll, libstdc++-6.dll и libwinpthread-1.dll рядом с библиотеками-заменами.

Шаг 2: разместите входные файлы

Простой рабочий каталог выглядит так:

source/
    input.elf
    sce_module/
        bundled-module.prx

ELF может называться иначе, например eboot.bin; пригодность определяется содержимым. Используйте каталог модулей ваших файлов, не переименовывая каждую игру под пример.

Релинкер распознаёт sce_module/, sce_modules/ и prx/. prx/ может сосуществовать с одним из двух других имён. Одновременное наличие sce_module/ и sce_modules/, как и отсутствие всех трёх, — ошибка. Сканируются только файлы непосредственно внутри каталогов.

Для модулей в другом месте --sce-module-path <path> указывает их родительский каталог, абсолютным путём или относительно рабочего каталога. Дополнительным папкам могут требоваться повторяемые аргументы --module-dir; следуйте команде конкретной игры, а не считайте стандартные каталоги достаточными для любой.

Шаг 3: запустите релинкер

Откройте терминал в каталоге релинкера. Примеры используют показанное расположение и записывают результат рядом с инструментом.

Windows PowerShell

.\relinker-v0.1.2.exe --windows source\input.elf app.exe

Сохраните --windows: одно имя app.exe всё равно оставляет формат Linux ELF по умолчанию.

Linux

chmod +x relinker-v0.1.2
./relinker-v0.1.2 source/input.elf app.elf

Конвертация для компьютера Intel

Добавьте --to-intel, следуя документированному варианту для Intel:

.\relinker-v0.1.2.exe --windows --to-intel source\input.elf app.exe

Флаг переписывает поддерживаемые AMD-специфичные инструкции, найденные в программе и модулях. Инструкции AMD, создаваемые игрой во время выполнения, он не обрабатывает. Если конвертация остановилась, сохраните первую ошибку до перемещения файлов или смены сборки.

Шаг 4: соберите каталог запуска

Преобразованную программу, библиотеки целевой системы и игровые ресурсы держите в отдельных местах:

game_directory/
    app.exe                    # app.elf for Linux
    libs/
        libkernel.prx
        libScePad.prx
        ...                    # Matching AnyPS5 system libraries
        libgcc_s_seh-1.dll      # Windows package only
        libstdc++-6.dll
        libwinpthread-1.dll
    app0/
        sce_module/
            bundled-module.prx # Converted module, not the original console file
        ...                    # The game's resources

Релинкер выводит точный путь каждого преобразованного модуля как Guest module:. Используйте созданные файлы и сохраняйте названия каталогов: исходные sce_modules/ или prx/ остаются под тем же именем внутри app0/. Ресурсы копируйте отдельно с сохранением относительных путей.

libs/ предназначен для библиотек AnyPS5, собранных для выходной ОС. Оригинальным консольным .prx там не место. В Windows три DLL MinGW также должны лежать в libs/; изменение постороннего PATH не заменяет недостающий там файл.

Запускайте из подготовленной папки:

.\app.exe

В Linux:

chmod +x app.elf
./app.elf

Если игра открывает наборы системных шрифтов консоли, может требоваться anyps5-fonts/ рядом с программой либо каталог из ANYPS5_SYSTEM_FONTS. Документация перечисляет исходные имена шрифтов и поддерживаемые открытые замены Noto. Обычные игровые ресурсы в app0/ не заменяют эти наборы.

Шаг 5: проверьте управление

Руководство ввода v0.1.2 описывает контроллеры с раскладками SDL и встроенные назначения клавиатуры/мыши. Используется первый распознанный контроллер. Xbox A/B/X/Y соответствуют Cross/Circle/Square/Triangle; аналоговые стики и триггеры передаются дальше. Нажатие сенсорной панели PlayStation передаётся, координаты касания пальцем не реализованы.

Чтобы изменить клавиатуру или мышь, создайте anyps5-input.ini рядом с полученной программой, например:

Cross = KEY:Space
Options = KEY:Return

Для файла в другом месте задайте ANYPS5_INPUT_CONFIG. Пропущенные действия сохраняют значения по умолчанию; эти переопределения не меняют контроллер. Ошибочная строка выводит имя файла и номер строки и останавливает инициализацию ввода — сначала проверьте её, а не сам геймпад.

Дополнительно: полная сборка проекта из исходников

Этот путь нужен для конкретного коммита или работы над средой выполнения. Установите поддерживаемый компилятор и зависимости из Требований AnyPS5, затем следуйте документации выбранной версии:

git clone https://github.com/boykopovar/AnyPS5.git
cd AnyPS5
git checkout v0.1.2
git submodule update --init --recursive
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++
cmake --build build --parallel
cmake --build build --target libs --parallel

Для другого результата переключитесь на указанную в нём ревизию вместо v0.1.2, включая отдельно описанные патчи. Скопируйте целевые библиотеки из build/core/libs/libs/. Сборка одного релинкера их не создаёт; пересборка только программы после изменения библиотек оставляет старую среду запуска.

Сделайте первую попытку полезной

Запишите, где произошла остановка: конвертация, загрузка библиотек, логотипы, меню или игра. Отметьте первую ошибку и особый путь входа на уровень.

При остановке пройдите Решение проблем с AnyPS5. Вариант для браузера, включая раздельные лимиты входа и сохранения, описывает Веб-конвертер AnyPS5.