Kom igång med AnyPS5: ladda ned, konvertera och förbered körmiljön

Förbered AnyPS5 genom att konvertera spelets körbara fil och moduler och sedan ordna biblioteken och resurserna som ska laddas. Att hålla delarna isär gör en misslyckad start lättare att undersöka.

Den här installationsguiden för AnyPS5 använder de officiella v0.1.2-filerna och användningsanvisningarna för Windows- eller Linux-resultat.

Innan du börjar

Ha följande klart:

• En ren, dekrypterad ELF samt tillhörande moduler och resurser, med de rättigheter och tillstånd som behövs. Ett krypterat paket eller en SELF/fSELF-behållare är inte färdig indata.
• En matchande relinker och bibliotekspaket för målsystemet från AnyPS5 GitHub.
• Miljökontrollerna under systemkrav för AnyPS5, inklusive Vulkan-enhet och relevanta CPU-instruktioner.
• Titel-ID, innehållsversion och bygge från AnyPS5-spel, om du följer ett rapporterat resultat. Ha särskilda argument och patchvillkor intill instruktionerna.

Steg 1: ladda ned matchande utgåvefiler

Öppna den officiella utgåvan v0.1.2 och välj relinker och biblioteksarkiv för målsystemet:

Paketen finns också i det andra arkivformatet. Packa upp biblioteksarkivet och behåll innehållet till steg 4. Windows-paketet innehåller libgcc_s_seh-1.dll, libstdc++-6.dll och libwinpthread-1.dll tillsammans med ersättningsbiblioteken.

Steg 2: ordna konverteringens indata

En enkel arbetskatalog kan se ut så här:

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

ELF-filen kan heta något annat, till exempel eboot.bin; det är innehållet som avgör om den passar. Använd modulkatalogen som följer dina filer i stället för att döpa om varje spel efter exemplet.

Relinkern känner igen sce_module/, sce_modules/ och prx/. prx/ kan finnas tillsammans med någon av de andra. Både sce_module/ och sce_modules/ samtidigt, eller ingen av de tre, ger ett fel. Bara filer direkt i katalogerna skannas.

För moduler på annan plats väljer --sce-module-path <path> deras överordnade katalog, med en absolut sökväg eller en relativ till arbetskatalogen. Ytterligare modulmappar kan kräva upprepade --module-dir-argument. Följ spelets dokumenterade kommando i stället för att anta att standardmapparna täcker allt.

Steg 3: kör relinkern

Öppna en terminal i katalogen med relinkern. Exemplen använder indata ovan och skriver resultatet bredvid verktyget.

Windows PowerShell

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

Behåll --windows: filnamnet app.exe väljer inte Windows utan ger fortfarande standardformatet Linux ELF.

Linux

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

Konvertering för en Intel-dator

Lägg till --to-intel när du följer den dokumenterade Intel-vägen:

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

Det skriver om de AMD-specifika instruktioner som stöds och hittas i programmet och modulerna. Det kan inte hantera AMD-specifika instruktioner som spelet genererar under körning. Stannar konverteringen, spara första felet innan du flyttar filer eller byter bygge.

Steg 4: bygg upp körkatalogen

Håll det konverterade programmet, målsystemets ersättningsbibliotek och spelresurserna på dessa separata platser:

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

Relinkern skriver varje konverterad moduls exakta sökväg som Guest module:. Använd de genererade filerna och behåll katalognamnen: indata i sce_modules/ eller prx/ får samma namn under app0/. Kopiera spelresurserna separat med bibehållna relativa sökvägar.

libs/ är till för AnyPS5-bibliotek byggda för resultatsystemet. Ursprungliga konsolmoduler .prx ska inte ligga där. I Windows hör även de tre MinGW-DLL-filerna hemma i libs/; en ändring av en orelaterad PATH-post ersätter inte en saknad fil där.

Starta från den färdiga katalogen:

.\app.exe

I Linux:

chmod +x app.elf
./app.elf

Om spelet öppnar konsolens systemtypsnitt kan det också behöva anyps5-fonts/ intill programmet, eller en katalog vald med ANYPS5_SYSTEM_FONTS. Användningsguiden listar originalfilnamn och öppna Noto-ersättare som stöds. Vanliga spelresurser i app0/ ersätter inte systemtypsnitten.

Steg 5: kontrollera styrningen

Inmatningsguiden för v0.1.2 beskriver SDL-mappade handkontroller och inbyggda tangentbords- och musbindningar. Den första identifierade kontrollen används. Xbox A/B/X/Y motsvarar Cross/Circle/Square/Triangle; analoga spakar och avtryckare vidarebefordras. Klick på PlayStations pekplatta skickas vidare, men fingerpositioner på plattan är inte implementerade.

För att ändra tangentbord eller mus, skapa anyps5-input.ini intill det genererade programmet, till exempel:

Cross = KEY:Space
Options = KEY:Return

Ange ANYPS5_INPUT_CONFIG för en fil på annan plats. Utelämnade åtgärder behåller standardvärdena och ändringarna påverkar inte handkontrollens bindningar. En ogiltig rad skriver ut filnamn och radnummer och stoppar inmatningens initiering. Kontrollera det felet innan du felsöker själva kontrollen.

Valfritt: bygg hela projektet från källkod

Välj detta när du behöver en bestämd commit eller vill arbeta med körmiljön. Installera stödd kompilator och beroenden enligt systemkraven för AnyPS5, följ sedan den versionsbundna byggguiden:

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

För ett annat resultat, checka ut den angivna revisionen i stället för v0.1.2, inklusive separat dokumenterade patchar. Kopiera målbiblioteken från build/core/libs/libs/. Att bara bygga relinkern skapar inte biblioteken; bygger du bara programmet efter en biblioteksändring används fortfarande den gamla körmiljön.

Gör första körningen användbar

Anteckna om försöket stannar vid konvertering, biblioteksladdning, logotyper, menyer eller spelande. Spara första felet och eventuell särskild väg in i en bana.

Arbeta igenom felsökning av AnyPS5 om det stannar. Läs om AnyPS5-webbkonverteraren för webbläsaralternativet och dess separata gränser för indata och sparning.