Skip to content

EmuCoreX - RetroBIOS
Type standalone
Classification Community forks
Source https://github.com/sashkinbro/EmuCoreX
Upstream https://github.com/PCSX2/pcsx2
Version 0.3.3
Profiled 2026-08-11
Cores emucorex
Systems sony-playstation-2
Author Oleksandr (sashkinbro)
BIOS directory bios/
Resources directory resources/
Technical notes

PlayStation 2 emulator for Android, package com.sbro.emucorex, arm64-v8a only, minSdk 29. A Kotlin and Compose front end drives a PCSX2 tree vendored under app/src/main/cpp/pcsx2 and pinned to v2.7.316, reached through the ARM_ANDROID adapter that owns the JNI entry points. Frontends start the exported activity com.sbro.emucorex.MainActivity; ES-DE passes the disc as the intent data URI. ref: app/build.gradle.kts:53-56, app/build.gradle.kts:77, app/src/main/AndroidManifest.xml:48-62, app/src/main/cpp/ARM_ANDROID/CMakeLists.txt:77-79, app/src/main/cpp/ARM_ANDROID/CMakeLists.txt:338

The whole upstream core is linked, with three files swapped out of the target: Achievements.cpp, Host/SDLAudioStream.cpp and Input/SDLInputSource.cpp are removed and replaced by the adapter's own achievements, AAudio and OpenSL, and input sources. OpenGL and Vulkan are on, pcsx2-qt is never added, and the DX11 and DX12 renderers sit in the Windows branch of the core CMakeLists. ref: app/src/main/cpp/ARM_ANDROID/CMakeLists.txt:239-256, app/src/main/cpp/ARM_ANDROID/CMakeLists.txt:58-59, app/src/main/cpp/pcsx2/pcsx2/CMakeLists.txt:691, app/src/main/cpp/pcsx2/pcsx2/CMakeLists.txt:708-712

Storage. The data root is the app files directory; the app creates cache, resources, inis, sstates and memcards under it, then copies the whole resources asset tree out of the package into resources. The core is handed AppRoot, DataRoot, Resources, Settings and Cache from that root, and the launcher sets Folders for Bios, Savestates, MemoryCards, Textures, Cheats, Patches and Logs per run. ref: app/src/main/java/com/sbro/emucorex/core/NativeApp.kt:28, app/src/main/java/com/sbro/emucorex/core/NativeApp.kt:163-165, app/src/main/java/com/sbro/emucorex/core/NativeApp.kt:293-300, app/src/main/java/com/sbro/emucorex/core/NativeApp.kt:316-348, app/src/main/cpp/ARM_ANDROID/src/runtime/upstream_vm_bridge.cpp:135-139, app/src/main/java/com/sbro/emucorex/core/EmulatorBridge.kt:546-552

A BIOS image is required and boot stops without one: LoadBIOS returning false makes VMManager report that a PlayStation 2 BIOS is needed. Only a GS dump replay skips the load. Detection is by content: the folder scan keeps files between 4 and 8 MB and accepts an image whose romdir carries a RESET entry followed by a readable ROMVER, the fifth ROMVER character giving the zone among Japan, USA, Europe, Asia, China, T10K, COH-H, Test and Free, with EXTINFO supplying the serial. An image named in the configuration is opened at its own path without the size filter. No name and no hash is matched. ref: app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:16-17, app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:80-197, app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:258-294, app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:317-369, app/src/main/cpp/pcsx2/pcsx2/VMManager.cpp:1487-1499

The app runs its own gate over the same test before launching. A candidate is a .bin or .rom between 512 KB and 8 MB whose name carries scph, ps2, bios or rom, and it is confirmed by isBiosPath or isBiosFd, both of which call the core's IsBIOS on the path or on /proc/self/fd. ref: app/src/main/java/com/sbro/emucorex/core/BiosValidator.kt:13-19, app/src/main/java/com/sbro/emucorex/core/BiosValidator.kt:110-137, app/src/main/cpp/ARM_ANDROID/src/jni/native_app_jni.cpp:414-436

