Instalasi AnyPS5: unduh, konversi dan siapkan runtime

Untuk memakai AnyPS5, konversi executable dan modul game, lalu susun pustaka serta sumber daya yang akan dimuat. Memisahkannya membuat kegagalan peluncuran lebih mudah ditelusuri.

Panduan ini menggunakan file resmi v0.1.2 dan petunjuk penggunaan untuk menyiapkan keluaran Windows atau Linux.

Sebelum mulai

• ELF bersih dan terdekripsi, modul serta sumber daya yang berhak Anda gunakan. Paket terenkripsi atau SELF/fSELF bukan input siap konversi.
• Relinker dan pustaka sistem tujuan dari rilis yang sama melalui GitHub AnyPS5.
• Pemeriksaan Vulkan dan instruksi CPU di persyaratan sistem AnyPS5.
• Jika mengikuti hasil tertentu, cocokkan title ID, versi konten dan build di game AnyPS5, termasuk argumen khusus dan patch.

Langkah 1: Unduh file rilis yang cocok

Buka v0.1.2 resmi dan pilih menurut tujuan:

Arsip pustaka juga ada dalam format lainnya. Ekstrak dan simpan untuk Langkah 4. Paket Windows mencakup libgcc_s_seh-1.dll, libstdc++-6.dll dan libwinpthread-1.dll bersama pustaka pengganti.

Langkah 2: Susun input

Contoh direktori sederhana:

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

ELF boleh bernama lain seperti eboot.bin; isinya yang menentukan format. Gunakan nama folder modul asli, jangan mengubah semua game hanya untuk menyerupai contoh.

Relinker mengenali sce_module/, sce_modules/ dan prx/. prx/ boleh bersama salah satu yang lain. Dua folder sce_module/ dan sce_modules/ sekaligus, atau tidak ada satu pun dari ketiganya, adalah error. Hanya file langsung di dalam folder yang dipindai.

Untuk lokasi lain, --sce-module-path <path> memilih direktori induk folder modul dengan path absolut atau relatif terhadap direktori kerja. Folder tambahan dapat memerlukan argumen --module-dir berulang; ikuti perintah game tersebut.

Langkah 3: Jalankan relinker

Buka terminal di direktori relinker. Contoh memakai input di atas dan menulis hasil di sebelah alat.

Windows PowerShell

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

Jangan hilangkan --windows: nama app.exe saja tetap menghasilkan Linux ELF bawaan.

Linux

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

Konversi untuk host Intel

Tambahkan --to-intel sesuai jalur Intel di dokumentasi:

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

Opsi ini menulis ulang instruksi AMD yang didukung pada executable dan modul. Instruksi yang dibuat game saat runtime tidak ditangani. Jika konversi berhenti, simpan error pertama sebelum memindahkan file atau mengganti build.

Langkah 4: Susun folder runtime

Pisahkan executable, pustaka tujuan dan sumber daya seperti berikut:

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

Relinker mencetak path tepat setiap modul hasil konversi sebagai Guest module:. Gunakan file tersebut dan pertahankan nama folder: sce_modules/ atau prx/ tetap bernama sama di dalam app0/. Salin sumber daya game secara terpisah sambil menjaga path relatif.

libs/ adalah tempat pustaka AnyPS5 untuk OS keluaran, bukan .prx konsol asli. Tiga DLL MinGW Windows juga harus ada di sini. Mengubah PATH lain tidak menggantikan file runtime yang hilang di folder tersebut.

Jalankan dari folder yang sudah disusun:

.\app.exe

Untuk Linux:

chmod +x app.elf
./app.elf

Jika game membuka font sistem konsol, siapkan anyps5-fonts/ di samping executable atau lokasi ANYPS5_SYSTEM_FONTS. Panduan penggunaan mencantumkan nama font asli dan pengganti Noto terbuka yang didukung. Sumber daya biasa di app0/ bukan pengganti font sistem itu.

Langkah 5: Periksa kontrol

Panduan input v0.1.2 menjelaskan kontroler SDL dan mapping keyboard/mouse bawaan. Kontroler pertama yang dikenali dipakai. Xbox A/B/X/Y memetakan Cross/Circle/Square/Triangle, dengan stik dan trigger analog. Klik touchpad PlayStation diteruskan; koordinat sentuhan jari belum diimplementasikan.

Untuk mengubah keyboard/mouse, buat anyps5-input.ini di samping executable:

Cross = KEY:Space
Options = KEY:Return

Untuk lokasi lain, atur ANYPS5_INPUT_CONFIG. Aksi yang tidak ditulis tetap memakai default; pengaturan ini tidak mengubah kontroler. Baris tidak valid menampilkan nama file dan nomor baris, lalu menghentikan inisialisasi input. Periksa itu sebelum menyalahkan perangkat.

Opsional: build proyek lengkap dari sumber

Gunakan cara ini untuk commit tertentu atau pengembangan runtime. Pasang compiler dan dependensi dari persyaratan sistem AnyPS5, lalu ikuti panduan build versi tetap:

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

Untuk hasil lain, checkout revisi laporannya menggantikan v0.1.2, termasuk patch yang didokumentasikan terpisah. Salin pustaka dari build/core/libs/libs/. Membangun relinker saja tidak menghasilkan pustaka; mengganti executable saja setelah perubahan pustaka masih meninggalkan runtime lama.

Jadikan percobaan pertama berguna

Catat apakah berhenti saat konversi, pemuatan pustaka, logo, menu atau gameplay. Simpan error pertama dan rute khusus menuju level.

Lanjutkan dengan solusi masalah AnyPS5. Opsi browser ada di konverter web AnyPS5, termasuk batas input dan penyimpanan yang terpisah.