AnyPS5 installeren: downloaden, converteren en starten

Bij de voorbereiding van AnyPS5 converteer je programma en modules en zet je daarna de benodigde bibliotheken en resources klaar. Door die stappen te scheiden kun je een mislukte start makkelijker onderzoeken.

Deze handleiding gebruikt de officiële v0.1.2-bestanden en gebruiksinstructies voor Windows- of Linux-uitvoer.

Voordat je begint

Leg dit klaar:

• Een schoon, ontsleuteld ELF-programma met bijbehorende modules en resources die je mag gebruiken. Een versleuteld pakket of SELF/fSELF-container is geen kant-en-klare invoer.
• Een relinker en doelbibliotheekpakket van dezelfde release via AnyPS5 op GitHub.
• De controles uit de AnyPS5-vereisten, waaronder Vulkan en de benodigde CPU-instructies.
• Titel-ID, contentversie en build uit AnyPS5-games als je een resultaat volgt. Bewaar speciale argumenten en patchvoorwaarden bij de instructies.

1. Bijpassende releasebestanden downloaden

Open de officiële v0.1.2-release en kies het doelsysteem:

De pakketten bestaan ook in het andere archiefformaat. Pak de bibliotheken uit en bewaar ze voor stap 4. Windows bevat naast vervangende bibliotheken ook libgcc_s_seh-1.dll, libstdc++-6.dll en libwinpthread-1.dll.

2. De invoer klaarzetten

Een eenvoudige werkmap ziet er zo uit:

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

Het ELF-bestand mag anders heten, bijvoorbeeld eboot.bin: de inhoud bepaalt of het geschikt is. Gebruik de modulemap die bij je bestanden zit; hernoem niet elke game om het voorbeeld te volgen.

De relinker herkent sce_module/, sce_modules/ en prx/. prx/ mag naast een van de andere twee bestaan. Zowel sce_module/ als sce_modules/ tegelijk is een fout; geen van de drie mappen ook. Alleen bestanden direct in deze mappen worden gescand.

Voor modules elders wijst --sce-module-path <path> naar hun bovenliggende map, met een absoluut pad of een pad relatief aan je werkmap. Extra modulemappen kunnen herhaalbare --module-dir-argumenten vereisen. Volg het gamecommando in plaats van aan te nemen dat standaardmappen altijd genoeg zijn.

3. De relinker uitvoeren

Open een terminal in de map van de relinker. Deze voorbeelden gebruiken de invoer hierboven en schrijven de uitvoer naast het gereedschap.

Windows PowerShell

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

Laat --windows staan: de naam app.exe alleen levert nog steeds het standaard Linux ELF-formaat op.

Linux

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

Voor een Intel-host converteren

Voeg op de gedocumenteerde Intel-route --to-intel toe:

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

Dit herschrijft ondersteunde AMD-specifieke instructies in programma en modules. Het kan geen AMD-specifieke instructies behandelen die de game tijdens uitvoering genereert. Stopt de conversie, bewaar dan eerst de fout voordat je bestanden verplaatst of van build wisselt.

4. De uitvoermap samenstellen

Zet geconverteerd programma, vervangende doelbibliotheken en gameresources op hun eigen plaatsen:

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

De relinker meldt het exacte pad van elke module als Guest module:. Gebruik die gegenereerde bestanden en bewaar de mapnamen: een invoermap sce_modules/ of prx/ houdt die naam onder app0/. Kopieer gameresources apart met behoud van relatieve paden.

libs/ is voor AnyPS5-bibliotheken die voor het uitvoersysteem zijn gebouwd, niet voor originele console-.prx-modules. Op Windows horen de drie MinGW-DLL’s ook in libs/. Een andere PATH-vermelding aanpassen vervangt geen ontbrekend bestand daar.

Start vanuit de samengestelde map:

.\app.exe

Op Linux:

chmod +x app.elf
./app.elf

Opent een game consolesysteemfonts, dan kan anyps5-fonts/ naast het programma nodig zijn, of een map via ANYPS5_SYSTEM_FONTS. De handleiding noemt originele fontnamen en ondersteunde open Noto-alternatieven. Gewone resources in app0/ vervangen deze systeemfonts niet.

5. De besturing controleren

De v0.1.2-invoergids beschrijft SDL-controllers en standaardtoetsenbord-/muisbediening. De eerste herkende controller wordt gebruikt. Xbox A/B/X/Y worden Cross/Circle/Square/Triangle; analoge sticks en triggers worden doorgegeven. De PlayStation-touchpadklik wordt verwerkt, vingercoördinaten zijn niet geïmplementeerd.

Maak voor aangepaste toetsenbord- of muisbediening anyps5-input.ini naast het gegenereerde programma, bijvoorbeeld:

Cross = KEY:Space
Options = KEY:Return

Gebruik ANYPS5_INPUT_CONFIG voor een bestand elders. Niet genoemde acties behouden hun standaard; deze aanpassingen wijzigen geen controllerknoppen. Een ongeldige regel meldt bestand en regelnummer en stopt de invoerinitialisatie. Controleer die fout voordat je de controller zelf onderzoekt.

Optioneel: het volledige project uit broncode bouwen

Gebruik dit voor een vastgelegde commit of werk aan de runtime. Installeer compiler en afhankelijkheden uit de AnyPS5-vereisten en volg de versiegebonden bouwgids:

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

Kies voor een ander resultaat de vermelde revisie in plaats van v0.1.2, met alle apart beschreven patches. Kopieer de doelbibliotheken uit build/core/libs/libs/. Alleen de relinker bouwen produceert deze niet; alleen het programma herbouwen na een bibliotheekwijziging laat de oude runtime in gebruik.

Maak de eerste poging bruikbaar

Noteer of het stopt tijdens conversie, bibliotheken laden, logo’s, menu’s of gameplay. Bewaar de eerste fout en eventuele speciale levelroute.

Doorloop de AnyPS5-probleemoplossing als het stopt. Voor de browseroptie lees je de AnyPS5-webconverter, inclusief aparte invoer- en opslaglimieten.