A BIOS folder picked through the storage access framework is copied flat into imported-bios under the external files directory, and Folders/Bios points there. The import filter takes any .bin or .rom, plus .mec, .nvm and .elf whose name carries one of the hints. Neither rom1 nor rom2 is an accepted extension, and LoadExtraRom looks for exactly {bios}.rom1 or {biosbase}.rom1, so the two ROM modules only reach the core when Folders/Bios is a plain filesystem path used as-is. A re-import preserves the .nvm and .mec sitting beside the image. ref: app/src/main/java/com/sbro/emucorex/core/DocumentPathResolver.kt:25-27, app/src/main/java/com/sbro/emucorex/core/DocumentPathResolver.kt:101-154, app/src/main/java/com/sbro/emucorex/core/DocumentPathResolver.kt:366-388, app/src/main/java/com/sbro/emucorex/core/DocumentPathResolver.kt:433-438, app/src/main/java/com/sbro/emucorex/core/DocumentPathResolver.kt:492-499

Much of the bundled resource tree is compiled out on this platform and never read. ImGuiManager::Initialize returns false before creating the ImGui context, so LoadFontData and the three fonts it reads are unreachable, and SetFonts and ReloadFonts both guard on that context. InitializeFullscreenUI returns false unconditionally, so FullscreenUI::Initialize never runs and nothing under fullscreenui or icons is loaded. The adapter reads two fonts of its own instead and hands them over through SetFonts. ref: app/src/main/cpp/pcsx2/pcsx2/ImGui/ImGuiManager.cpp:115-128, app/src/main/cpp/pcsx2/pcsx2/ImGui/ImGuiManager.cpp:132-136, app/src/main/cpp/pcsx2/pcsx2/ImGui/ImGuiManager.cpp:147, app/src/main/cpp/pcsx2/pcsx2/ImGui/ImGuiManager.cpp:193-198, app/src/main/cpp/pcsx2/pcsx2/ImGui/ImGuiManager.cpp:262-281, app/src/main/cpp/pcsx2/pcsx2/ImGui/ImGuiManager.cpp:449-511, app/src/main/cpp/ARM_ANDROID/src/runtime/upstream_vm_bridge.cpp:254-282, app/src/main/cpp/ARM_ANDROID/src/runtime/upstream_vm_bridge.cpp:307

The three achievement sounds are the one resource the code reads that the tree does not carry. Their directory holds only the README naming their origin, while upstream v2.7.316 ships message.wav at 15696 bytes, lbsubmit.wav at 82096 and unlock.wav at 202702. All four sound settings default on, so a signed-in session asks for them at every notification. ref: app/src/main/cpp/pcsx2/bin/resources/sounds/achievements/README.txt:1-3, app/src/main/cpp/ARM_ANDROID/src/integration/pcsx2_achievements_android.cpp:81-83, app/src/main/cpp/pcsx2/pcsx2/Config.h:1346-1349, app/src/main/cpp/pcsx2/pcsx2/Pcsx2Config.cpp:1951-1954

40 files | 20 required, 20 optional | 34 in repo, 6 missing | 4 with HLE fallback Categories: 34 BIOS, 6 game data

ps2-0230a-20080220.bin required in repo
PS2 BIOS image

  • Path: bios/ps2-0230a-20080220.bin
  • System: sony-playstation-2
  • Size: min 4.0 MB, max 8.0 MB
  • Validation: size
  • Source: app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:16-17, app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:80-197, app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:258-294, app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:317-369
  • Platforms: batocera, lakka, recalbox, retroarch, retrobat, retrodeck, retropie, rocknix, romm
  • Any image whose romdir holds RESET and ROMVER is accepted, whatever its name. The 4 to 8 MB range gates the folder scan; an image named in the configuration skips that range. Read into the 4 MB ROM region and truncated to it. Shorter than 2465792 bytes disables the OSDSys parameter HLE.

