libretro/emulators/aps3e.yml

emulator: aPS3e
type: standalone
core_classification: community_fork
source: "https://github.com/aenu1/aps3e"
source_branch: main4
upstream: "https://github.com/RPCS3/rpcs3"
profiled_date: "2026-08-11"
source_commit: "4e579526bda21c2c51fc8512ad408a2004cc1798"
upstream_commit: "40e9ee5af0de7ca31691c58eebe64ba205a2900b"
core_version: "2.41"
display_name: "Sony - PlayStation 3 (aPS3e)"
cores:
  - aps3e
systems:
  - sony-playstation-3

notes: |
  PlayStation 3 emulator for Android, distributed on Google Play as aenu.aps3e
  and aenu.aps3e.premium. RPCS3 is vendored whole under app/src/main/cpp/rpcs3
  rather than pulled as a submodule, and a JNI layer of about six thousand lines
  replaces the Qt front end. The vendored tree reports itself as 0.0.41-alpha.1
  at RPCS3 commit 40e9ee5a.
  ref: app/src/main/cpp/rpcs3/rpcs3/git-version.h:3,
       app/src/main/cpp/rpcs3/rpcs3/rpcs3_version.cpp:29

  Source drops land on successive branches, not on the default one. Release 2.41
  of 2026-07-30 is the commit titled 2.41 at the head of main4; the lightweight
  tags 2.39, 2.40 and 2.41 all sit on the head of main2, an April tree that
  predates every one of those releases and whose generated git-version.h was
  never filled in. main4 is the tree read here. No versionName is usable either:
  the only gradle file committed is app/build.gradle.bak, which carries the
  placeholder 1.19a and is renamed and completed with the signing block at build
  time.
  ref: aps3e/README.md, app/build.gradle.bak:16

  Emulator paths derive from APS3E_DATA_DIR, set by the Java layer to the
  external files directory of the package. The config directory holds dev_flash,
  dev_hdd0, custom_cfg and the global config.yml; caches live beside it. The
  custom font directory sits at the data root, and the custom GPU driver
  directory sits in internal storage because the external filesystem cannot
  carry an executable mapping.
  ref: app/src/main/cpp/aps3e_rp3_impl.cpp:151-157,
       app/src/main/java/aenu/aps3e/Application.java:21-64

  The PS3 firmware is required and nothing runs without it. Three independent
  gates enforce it: the game list refuses to launch an entry when the marker
  config/dev_flash/.installed is absent, the quick start wizard keeps its Next
  button disabled on the firmware page until that marker exists, and the boot
  path itself returns firmware_missing when dev_flash/sys/external/liblv2.sprx
  is not a file. The third gate covers the intent launched directly against
  EmulatorActivity, which does not pass through the game list. The shipped
  configuration leaves Libraries Control empty, so liblv2.sprx keeps its default
  entry in the module list and the check fires.
  ref: app/src/main/java/aenu/aps3e/MainActivity.java:145-147,
       app/src/main/java/aenu/aps3e/MainActivity.java:189-192,
       app/src/main/java/aenu/aps3e/QuickStartActivity.java:318-320,
       app/src/main/cpp/rpcs3/rpcs3/Emu/System.cpp:2763-2783,
       app/src/main/cpp/rpcs3/rpcs3/Emu/Cell/lv2/sys_prx.cpp:86,
       aps3e/app/src/main/assets/config/config.yml

  Overlay text is drawn from a font list chosen by the Font File Selection
  setting. From Firmware, the default, asks for Arial.ttf, arial.ttf, the
  Android system face at /system/fonts/Roboto-Regular.ttf and then
  SCE-PS3-VR-R-LATIN.TTF for Latin, SCE-PS3-SR-R-JPN.TTF and SCE-PS3-DH-R-CGB.TTF
  for the CJK base, and SCE-PS3-YG-R-KOR.TTF for Hangul. The SCE faces are
  resolved against dev_flash/data/font and dev_flash/data/font/SONY-CC, so they
  come from the firmware rather than from a separate download. Custom points all
  three classes at one file and reverts to From Firmware when that path no
  longer exists.
  ref: app/src/main/cpp/aps3e_rp3_impl.cpp:216-246,
       app/src/main/cpp/rpcs3/rpcs3/Emu/RSX/Overlays/overlay_fonts.cpp:113-118

  Vulkan is reached through a loader chosen before the emulator starts. The
  global config YAML is read directly for Use Custom Driver and Custom Driver
  Library Path, and the named library is dlopened when both are set and the path
  exists; otherwise the system libvulkan.so is used. Drivers are imported either
  as a bare shared object or as a zip whose meta.json names the library.
  ref: app/src/main/cpp/aps3e_emu.cpp:1015-1039,
       app/src/main/cpp/vkapi.cpp:21,
       app/src/main/java/aenu/aps3e/EmulatorSettings.java:1235-1330

  Encrypted disc images are supported by a loader that has no counterpart in the
  desktop code line. Launching an ISO makes the Java layer look for a sidecar key
  beside it, trying the base name with .dkey and then with .key, and hand the
  descriptor down beside the image. The key is accepted at exactly 32 bytes, read
  as a hex string, or exactly 16 bytes, read as raw bytes, and installed as an
  AES-128 decryption context. A 3k3y watermark at offset 0xF70 is recognised
  separately and needs no key.
  ref: app/src/main/java/aenu/aps3e/Utils.java:200-220,
       app/src/main/java/aenu/aps3e/EmulatorActivity.java:149-155,
       app/src/main/cpp/rpcs3/rpcs3/Loader/iso.cpp:354-399,
       app/src/main/cpp/rpcs3/rpcs3/Loader/iso.cpp:508-554

  One import entry point takes EDAT, RAP and PKG. A RAP is copied verbatim into
  the exdata folder of user 00000001 and rejected unless it is exactly 16 bytes.
  An EDAT is parsed for its NPD header, rejected below 0x90 bytes or without the
  NPD magic, and written to the same folder under the content id the header
  carries. A PKG goes through the package reader and lands in dev_hdd0.
  ref: app/src/main/java/aenu/aps3e/MainActivity.java:700-711,
       app/src/main/java/aenu/aps3e/Emulator.java:820-844,
       app/src/main/cpp/aps3e_emu.cpp:941-969,
       app/src/main/cpp/aps3e_emu.cpp:923-933

  patch.yml, compatibility_table.json and database_config.json ship inside the
  APK as assets and are not user supplied.
  ref: aps3e/app/src/main/assets

