kmoody/libretro
1
0 Fork 0
mirror of https://github.com/Abdess/retroarch_system.git synced 2026-10-11 05:53:23 -05:00
Code Issues Packages Projects Releases Wiki Activity
Files
0710ea4d45dfda2ade21e4dc9e4e3a366f81fe3c
libretro/emulators/nethersx2-turnip-classic.yml
T
Abdessamad Derraz e42d0815c1 feat: add thirty emulator profiles and their data 
Thirty profiles from the ES-DE batch, each source-verified by the
session that wrote it and passing the schema and semantic checks. Five
declare no files at all and say why in notes referenced to the code:
NGP.emu, openbor, Plastic, Swan.emu and XeniOS.

Twenty-eight files come with them, every one declared by the profile
that needs it and matching the hash it declares, with no duplicate of
anything already held: the NetherSX2 Turnip Classic assets, the Speccy
machine ROMs, the Virtual Boy homebrew the app bundles, Snes9x EX+'s
bundled game, and sixtyforce's Overrides.plist, which carries a size
and no hash because the binary never checks one.

supermodel gains the four data files it reads from its install tree,
hakux marks its controller map unsourceable now that the asset manager
is known to read inside the package, and nethersx2 sheds the two core
aliases that belong to the Turnip profiles.
2026-08-23 09:05:35 +02:00

824 lines
36 KiB
YAML
Raw Blame History