ps2-0230a-20080220.rom1 optional in repo
DVD player ROM

  • Path: bios/ps2-0230a-20080220.rom1
  • System: sony-playstation-2
  • Size: max 4.0 MB
  • Source: app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:214-241, app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:366, app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:371-381, app/src/main/java/com/sbro/emucorex/core/DocumentPathResolver.kt:25-27, app/src/main/java/com/sbro/emucorex/core/DocumentPathResolver.kt:433-438
  • Tried as {bios}.rom1 then {biosbase}.rom1, with a case-insensitive retry on the open. Copied to the ROM1 region and truncated to 4 MB. Logged and skipped when absent. The storage access framework import does not carry this extension, so it is reachable only from a plain BIOS folder path.

ps2-0230a-20080220.rom2 optional missing
Chinese ROM extension

  • Path: bios/ps2-0230a-20080220.rom2
  • System: sony-playstation-2
  • Size: max 4.0 MB
  • Aliases: SCPH-90006_BIOS_VX_HK _230.ROM2
  • Source: app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:214-241, app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:367, app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:371-381
  • Same two-step naming as rom1, copied to the ROM2 region. Present on Chinese region consoles. Carried by the same import restriction as rom1.

ps2-0230a-20080220.nvm optional in repo HLE fallback
Console NVRAM

  • Path: bios/ps2-0230a-20080220.nvm
  • System: sony-playstation-2
  • Size: 1.0 KB
  • Source: app/src/main/cpp/pcsx2/pcsx2/CDVD/CDVD.cpp:46-47, app/src/main/cpp/pcsx2/pcsx2/CDVD/CDVD.cpp:160-163, app/src/main/cpp/pcsx2/pcsx2/CDVD/CDVD.cpp:165-189
  • Read at the BIOS path with the extension replaced by nvm, case-insensitively. Carries the console id, the iLink id, the model number and the OSD configuration. A 1024 byte image is built in memory when the file is absent, short, or carries a blank config block, filled with a fixed iLink id and the language and region defaults of the detected BIOS region.

ps2-0230a-20080220.mec optional in repo HLE fallback
Mechacon version

  • Path: bios/ps2-0230a-20080220.mec
  • System: sony-playstation-2
  • Size: 4 B
  • Source: app/src/main/cpp/pcsx2/pcsx2/CDVD/CDVD.cpp:49, app/src/main/cpp/pcsx2/pcsx2/CDVD/CDVD.cpp:191-204
  • Read at the BIOS path with the extension replaced by mec. Defaults to 0x00020603 and is written back at that path when it cannot be read.

eeprom.dat optional in repo HLE fallback
DEV9 EEPROM

  • System: sony-playstation-2
  • Size: 64 B
  • Source: app/src/main/cpp/pcsx2/pcsx2/DEV9/DEV9.cpp:97-160
  • Opened from the working directory when the network adapter starts and mapped over 64 bytes. A compiled-in image stands in when the file is missing or cannot be mapped.

flash.dat optional missing HLE fallback
DEV9 SmartMedia flash image

  • System: sony-playstation-2
  • Size: max 8.2 MB
  • Source: app/src/main/cpp/pcsx2/pcsx2/DEV9/flash.cpp:9-16, app/src/main/cpp/pcsx2/pcsx2/DEV9/flash.cpp:62-86
  • Opened from the working directory at network adapter init and read as 1024 blocks of 16 pages of 512 bytes plus 16 ECC bytes. The card is filled with 0xFF when the file is absent.

<module>.irx optional missing
IOP module injected at boot

  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:243-256, app/src/main/cpp/pcsx2/pcsx2/ps2/BiosTools.cpp:384-385, app/src/main/cpp/pcsx2/pcsx2/VMManager.cpp:1434, app/src/main/cpp/ARM_ANDROID/src/runtime/upstream_vm_bridge.cpp:334
  • Config key: EmuCore/CurrentIRX
  • Read into the ROM region at 0x3C0000 when the IOP program counter reaches 0x1630 and the setting is longer than three characters. The launcher fills it from the boot parameters when the picked file is an IRX. Empty otherwise.