files:
  - name: PS3UPDAT.PUP
    required: true
    storage: large_file
    description: "PS3 system software update package"
    note: >-
      Selected through the file picker and read from a descriptor. The PUP object
      rejects an empty file, a wrong magic, a declared size the file does not
      reach, an unreadable entry table and a failed entry hash. Segment 0x300
      carries the installation package database and segment 0x100 the version
      string; the packages whose names contain dev_flash_ are decrypted with the
      SCEPKG keys and their inner TARs extracted over dev_flash. The Java layer
      creates dev_flash/.installed once the native call returns true. No digest
      of the file itself is compared against anything.
    source_ref: "app/src/main/cpp/aps3e_emu.cpp:727-897, app/src/main/cpp/emulator_aps3e.cpp:1078, app/src/main/java/aenu/aps3e/MainActivity.java:644-676, app/src/main/res/values/strings.xml:132-134"

  - name: "<game>.dkey"
    aliases: ["<game>.key"]
    required: false
    size_options: [16, 32]
    validation: [size]
    unsourceable: "per-disc AES-128 key named after the image it decrypts, one per title, carried by disc dump catalogues rather than by the emulator"
    description: "Redump disc decryption key read beside an encrypted ISO"
    note: >-
      Resolved as a sidecar of the image being launched, .dkey first then .key,
      and passed down as a second descriptor. 32 bytes are read as a hex string
      and converted, 16 bytes are taken as raw; any other length fails the key
      check. An image whose odd regions are encrypted does not boot without it.
    source_ref: "app/src/main/java/aenu/aps3e/Utils.java:200-220, app/src/main/cpp/rpcs3/rpcs3/Loader/iso.cpp:354-399, app/src/main/cpp/rpcs3/rpcs3/Loader/iso.cpp:850-870"

  - name: "<content_id>.rap"
    required: false
    size: 16
    validation: [size]
    unsourceable: "per-title activation licence tied to the account that bought the content, never distributed generically"
    description: "PSN content licence"
    note: >-
      Imported through the EDAT/RAP/PKG entry and copied byte for byte into
      dev_hdd0/home/00000001/exdata under the name it was given. The import is
      refused unless the source is exactly 16 bytes. SELF decryption looks the
      matching file up in that folder by content id, with a lowercase extension.
    source_ref: "app/src/main/java/aenu/aps3e/MainActivity.java:702-706, app/src/main/java/aenu/aps3e/Emulator.java:820-844, app/src/main/cpp/rpcs3/rpcs3/Crypto/unself.cpp:1271-1286, app/src/main/cpp/rpcs3/rpcs3/Emu/system_utils.cpp:391"

  - name: "<content_id>.edat"
    required: false
    min_size: 144
    validation: [size]
    unsourceable: "per-content licensed data file, shipped with the content it belongs to"
    description: "Encrypted data file for licensed content"
    note: >-
      Imported through the same entry. The NPD header is read and the file
      refused below 0x90 bytes or when the magic is not NPD, then written whole
      to dev_hdd0/home/00000001/exdata under the content id the header declares.
    source_ref: "app/src/main/java/aenu/aps3e/MainActivity.java:707-711, app/src/main/cpp/aps3e_emu.cpp:941-969, app/src/main/cpp/emulator_aps3e.cpp:1085, app/src/main/cpp/rpcs3/rpcs3/Emu/system_utils.cpp:413"

  - name: "<font>.ttf"
    aliases: ["<font>.ttc", "<font>.otf"]
    required: false
    config_key: "Miscellaneous/Custom Font File Path"
    unsourceable: "any TrueType, TrueType collection or OpenType face the user picks, with no name or version the code expects"
    description: "Replacement face for the overlay text"
    note: >-
      Copied into the font directory at the data root by the picker, its absolute
      path stored in the configuration. Used for the default, CJK base and Hangul
      classes at once, and only while Font File Selection is Custom. The setting
      reverts to From Firmware when the stored path no longer resolves, so the
      firmware faces cover the absence.
    source_ref: "app/src/main/java/aenu/aps3e/EmulatorSettings.java:1332-1352, app/src/main/cpp/aps3e_rp3_impl.cpp:227-239, app/src/main/cpp/rpcs3/rpcs3/Emu/system_config.h:401-402"

  - name: "<driver>.so"
    aliases: ["<driver>.zip"]
    required: false
    config_key: "Video/Vulkan/Custom Driver Library Path"
    unsourceable: "third-party Vulkan driver built for one GPU family, not an emulator artefact"
    description: "Replacement Vulkan driver"
    note: >-
      Imported as a shared object, or as a zip whose meta.json names the library
      to keep, and unpacked into the driver directory in internal storage. Read
      from the global config YAML before the emulator initialises and dlopened in
      place of the system loader. The system libvulkan.so is used when Use Custom
      Driver is off, the path is empty, or the file is gone.
    source_ref: "app/src/main/java/aenu/aps3e/EmulatorSettings.java:1235-1330, app/src/main/cpp/aps3e_emu.cpp:1015-1039, app/src/main/cpp/vkapi.cpp:21, app/src/main/cpp/rpcs3/rpcs3/Emu/system_config.h:209-211"