emulator: NetherSX2-Turnip Classic
type: standalone
core_classification: community_fork
bios_mode: agnostic
source: "https://github.com/nckstwrt/NetherSX2-Turnip"
upstream: "https://github.com/Trixarian/AetherSX2"
author: "nckstwrt"
profiled_date: "2026-08-12"
source_commit: "8e17e584884e19b0a912f1988730d576d6d5aa84"
upstream_commit: "1d1f795dfc70e38da67724c7298779260f513889"
core_version: "2.2n-3668-Turnip-v0.7"
display_name: "Sony - PlayStation 2 (NetherSX2-Turnip Classic)"
mode: standalone
cores:
- "nethersx2-turnip-classic"
- "NetherSX2-Turnip-Classic"
- "NETHERSX2-TURNIP-CLASSIC"
systems:
- sony-playstation-2
bios_directory: "bios/"
notes: |
PlayStation 2 emulator for Android, package xyz.aethersx2.cturnip, activity
xyz.aethersx2.android.EmulationActivity, version name v2.2n-3668, label
NetherSX2 Classic (Turnip). It sits on the 3668 line: the library it starts
from is NetherSX2 Classic v2.2n-3668, itself a patch of the AetherSX2
v1.5-3668 package, and the library still names itself NetherSX2 v2.2n-3668
(Classic). Everything below was read from the v0.7 package:
lib/arm64-v8a/libemucore.so, libvulkad.so, the dex and the assets.
ref: nethersx2-turnip-classic v0.7 AndroidManifest.xml,
nethersx2-turnip-classic v0.7 libemucore.so 0xcdcba
The package pairs two revisions of the project. libemucore.so is the blob the
v0.7 commit carries, byte for byte; libvulkad.so is the one committed for
v0.6 and reports its own build date. libhook_impl.so, libmain_hook.so and the
six packed drivers are the same at both revisions. The shim rules described
here are therefore those of the older revision, which this profile pins:
SM8350, lahaina, sdm845 and napali still route to the a6xx-Patched driver,
and SM6475, SM6650 and SM7325 are not known to it.
ref: VulkanShim2/vulkan_shim.cpp:1027-1059,
nethersx2-turnip-classic v0.7 libvulkad.so
The patch rewrites twenty-four places in the library it starts from. Three are
the strings libvulkan.so, libvulkan.so.1 and the message naming them, each
turned into libvulkad.so, so the Vulkan loader opens the shim instead of the
system driver. Sixteen turn comparisons into unconditional paths, among them
the memchr scan for the twenty-two byte pattern that precedes the certificate
test and two byte-wise string comparisons whose result is forced to equal,
which is what lets the package be resigned under a new application id. Five
move settings defaults: the renderer enum from 12 to 14, the upscale
multiplier fallback from 1.0 to 2.0 with the configuration read
short-circuited, the hardware download mode default, and the warning text that
went with it. The same five sites carry their unpatched forms in the 4248
library this project also starts from, which is what places them here rather
than in the base. None of them is in a file loading path.
ref: nethersx2-turnip-classic v0.7 libemucore.so 0x105f5b,
nethersx2-turnip-classic v0.7 libemucore.so 0x829ae0-0x82a018,
nethersx2-turnip-classic v0.7 libemucore.so 0x82d10c-0x82d5c0,
nethersx2-turnip-classic v0.7 libemucore.so 0x82e41c,
nethersx2-turnip-classic v0.7 libemucore.so 0x82fbac-0x82fcac,
nethersx2-turnip-classic v0.7 libemucore.so 0x8034c4,
nethersx2-turnip-classic v0.7 libemucore.so 0x833d04,
nethersx2-turnip-classic v0.7 libemucore.so 0x83401c-0x834028,
nethersx2-turnip-classic v0.7 libemucore.so 0x834cb0
A BIOS image is required and boot stops without one, the application raising a
startup error saying it needs a PS2 BIOS in the bios folder of the data
directory. The data directory is getExternalFilesDir(null) with getDataDir()
behind it, so it follows the application id, and the folder names under it
come from the Folders section, Bios defaulting to bios. An image imported
through the interface is written to that folder under the CRC32 of its
contents, as %08X.bin.
ref: nethersx2-turnip-classic v0.7 libemucore.so 0x8057dc,
nethersx2-turnip-classic v0.7 libemucore.so 0x7dfaf0-0x7dfb10,
xyz/aethersx2/android/NativeLibrary initializeOnce,
xyz/aethersx2/android/NativeLibrary importBIOS
Detection is by content. The scan lists the BIOS folder with a * mask, keeps
files between 4194304 and 8388608 bytes, and accepts an image whose romdir
carries a RESET entry followed by a readable ROMVER; the fifth ROMVER
character gives the zone, A for USA, C for China, E for Europe, H for Asia,
J for Japan, P for Free, T for T10K and X for Test, any other character
standing for itself. The sixth character is read only to pick the word
Console or Devel for the description, and the acceptance flag is set outright
once ROMVER has been read, so development images pass with nothing patched
here. RESET and ROMVER are the only two names the scan compares. An image
named in the configuration is combined with the BIOS folder and opened at that
path when it exists, without the size filter and without the romdir test. No
name and no hash is matched anywhere. The image is read into the 4 MB ROM
region and truncated to it, and one shorter than 2465792 bytes turns off the
OSDSys parameter HLE.
ref: aethersx2/pcsx2/ps2/BiosTools.cpp:27-28,
aethersx2/pcsx2/ps2/BiosTools.cpp:62-175,
aethersx2/pcsx2/ps2/BiosTools.cpp:235-260,
aethersx2/pcsx2/ps2/BiosTools.cpp:272-332,
nethersx2-turnip-classic v0.7 libemucore.so 0x81bc00-0x81bc24,
nethersx2-turnip-classic v0.7 libemucore.so 0x81be44-0x81c1c0,
nethersx2-turnip-classic v0.7 libemucore.so 0x81b5e8-0x81b62c
Companions derive from the selected image. rom1 and rom2 are appended to the
full name first, then substituted for the existing extension, so an image at
ps2-0230a-20080220.bin is followed by ps2-0230a-20080220.bin.rom1 then
ps2-0230a-20080220.rom1. The nvm and the mec are read at the substituted
extension only, and both are written with defaults when they are absent or too
short. This code line loads no erom: the extension is named nowhere in the
library and the boot path goes from rom2 straight to the IRX.
ref: aethersx2/pcsx2/ps2/BiosTools.cpp:193-218,
aethersx2/pcsx2/CDVD/CDVD.cpp:120-144,
aethersx2/pcsx2/CDVD/CDVD.cpp:158-226,
nethersx2-turnip-classic v0.7 libemucore.so 0x81b688-0x81b9a4
The network adapter opens eeprom.dat and flash.dat by bare name, so they
resolve against the process working directory, which the application never
sets. A compiled-in image stands in for the first and a card filled with 0xFF
for the second. DEV9hdd.raw is the default name of the empty disk image its
settings page writes. An IRX named in the configuration is read into the ROM
region at 0x3C0000 at boot; the field is empty by default and names no file of
its own.
ref: aethersx2/pcsx2/DEV9/DEV9.cpp:73, aethersx2/pcsx2/DEV9/DEV9.cpp:145-160,
aethersx2/pcsx2/DEV9/flash.cpp:76-103,
aethersx2/pcsx2/ps2/BiosTools.cpp:220-233,
nethersx2-turnip-classic v0.7 libemucore.so 0x7bb5cc-0x7bb680,
nethersx2-turnip-classic v0.7 libemucore.so 0x81b9a4-0x81bac4
The Vulkan path is the reason this build exists. libemucore.so opens
libvulkad.so.1 then libvulkad.so where the stock library names libvulkan.so,
and vkCreateInstance is resolved from it. That shim reads the Adreno model and
the platform name from the kgsl sysfs nodes, picks one of six Turnip drivers
packed beside it, creates a linker namespace over its own library directory
and loads libhook_impl.so and libmain_hook.so into it. The system
/system/lib64/libvulkan.so is then opened inside that namespace with its
soname patched, so its own driver load lands in the hook, which opens the
chosen Turnip driver instead of the vendor ICD. A driver present at
/data/local/tmp/libvulkan_freedreno.so is tested first and wins over all six.
When the namespace cannot be built the shim falls back to patching the system
library's global offset table, and that path alone loads libbase.so,
libcutils.so, libvndksupport.so and libhardware.so from the library directory.
The shim derives the package name from its own library path and appends to
vulkan_shim.log under the files folder of that package.
ref: VulkanShim2/vulkan_shim.cpp:43-73,
VulkanShim2/vulkan_shim.cpp:1008-1085,
VulkanShim2/vulkan_shim.cpp:1107-1175,
VulkanShim2/vulkan_shim.cpp:1179-1194,
VulkanShim2/hook_impl.cpp:38-140,
nethersx2-turnip-classic v0.7 libemucore.so 0x8a45ec-0x8a4624
Resources are read out of the package itself. The library has no asset manager
of its own and calls back into readPackageFile, readPackageFileToString and
playSoundAsync, each taking an asset-relative name, so the game database, the
patch archives, the interface fonts, the shader sources every backend compiles
at startup and the achievement sounds are versioned with the build and never
looked for on disk. The sound names are joined to a file:///android_asset base
before they cross into Java. The game list draws its region flags and rating
stars from the same assets. The game database is this build's own, and five of
the shader sources differ from the ones the 4248 line carries: the OpenGL
preamble, its format conversion and texture function fragment shaders, and the
Vulkan texture function and format conversion shaders.
ref: nethersx2-turnip-classic v0.7 libemucore.so 0x828110,
xyz/aethersx2/android/NativeLibrary readPackageFile,
xyz/aethersx2/android/NativeLibrary playSoundAsync
files:
- name: ps2-0230a-20080220.bin
path: bios/ps2-0230a-20080220.bin
required: true
min_size: 4194304
max_size: 8388608
validation: [size]
description: "PS2 BIOS image"
note: >-
Any image whose romdir holds RESET and a readable ROMVER is accepted,
whatever its name. The 4 to 8 MB range gates the folder scan; an image
named in the configuration skips both that range and the romdir test.
source_ref: "aethersx2/pcsx2/ps2/BiosTools.cpp:27-28, aethersx2/pcsx2/ps2/BiosTools.cpp:235-260, nethersx2-turnip-classic v0.7 libemucore.so 0x81bc00-0x81bc24 (size window), nethersx2-turnip-classic v0.7 libemucore.so 0x81c1c0 (acceptance flag set outright)"
- name: ps2-0230a-20080220.rom1
path: bios/ps2-0230a-20080220.rom1
required: false
max_size: 4194304
description: "DVD player ROM"
note: >-
Tried as {bios}.rom1 then {biosbase}.rom1. Read at 0x2404000 of the EE
memory block and truncated to 4 MB. Logged and skipped when absent.
source_ref: "aethersx2/pcsx2/ps2/BiosTools.cpp:193-218, nethersx2-turnip-classic v0.7 libemucore.so 0x81b688-0x81b810"
- name: ps2-0230a-20080220.rom2
aliases:
- "SCPH-90006_BIOS_VX_HK _230.ROM2"
path: bios/ps2-0230a-20080220.rom2
required: false
max_size: 524288
description: "Chinese ROM extension"
note: >-
Same two-step naming as rom1. Read at 0x2804000 of the EE memory block and
truncated to 512 KB. Only present on Chinese region consoles.
source_ref: "aethersx2/pcsx2/ps2/BiosTools.cpp:193-218, nethersx2-turnip-classic v0.7 libemucore.so 0x81b820-0x81b994"
- name: ps2-0230a-20080220.nvm
path: bios/ps2-0230a-20080220.nvm
required: false
hle_fallback: true
min_size: 1024
validation: [size]
description: "Console NVRAM"
note: >-
Read at the BIOS path with the extension replaced by nvm, opened r+b.
Carries the console id, the iLink id, the language and the OSD
configuration. A 1024 byte image is written when the file is missing or
shorter, zeroed except for a fixed iLink id and the language defaults of
the BIOS region.
source_ref: "aethersx2/pcsx2/CDVD/CDVD.cpp:158-226, nethersx2-turnip-classic v0.7 libemucore.so 0x790470-0x7906c8, nethersx2-turnip-classic v0.7 libemucore.so 0x790820-0x790944"
- name: ps2-0230a-20080220.mec
path: bios/ps2-0230a-20080220.mec
required: false
hle_fallback: true
min_size: 4
validation: [size]
description: "Mechacon version"
note: >-
Read at the BIOS path with the extension replaced by mec. Written as
03 06 02 00 when the file is missing or shorter than 4 bytes.
source_ref: "aethersx2/pcsx2/CDVD/CDVD.cpp:120-144, nethersx2-turnip-classic v0.7 libemucore.so 0x791700-0x7918f4"
- name: eeprom.dat
required: false
hle_fallback: true
size: 64
description: "DEV9 EEPROM"
note: >-
Opened O_RDWR by bare name 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.
source_ref: "aethersx2/pcsx2/DEV9/DEV9.cpp:73, aethersx2/pcsx2/DEV9/DEV9.cpp:145-160, nethersx2-turnip-classic v0.7 libemucore.so 0x7bb620-0x7bb680"
- name: flash.dat
required: false
hle_fallback: true
max_size: 8650752
description: "DEV9 SmartMedia flash image"
note: >-
Opened rb by bare name 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.
source_ref: "aethersx2/pcsx2/DEV9/flash.cpp:76-103, nethersx2-turnip-classic v0.7 libemucore.so 0x7bb5cc-0x7bb61c"
- name: "<module>.irx"
required: false
unsourceable: "any IOP module the user points at, under no name the code expects"
description: "IOP module injected at boot"
note: >-
Opened at the path the configuration holds once it is four characters or
longer, and read into the ROM region at 0x3C0000, capped at 0x40000 bytes.
The field is empty by default and names no file of its own.
source_ref: "aethersx2/pcsx2/ps2/BiosTools.cpp:220-233, aethersx2/pcsx2/ps2/BiosTools.cpp:327-328, nethersx2-turnip-classic v0.7 libemucore.so 0x81b9a4-0x81bac4"
- name: libvulkad.so
path: lib/arm64-v8a/libvulkad.so
required: false
bundled: true
size: 484560
md5: 1a68e1ac1eec29005c19df924146cf19
sha1: 2655469eca935d89a6d8fe0c3998fe3ec0dd2d65
description: "Vulkan loader shim"
note: >-
Opened as libvulkad.so.1 then libvulkad.so where the stock library names
libvulkan.so, and vkCreateInstance is resolved from it. Without it the
Vulkan backend does not open and the message names the shim. This package
carries the build committed for v0.6, one revision behind the emulator
library beside it.
source_ref: "VulkanShim2/vulkan_shim.cpp:969-1272 (the constructor that runs on load), nethersx2-turnip-classic v0.7 libemucore.so 0x8a45ec-0x8a4624"
- name: libhook_impl.so
path: lib/arm64-v8a/libhook_impl.so
required: false
bundled: true
size: 461856
md5: c2a10d75f7a186f78debc79dd2204841
sha1: 5a86d24c83f4a0867a3526638182c8dc67e0033b
description: "Driver load hook"
note: >-
Opened into the adrenotools-libvulkan namespace and asked for
init_hook_param, which receives the driver directory and driver name. Its
hook_android_dlopen_ext is what replaces the vendor driver with the Turnip
one, and it reopens itself in each driver namespace it creates.
source_ref: "VulkanShim2/vulkan_shim.cpp:1138-1156, VulkanShim2/hook_impl.cpp:38-140"
- name: libmain_hook.so
path: lib/arm64-v8a/libmain_hook.so
required: false
bundled: true
size: 5648
md5: 3ded83b3f45773199b82bf81c86f8c89
sha1: e2ee6c00247fc05b88afe43237fa4bfa90212c54
description: "Namespace interposer"
note: >-
Loaded RTLD_GLOBAL into the same namespace before the system Vulkan
library, so its android_dlopen_ext and android_load_sphal_library are the
ones that library binds to.
source_ref: "VulkanShim2/vulkan_shim.cpp:1159-1160, VulkanShim2/main_hook.c:3-9"
- name: libvulkan_freedreno_T28.so
path: lib/arm64-v8a/libvulkan_freedreno_T28.so
required: false
bundled: true
size: 18606849
md5: 315f4b037b77dea81ea099e13e94fa11
sha1: 83406408d328d8529ffa2faf7ab878664a5c7a79
description: "Turnip driver, default branch"
note: >-
Chosen when no other branch matches. Loaded by name from the library
directory through the hook; a load failure falls back to the vendor
driver.
source_ref: "VulkanShim2/vulkan_shim.cpp:1011, VulkanShim2/vulkan_shim.cpp:1079-1080, VulkanShim2/hook_impl.cpp:127-135"
- name: libvulkan_freedreno_a8xx-turnip-gen8-V31.so
path: lib/arm64-v8a/libvulkan_freedreno_a8xx-turnip-gen8-V31.so
required: false
bundled: true
size: 14509832
md5: 7f6dbc9ec12cb53b1802c418cf532f9b
sha1: 2dc32726b7a68ced6a40ea2c6cc60848716907ab
description: "Turnip driver, Adreno 8xx branch"
note: >-
Chosen whenever the Adreno model reads non-zero, model 810 and 825
included. Model 825 also turns off framebuffer fetch.
source_ref: "VulkanShim2/vulkan_shim.cpp:1010, VulkanShim2/vulkan_shim.cpp:1037-1052, nethersx2-turnip-classic v0.7 libvulkad.so 0x22770-0x23108"
- name: libvulkan_freedreno_T24.so
path: lib/arm64-v8a/libvulkan_freedreno_T24.so
required: false
bundled: true
size: 18003849
md5: e90d691859e0ff8f0221f3fb497cca5d
sha1: d28f7c64a8296a6d1886b348946d01433c10b493
description: "Turnip driver, Adreno 810 branch"
note: >-
The Adreno 810 branch writes this path and the block it falls into
overwrites it with the 8xx driver before anything reads it, so this
revision never opens the file. The branch gained its own exit after the
revision this package was built from.
source_ref: "VulkanShim2/vulkan_shim.cpp:1039-1043, nethersx2-turnip-classic v0.7 libvulkad.so 0x22784-0x230d4"
- name: libvulkan_freedreno_25.3.0_R6_Gmem.so
path: lib/arm64-v8a/libvulkan_freedreno_25.3.0_R6_Gmem.so
required: false
bundled: true
size: 12048553
md5: 3f1b01295ab08d070bede8122ebd0aea
sha1: 2159a5172176f9ee0076370314d2d100de2fe1b1
description: "Turnip driver, Adreno 710 and 720 branch"
note: >-
Chosen when the model is unreadable and the GPU name holds 710 or 720.
source_ref: "VulkanShim2/vulkan_shim.cpp:1056-1059"
- name: libvulkan_freedreno_v24.1.0_R18.a6xx-Patched.so
path: lib/arm64-v8a/libvulkan_freedreno_v24.1.0_R18.a6xx-Patched.so
required: false
bundled: true
size: 9407968
md5: 7af55500464d372a609084fb4698e16d
sha1: 1abf76c578cb1330e354d5588634b87cef4bc057
description: "Turnip driver, SD845 to SD888 branch"
note: >-
Chosen when the platform reads SM8250, kona, SM8350, lahaina, sdm845 or
napali.
source_ref: "VulkanShim2/vulkan_shim.cpp:1027-1033"
- name: libvulkan_freedreno_T19.so
path: lib/arm64-v8a/libvulkan_freedreno_T19.so
required: false
bundled: true
size: 11581209
md5: 5f953080ba9ac858a99f3742c8302055
sha1: 4dc276dfd5842302c978ce9b2996f961dc6452f1
description: "Turnip driver, SM6125 branch"
note: "Chosen when the platform reads SM6125 or trinket."
source_ref: "VulkanShim2/vulkan_shim.cpp:1020-1023"
- name: libvulkan_freedreno.so
path: data/local/tmp/libvulkan_freedreno.so
required: false
unsourceable: "any Turnip build the user places at that path"
description: "Turnip driver override"
note: >-
Tested with access before any detection runs. When it exists it becomes
the driver and the driver directory becomes /data/local/tmp/, so none of
the six packed drivers is consulted.
source_ref: "VulkanShim2/vulkan_shim.cpp:1009, VulkanShim2/vulkan_shim.cpp:1012-1017"
- name: libbase.so
path: lib/arm64-v8a/libbase.so
required: false
bundled: true
size: 255352
md5: eae5ccb3f801b3333ec0e65592ce8a87
sha1: fecf95a804a7cb57e210f55d5482a56826c8684c
description: "Platform support library for the fallback path"
note: >-
Opened RTLD_GLOBAL from the library directory only when the namespace
approach failed and the shim falls back to patching the global offset
table.
source_ref: "VulkanShim2/vulkan_shim.cpp:1179-1194"
- name: libcutils.so
path: lib/arm64-v8a/libcutils.so
required: false
bundled: true
size: 91200
md5: 185cd93c21cce12ab4c3bc2430934684
sha1: 63e55bcae5ee690cf6bc7db69a5077c5502e4334
description: "Platform support library for the fallback path"
note: "Same fallback list as libbase.so, and a dependency of every packed driver."
source_ref: "VulkanShim2/vulkan_shim.cpp:1179-1194, VulkanShim2/vulkan_shim.cpp:1248-1255"
- name: libvndksupport.so
path: lib/arm64-v8a/libvndksupport.so
required: false
bundled: true
size: 66881
md5: aa5065cca6695aa4b8cfdd3c164f3d28
sha1: a6f2d8498a2f0a00776dd69c58f012cdbb75a308
description: "Platform support library for the fallback path"
note: >-
Same fallback list as libbase.so. Its android_load_sphal_library is the
call the shim stubs so a vendor load can be redirected.
source_ref: "VulkanShim2/vulkan_shim.cpp:1179-1194, VulkanShim2/vulkan_shim.cpp:1257-1269"
- name: libhardware.so
path: lib/arm64-v8a/libhardware.so
required: false
bundled: true
size: 66961
md5: 71e06a0726aa60b010e066d37021d36a
sha1: 555a6203cd7c23c2b49916d70615e5df7973aa87
description: "Platform support library for the fallback path"
note: "Same fallback list as libbase.so, and a dependency of every packed driver."
source_ref: "VulkanShim2/vulkan_shim.cpp:1179-1194, VulkanShim2/vulkan_shim.cpp:1235-1246"
- name: GameIndex.yaml
path: assets/GameIndex.yaml
required: false
bundled: true
size: 1758721
md5: 3f33de7bf8e40e00a05cf27c18a6be0c
sha1: 58fb1f8ea6cf2d526904349640453e682fe388a1
description: "Game database"
note: >-
Read from the package by name, keyed by serial, and carrying the per-game
fixes, patches and settings overrides. Parsed into gamedb.cache in the
cache folder.
source_ref: "aethersx2/pcsx2/GameDatabase.cpp:35, nethersx2-turnip-classic v0.7 libemucore.so 0x2e45fc"
- name: cheats_ws.zip
path: assets/cheats_ws.zip
required: false
bundled: true
size: 1694454
md5: cc19970629feb0a25b9b95263194f08f
sha1: 1caae7ddf0cbba5f1f6d7404b2309300d913778c
description: "Widescreen patch archive"
note: >-
Per-game pnach entries matched on the disc CRC, read from the package when
widescreen patches are enabled. The cheats_ws folder under the data
directory takes precedence and the archive is skipped when it holds a
match.
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x804464"
- name: cheats_ni.zip
path: assets/cheats_ni.zip
required: false
bundled: true
size: 223122
md5: fb2a43dcea094a19db4f4bcdc4ad32eb
sha1: 31cbff66380f255d359ff9ee09b6edc06102579a
description: "No-interlacing patch archive"
note: >-
Same form as cheats_ws.zip, read when no-interlacing patches are enabled,
with the cheats_ni folder taking precedence.
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x80460c"
- name: Roboto-Regular.ttf
path: assets/fonts/Roboto-Regular.ttf
required: true
bundled: true
size: 305608
md5: 86da78cb59576328483a11c6ef74bc2b
sha1: 00d62fbdc8d5dec4c659005e116d0ba2ee63b547
description: "Interface font"
note: "Read as the standard font when the interface comes up. An empty read aborts the process."
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x7d1e78-0x7d1e8c, nethersx2-turnip-classic v0.7 libemucore.so 0x7d2270"
- name: RobotoMono-Medium.ttf
path: assets/fonts/RobotoMono-Medium.ttf
required: true
bundled: true
size: 86820
md5: 8ad82b1dc550319993a7d6c932b2656d
sha1: 9056e59b69c6f1160fdfb92a0773f17f6307f3ad
description: "Fixed-width interface font"
note: "Read for the fixed-width font. An empty read aborts the process."
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x7d1ecc-0x7d1ee0, nethersx2-turnip-classic v0.7 libemucore.so 0x7d2270"
- name: fa-solid-900.ttf
path: assets/fonts/fa-solid-900.ttf
required: true
bundled: true
size: 204528
md5: dffd9504fcb1894620fa41c700172994
sha1: 694b8a2445ff39de415bf4791845442a7b1b81e5
description: "Font Awesome icon font"
note: "Read for the interface icon glyphs. An empty read aborts the process."
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x7d1f20-0x7d1f34, nethersx2-turnip-classic v0.7 libemucore.so 0x7d2270"
- name: ffx_a.h
path: assets/shaders/common/ffx_a.h
required: false
bundled: true
size: 161481
md5: 2c539b603dcb15dcdcfdc420eda56ced
sha1: 726370c10154ad092c15c251b98c79185e980c7c
description: "FidelityFX common header"
note: "Prepended to the sharpening shader of both backends."
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x627178"
- name: ffx_cas.h
path: assets/shaders/common/ffx_cas.h
required: false
bundled: true
size: 63512
md5: f8a3d7f48ae19fc372cd0d5d375d5a8d
sha1: a1d1a687577f7a607fda35bc88950f57c2129ca5
description: "FidelityFX CAS header"
note: "Prepended to the sharpening shader of both backends."
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x627188"
- name: fxaa.fx
path: assets/shaders/common/fxaa.fx
required: false
bundled: true
size: 19420
md5: 5cdeb2963c1b68c3ffb04a789cc66d6e
sha1: 3ac5f68049ed00d8ff3d2811bd09ef0c036efd0a
description: "FXAA shader source"
note: "Read by both backends when FXAA is enabled."
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x67c710, nethersx2-turnip-classic v0.7 libemucore.so 0x685fd0"
- name: common_header.glsl
path: assets/shaders/opengl/common_header.glsl
required: false
bundled: true
size: 1938
md5: 86a37e282f029d20f395cfd05263fddd
sha1: 9c391aae0daddf0c2ba3f0d5265aee9b491286e4
description: "OpenGL shader preamble"
note: "Prepended to every OpenGL program the renderer builds."
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x674618"
- name: convert.glsl
path: assets/shaders/opengl/convert.glsl
required: false
bundled: true
size: 10361
md5: 0dba3321d9f902439a50b79680b220c7
sha1: 26a17de3b4abc30e5c19987efad4ceac22e9a369
description: "OpenGL format conversion shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x674f78"
- name: present.glsl
path: assets/shaders/opengl/present.glsl
required: false
bundled: true
size: 9458
md5: afbb9a89f17ead2d8ce7252c1b44186f
sha1: bf2688971a8ef2f2c262c3c2ec579d3dd39793e6
description: "OpenGL presentation shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x675480"
- name: merge.glsl
path: assets/shaders/opengl/merge.glsl
required: false
bundled: true
size: 455
md5: 2c4d70f62928eac933eec932d7bfa0b3
sha1: d1a3c11a1273e1d6c740e4eacc3159842f206683
description: "OpenGL frame merge shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x675780"
- name: interlace.glsl
path: assets/shaders/opengl/interlace.glsl
required: false
bundled: true
size: 6246
md5: 0e537dd838a7ecd3b687f3f7cc60a7be
sha1: e74e58f530abb4af02c0875c2f04d507e854869e
description: "OpenGL deinterlacing shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x675aac"
- name: shadeboost.glsl
path: assets/shaders/opengl/shadeboost.glsl
required: false
bundled: true
size: 1457
md5: 3d1e2be521a66cbfc2c5ff32057e7bf4
sha1: 8d8b8966afd2ad840151f7fcb494739041708c89
description: "OpenGL brightness and contrast shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x675cb8"
- name: cas.glsl
path: assets/shaders/opengl/cas.glsl
required: false
bundled: true
size: 2448
md5: f8a684763e24557c97e3f5d05935bb3b
sha1: 1a69a0fc522caff98fc3829ebf3f12a6a006a058
description: "OpenGL sharpening shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x676fa0"
- name: tfx_vgs.glsl
path: assets/shaders/opengl/tfx_vgs.glsl
required: false
bundled: true
size: 5756
md5: a97e9616f298bb9041bf9e45ee2ec597
sha1: 0e9e98f766c9250b465af776d0077f49f797fed2
description: "OpenGL texture function vertex and geometry shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x677318"
- name: tfx_fs.glsl
path: assets/shaders/opengl/tfx_fs.glsl
required: false
bundled: true
size: 25906
md5: 9d80855607a6da1014f083340741b845
sha1: 919c3308c8850852d529d0127ce94e873375bfd2
description: "OpenGL texture function fragment shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x677328"
- name: tfx.glsl
path: assets/shaders/vulkan/tfx.glsl
required: false
bundled: true
size: 28290
md5: ebc0ffa3de6fd0a7a4dea17f8b74d806
sha1: b4ebf3f7f20fc88f91cda033552a7489a9ff179c
description: "Vulkan texture function shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x682098"
- name: convert.glsl
path: assets/shaders/vulkan/convert.glsl
required: false
bundled: true
size: 8025
md5: 553d33859963a1abe5508e8e45f1cb1e
sha1: 7a133d4cf115dc49cd1921bd7049ea64ad58acce
description: "Vulkan format conversion shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x68394c, nethersx2-turnip-classic v0.7 libemucore.so 0x685fb8"
- name: present.glsl
path: assets/shaders/vulkan/present.glsl
required: false
bundled: true
size: 8177
md5: 72626d625bb963c6cd7074d4dfd0adda
sha1: 4871ee00b249b41d16232769e2f661bedd1c83db
description: "Vulkan presentation shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x684728"
- name: interlace.glsl
path: assets/shaders/vulkan/interlace.glsl
required: false
bundled: true
size: 6707
md5: bf3caa2532873593218bc4a09e924d4e
sha1: f8d14d80036f11707c7e94db2a77531d582019dd
description: "Vulkan deinterlacing shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x684f74"
- name: merge.glsl
path: assets/shaders/vulkan/merge.glsl
required: false
bundled: true
size: 669
md5: b776383d21609db24d5348c381c2c286
sha1: b09de39d6459c70ffab28dcb3e3ef879b1648674
description: "Vulkan frame merge shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x6857c4"
- name: shadeboost.glsl
path: assets/shaders/vulkan/shadeboost.glsl
required: false
bundled: true
size: 1741
md5: 366b45b6c4e9ed8e6b7454eebcb5d010
sha1: 26b29f57685d8108cf519c4f1d340d43aacbff6e
description: "Vulkan brightness and contrast shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x686284"
- name: cas.glsl
path: assets/shaders/vulkan/cas.glsl
required: false
bundled: true
size: 2624
md5: 56f3cf4de895dd4d32d6c79d564d0c5b
sha1: 709fd5393188f7cff0fe4230d0e3e8b69a82f5b9
description: "Vulkan sharpening shader"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x6869c4"
- name: unlock.wav
path: assets/sounds/achievements/unlock.wav
required: false
bundled: true
size: 87714
md5: 4d035ee86f836bfed422a975cf65c9cc
sha1: eb488a76217629f620e40287567d7e2b30337680
description: "Achievement unlock sound"
note: >-
Joined to the file:///android_asset base and handed to playSoundAsync,
which opens it from the package and plays it through MediaPlayer.
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x811190"
- name: lbsubmit.wav
path: assets/sounds/achievements/lbsubmit.wav
required: false
bundled: true
size: 82096
md5: fa6a7030a9f259ee7300dd0bd49f24f3
sha1: 5ad1e110dcf0ffd26405981398892a82e4f3bad1
description: "Leaderboard submission sound"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x811814"
- name: message.wav
path: assets/sounds/achievements/message.wav
required: false
bundled: true
size: 15696
md5: d66b0bccd743bd11eaca55bcaec925da
sha1: c54f04b63ac6f04e0a0944ef260b5497e4494dbd
description: "Achievement notification sound"
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x810254"
- name: placeholder.png
path: assets/placeholder.png
required: false
bundled: true
size: 2762
md5: 8f846541ccbf088ee7f8c49c8dcb3a6a
sha1: c36292ab7e16bf5a6cbc4063f638e24872349c45
description: "Fallback interface texture"
note: >-
Requested from the texture cache when a notification or a loading screen
has no image of its own. A miss logs that it cannot continue and the
caller tears the interface down instead of bringing it up.
source_ref: "nethersx2-turnip-classic v0.7 libemucore.so 0x7d21fc, nethersx2-turnip-classic v0.7 libemucore.so 0x817be0, nethersx2-turnip-classic v0.7 libemucore.so 0x7ec54c"
- name: "<region>.png"
path: assets/icons/flags/NTSC-U.png
required: false
bundled: true
description: "Game list region flag"
note: >-
Loaded as icons/flags/<region>.png with the region string of the entry.
Thirty are carried, seven NTSC and twenty-two PAL plus Other.
source_ref: "nethersx2-turnip-classic v0.7 classes.dex icons/flags/%s.png"
- name: "star-<rating>.png"
path: assets/icons/star-0.png
required: false
bundled: true
description: "Game list compatibility rating icon"
note: "Loaded as icons/star-<rating>.png for ratings 0 to 5."
source_ref: "nethersx2-turnip-classic v0.7 classes.dex icons/star-%d.png"
- name: faq.html
path: assets/faq.html
required: false
bundled: true
size: 14048
md5: c2a64e0bcc401da9b0a3c7adf3cff410
sha1: 9163d4a3d19b87483f843e4bf3afe236a50a72d2
description: "Help page"
note: "Opened under the android_asset scheme by the setup wizard's browser view."
source_ref: "nethersx2-turnip-classic v0.7 classes.dex android_asset faq.html"
- name: 3rdparty.html
path: assets/3rdparty.html
required: false
bundled: true
size: 90296
md5: fb4ff036f3e4769aa6daefdc4c5dba57
sha1: 7743bf1d7e6e09a02f1b2972aa63bd8a9f26050d
description: "Third party notices page"
note: "Opened under the android_asset scheme in the built-in browser view."
source_ref: "nethersx2-turnip-classic v0.7 classes.dex android_asset 3rdparty.html"
exclusion_note: >
Left out are the libraries the package carries for the dynamic linker rather
than for its own code. libc.so, libm.so, libdl.so, ld-android.so, liblog.so
and libc++_shared.so sit beside the drivers so the namespace built over that
directory can satisfy their DT_NEEDED, and no code path names any of them;
android_linker_ns.o is a relocatable object nothing can open. libc++.so and
libsync.so are named in the fallback and promote arrays but the package
carries neither, and the promote call passes RTLD_NOLOAD, which never reads
from disk. libfile_redirect_hook.so and libgsl_alloc_hook.so are reachable
only under feature flags the shim never sets, the only flag passed being the
custom driver one. The system Vulkan loader and libandroid.so come from the
platform. Also left out are the assets no code path on this platform opens:
game_controller_db.txt, whose name appears in neither the library nor the dex,
pad input arriving through handleControllerButtonEvent and
handleControllerAxisEvent; the seven Direct3D shader sources under
shaders/dx11; icons/AppIconLarge.png and cover-placeholder.png;
fonts/Roboto-Regular-copyright and sounds/achievements/README.txt, which are
licence and credit texts; and dexopt/baseline.prof and baseline.profm, which
the Android runtime consumes. Everything the emulator produces for itself
under the data directory is out as well: memory cards as Mcd<nnn>.ps2 and
Mcd-Multitap<n>-Slot<nn>.ps2, DEV9hdd.raw for the internal disk, save states,
screenshots, covers, texture dumps, playtime.dat, emulog.txt, imgui.ini,
per-game settings, input profiles, the gamedb and gl_programs caches, and
vulkan_shim.log.
ref: VulkanShim2/vulkan_shim.cpp:1099-1105, VulkanShim2/vulkan_shim.cpp:1150,
VulkanShim2/vulkan_shim.cpp:1179-1194,
nethersx2-turnip-classic v0.7 libemucore.so 0x4a8c7c
Reference in new issue View Git Blame Copy Permalink