GameIndex.yaml optional in repo game_data bundled
per-title compatibility and fix database

  • Path: resources/GameIndex.yaml
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GameDatabase.cpp:39, app/src/main/cpp/pcsx2/pcsx2/GameDatabase.cpp:976-977, app/src/main/java/com/sbro/emucorex/ui/gamedb/GameDbCatalogRepository.kt:96, app/src/main/java/com/sbro/emucorex/ui/gamedb/GameDbCatalogRepository.kt:202
  • Platforms: lakka, retroarch, retropie
  • Opened from the resources directory and parsed into the game database that drives per-title rounding modes, clamp modes, GS hacks and memory card filters. The Kotlin catalog reads the same file straight out of the package for the compatibility badges it draws.

RedumpDatabase.yaml optional in repo game_data bundled
disc hash database

  • Path: resources/RedumpDatabase.yaml
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GameDatabase.cpp:1081, app/src/main/cpp/pcsx2/pcsx2/GameDatabase.cpp:1138-1139
  • Opened from the resources directory and parsed into the hash database used to name a disc from its dump.

patches.zip optional in repo game_data bundled
built-in game patch archive

  • Path: resources/patches.zip
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/Patch.cpp:117, app/src/main/cpp/pcsx2/pcsx2/Patch.cpp:289-310, app/src/main/java/com/sbro/emucorex/core/NativeApp.kt:163-165
  • Opened read only from the resources directory as a zip source and searched for the pnach matching the running serial and CRC. A failure to open is reported once and the built-in patches are dropped for the session.

Roboto-Regular.ttf optional in repo bundled
core text font

  • Path: resources/fonts/Roboto-Regular.ttf
  • System: sony-playstation-2
  • Source: app/src/main/cpp/ARM_ANDROID/src/runtime/upstream_vm_bridge.cpp:254-262, app/src/main/cpp/ARM_ANDROID/src/runtime/upstream_vm_bridge.cpp:271-282, app/src/main/cpp/ARM_ANDROID/src/runtime/upstream_vm_bridge.cpp:307
  • Read by the adapter's own font setup before the VM starts and handed to the core as the standard font. An empty font list is logged as a setup failure.

Twemoji.Mozilla.ttf optional in repo bundled
core emoji font

  • Path: resources/fonts/Twemoji.Mozilla.ttf
  • System: sony-playstation-2
  • Source: app/src/main/cpp/ARM_ANDROID/src/runtime/upstream_vm_bridge.cpp:263-270, app/src/main/cpp/ARM_ANDROID/src/runtime/upstream_vm_bridge.cpp:271-282
  • Read by the same font setup and appended as the emoji face. Skipped when the file cannot be read.

tfx.glsl required in repo bundled
Vulkan texture and framebuffer shader

  • Path: resources/shaders/vulkan/tfx.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Common/GSDevice.cpp:346-349, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:2400-2404
  • Read from the resources directory when the Vulkan device is created. A read failure is reported and device creation fails.

convert.glsl required in repo bundled
Vulkan format conversion shader

  • Path: resources/shaders/vulkan/convert.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:4462-4466, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:4847-4851
  • Read when the conversion pipelines are compiled and again as the vertex stage of the FXAA pipeline.

present.glsl required in repo bundled
Vulkan presentation shader

  • Path: resources/shaders/vulkan/present.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:4676-4680

interlace.glsl required in repo bundled
Vulkan deinterlacing shader

  • Path: resources/shaders/vulkan/interlace.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:4726-4730

merge.glsl required in repo bundled
Vulkan field merge shader

  • Path: resources/shaders/vulkan/merge.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:4777-4781

shadeboost.glsl required in repo bundled
Vulkan brightness and contrast shader

  • Path: resources/shaders/vulkan/shadeboost.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:4882-4886