# Layout produced by extracting PS3UPDAT.PUP, and the paths this tree reads from it.
dev_flash:
  path: "config/dev_flash/"
  source_ref: "app/src/main/cpp/rpcs3/rpcs3/Emu/vfs_config.h:15, app/src/main/cpp/aps3e_rp3_impl.cpp:151-153"
  note: >-
    Mounted at /dev_flash and rooted at the config directory. Written only by the
    firmware installer, which extracts the dev_flash_ packages of the PUP into it.

  sys_external:
    path: "dev_flash/sys/external/"
    source_ref: "app/src/main/cpp/rpcs3/rpcs3/Emu/Cell/PPUModule.cpp:2608-2610, app/src/main/cpp/rpcs3/rpcs3/Emu/Cell/lv2/sys_prx.cpp:207"
    note: >-
      Firmware SPRX modules. liblv2.sprx gates the boot and pulls the rest in;
      each module can be forced to LLE or HLE through Libraries Control, which
      the shipped configuration leaves empty. flashATRAC.pic is named by
      cellSysmodule for the ATRAC module path.
    critical_file: "liblv2.sprx"

  sys_internal:
    path: "dev_flash/sys/internal/"
    source_ref: "app/src/main/cpp/rpcs3/rpcs3/Emu/Cell/lv2/sys_prx.cpp:33-34"
    note: "Internal modules, libfs_utility_init.sprx among them."

  fonts:
    path: "dev_flash/data/font/"
    source_ref: "app/src/main/cpp/rpcs3/rpcs3/Emu/Cell/Modules/cellFont.cpp:226-241, app/src/main/cpp/rpcs3/rpcs3/Emu/Cell/Modules/cellFont.cpp:281, app/src/main/cpp/rpcs3/rpcs3/Emu/RSX/Overlays/overlay_fonts.cpp:117-118"
    note: >-
      Faces cellFontOpenFontset maps by type, and the directory the overlay
      searches for its own list. A fontset the emulator does not implement falls
      back to SCE-PS3-RD-R-LATIN.TTF.
    files:
      - "SCE-PS3-RD-R-LATIN.TTF"
      - "SCE-PS3-RD-L-LATIN.TTF"
      - "SCE-PS3-RD-B-LATIN.TTF"
      - "SCE-PS3-RD-R-LATIN2.TTF"
      - "SCE-PS3-RD-L-LATIN2.TTF"
      - "SCE-PS3-RD-B-LATIN2.TTF"
      - "SCE-PS3-MT-R-LATIN.TTF"
      - "SCE-PS3-NR-R-JPN.TTF"
      - "SCE-PS3-NR-L-JPN.TTF"
      - "SCE-PS3-NR-B-JPN.TTF"
      - "SCE-PS3-YG-R-KOR.TTF"
      - "SCE-PS3-SR-R-LATIN.TTF"
      - "SCE-PS3-SR-R-LATIN2.TTF"
      - "SCE-PS3-SR-R-JPN.TTF"
      - "SCE-PS3-VR-R-LATIN.TTF"
      - "SCE-PS3-VR-R-LATIN2.TTF"
      - "SONY-CC/SCE-PS3-DH-R-CGB.TTF"

  certs:
    path: "dev_flash/data/cert/"
    source_ref: "app/src/main/cpp/rpcs3/rpcs3/Emu/Cell/Modules/cellSsl.cpp:110"
    note: "Root certificates cellSsl enumerates."

  vsh:
    path: "dev_flash/vsh/"
    source_ref: "app/src/main/cpp/rpcs3/rpcs3/util/sysinfo.cpp:651-653, app/src/main/cpp/rpcs3/rpcs3/Emu/Cell/PPUThread.cpp:4433-4441, app/src/main/cpp/rpcs3/rpcs3/Emu/RSX/Overlays/overlay_user_list_dialog.cpp:207"
    note: >-
      vsh/etc/version.txt supplies the installed firmware version, compared
      against the PS3_SYSTEM_VER a title declares. vsh/module/eseibrd.sprx is
      precompiled at boot and vsh/resource/explore/user carries the avatars the
      user list draws.

  ps1emu:
    path: "dev_flash/ps1emu/"
    source_ref: "app/src/main/cpp/rpcs3/rpcs3/Emu/System.cpp:2187"
    note: "ps1_newemu.self, the argv[0] of a PS1 Classics boot."

  pspemu:
    path: "dev_flash/pspemu/"
    source_ref: "app/src/main/cpp/rpcs3/rpcs3/Emu/System.cpp:2215"
    note: "psp_emulator.self, the argv[0] of a PSP minis boot."

dev_flash2:
  path: "config/dev_flash2/"
  source_ref: "app/src/main/cpp/rpcs3/rpcs3/Emu/vfs_config.h:16, app/src/main/cpp/rpcs3/rpcs3/Emu/Cell/lv2/sys_fs.cpp:28"
  note: "CELL_FS_FAT on CELL_FS_IOS:BUILTIN_FLSH2. Mount point only, created empty."

dev_flash3:
  path: "config/dev_flash3/"
  source_ref: "app/src/main/cpp/rpcs3/rpcs3/Emu/vfs_config.h:17, app/src/main/cpp/rpcs3/rpcs3/Emu/Cell/lv2/sys_fs.cpp:27"
  note: "CELL_FS_FAT on CELL_FS_IOS:BUILTIN_FLSH3. Mount point only, created empty."