cas.glsl required in repo bundled
Vulkan contrast adaptive sharpening shader

  • Path: resources/shaders/vulkan/cas.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:2438-2439, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:4932-4934, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Common/GSDevice.cpp:1038-1049
  • Read as a compute shader and its two include lines substituted with the contents of the common headers. The Vulkan device compiles the CAS pipelines unconditionally and returns on a failure, so a missing file stops device creation rather than dropping the feature.

imgui.glsl required in repo bundled
Vulkan overlay shader

  • Path: resources/shaders/vulkan/imgui.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:4959-4962

tfx_vgs.glsl required in repo bundled
OpenGL texture and framebuffer vertex shader

  • Path: resources/shaders/opengl/tfx_vgs.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Common/GSDevice.cpp:346-349, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:778
  • Read from the resources directory when the OpenGL device is created.

tfx_fs.glsl required in repo bundled
OpenGL texture and framebuffer fragment shader

  • Path: resources/shaders/opengl/tfx_fs.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:779

convert.glsl required in repo bundled
OpenGL format conversion shader

  • Path: resources/shaders/opengl/convert.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:514-518

present.glsl required in repo bundled
OpenGL presentation shader

  • Path: resources/shaders/opengl/present.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:584

interlace.glsl required in repo bundled
OpenGL deinterlacing shader

  • Path: resources/shaders/opengl/interlace.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:643

merge.glsl required in repo bundled
OpenGL field merge shader

  • Path: resources/shaders/opengl/merge.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:620

shadeboost.glsl required in repo bundled
OpenGL brightness and contrast shader

  • Path: resources/shaders/opengl/shadeboost.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:2423

cas.glsl optional in repo bundled
OpenGL contrast adaptive sharpening shader

  • Path: resources/shaders/opengl/cas.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:2577-2597, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Common/GSDevice.cpp:1038-1049
  • Read as a compute program with the two include lines substituted, and needs an ES 3.1 or 3.2 context. A failure turns CAS sharpening off.

imgui.glsl required in repo bundled
OpenGL overlay shader

  • Path: resources/shaders/opengl/imgui.glsl
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:2661

fxaa.fx required in repo bundled
antialiasing shader shared by both renderers

  • Path: resources/shaders/common/fxaa.fx
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:2425-2430, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:4854-4858, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:2385-2390, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:2404-2407
  • Read as the fragment stage of the FXAA pipeline on Vulkan, inside the post-processing pipelines the device creation chain requires, so a missing file stops device creation there. On OpenGL the program is compiled on its own and an invalid one makes the FXAA pass return without drawing.

ffx_a.h required in repo bundled
CAS support header

  • Path: resources/shaders/common/ffx_a.h
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Common/GSDevice.cpp:1038-1049, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:2438-2439, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:667
  • Read from the resources directory and pasted over the matching include line of the CAS shader, the compilers having no include support. It shares the fate of the CAS shader it is pasted into: fatal to device creation on Vulkan, and only the sharpening feature on OpenGL.

ffx_cas.h required in repo bundled
CAS kernel header

  • Path: resources/shaders/common/ffx_cas.h
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Common/GSDevice.cpp:1038-1049, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/Vulkan/GSDeviceVK.cpp:2438-2439, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/OpenGL/GSDeviceOGL.cpp:667
  • Read and substituted the same way as the other CAS header, with the same consequence per renderer when it is missing.

message.wav optional in repo
achievement notification sound

  • Path: resources/sounds/achievements/message.wav
  • System: sony-playstation-2
  • Source: app/src/main/cpp/ARM_ANDROID/src/integration/pcsx2_achievements_android.cpp:81, app/src/main/cpp/ARM_ANDROID/src/integration/pcsx2_achievements_android.cpp:1245-1250, app/src/main/cpp/pcsx2/pcsx2/Pcsx2Config.cpp:1951-1954, app/src/main/java/com/sbro/emucorex/core/NativeApp.kt:194-200
  • Played from the resources directory whenever an achievement notification is raised and no custom sound is configured. Sound effects and the notification sound both default on. The vendored tree carries only the README for this directory, so the file has to be supplied; the Android sound callback returns without playing when the path is not a file. Upstream v2.7.316 ships it at 15696 bytes.

unlock.wav optional in repo
achievement unlock sound

  • Path: resources/sounds/achievements/unlock.wav
  • System: sony-playstation-2
  • Source: app/src/main/cpp/ARM_ANDROID/src/integration/pcsx2_achievements_android.cpp:82, app/src/main/cpp/ARM_ANDROID/src/integration/pcsx2_achievements_android.cpp:1313-1318
  • Played on an unlock under the same two settings, both on by default. Absent from the vendored tree. Upstream v2.7.316 ships it at 202702 bytes.

lbsubmit.wav optional in repo
leaderboard submission sound

  • Path: resources/sounds/achievements/lbsubmit.wav
  • System: sony-playstation-2
  • Source: app/src/main/cpp/ARM_ANDROID/src/integration/pcsx2_achievements_android.cpp:83, app/src/main/cpp/ARM_ANDROID/src/integration/pcsx2_achievements_android.cpp:1458-1463
  • Played on a leaderboard submission under the same two settings, both on by default. Absent from the vendored tree. Upstream v2.7.316 ships it at 82096 bytes.

games.db optional in repo game_data bundled
bundled catalog of PS2 titles

  • System: sony-playstation-2
  • Source: app/src/main/java/com/sbro/emucorex/data/ps2/Ps2CatalogRepository.kt:18, app/src/main/java/com/sbro/emucorex/data/ps2/Ps2CatalogRepository.kt:38-56
  • SQLite catalog carried in the package assets and copied into internal storage the first time the catalog is queried, then read from there. A copy already present is kept.

<SERIAL>_<CRC>.pnach optional missing game_data
per-title cheat file

  • Path: cheats/<SERIAL>_<CRC>.pnach
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/Patch.cpp:331-342, app/src/main/cpp/pcsx2/pcsx2/Patch.cpp:344-366, app/src/main/java/com/sbro/emucorex/core/NativeApp.kt:355
  • The cheats folder is searched for the running serial and CRC, then for files carrying the CRC alone, both with a trailing wildcard so a suffix after the CRC is kept. The patches folder is searched the same way for patches rather than cheats. The app also imports pnach files out of a picked zip.

<hash>.png optional missing game_data
replacement texture

  • Path: textures/<SERIAL>/replacements/<hash>.png
  • System: sony-playstation-2
  • Source: app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/HW/GSTextureReplacements.cpp:36-42, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/HW/GSTextureReplacements.cpp:328-331, app/src/main/cpp/pcsx2/pcsx2/GS/Renderers/HW/GSTextureReplacements.cpp:442-500
  • Read when texture replacement is on. The replacements folder under the running serial is walked recursively and a file counts only when its name parses as the TEX0 hash, optional CLUT hash, optional region size and format that the texture cache looks it up by. A directory whose case does not match is reported.

<driver>.zip optional missing
replacement Vulkan driver package

  • System: sony-playstation-2
  • Source: app/src/main/java/com/sbro/emucorex/core/GpuDriverCatalogRepository.kt:131-135, app/src/main/java/com/sbro/emucorex/core/GpuDriverManager.kt:89-128, app/src/main/java/com/sbro/emucorex/core/GpuDriverManager.kt:135-141, app/src/main/cpp/ARM_ANDROID/src/runtime/android_runtime.cpp:98-112, app/src/main/cpp/ARM_ANDROID/src/runtime/android_runtime.cpp:362
  • Listed by a catalog fetched from the EmuCoreV-Drivers repository, or picked from the device. The archive is unpacked into a directory named after it under driver in internal storage, entries carrying a parent path segment being refused, and the Vulkan library it holds is recorded in a driver_name.txt written beside it. The renderer then resolves the driver through adrenotools from that pair. The system loader is used when no driver is configured.

Generated on 2026-08-23T16:12:06Z