chore: merge launcher placement

emulators/azahar.yml

@@ -19,6 +19,9 @@ cores:
 systems:
   - nintendo-3ds
 
+standalone_directories:
+  - "$XDG_DATA_HOME/azahar-emu"
+  - "$HOME/.local/share/azahar-emu"
 data_root:
   windows:
     path: "%APPDATA%/Azahar"

emulators/eden.yml

@@ -60,6 +60,9 @@ files:
     note: "Amiibo decryption keys (two InternalKey structs, 0x50 bytes each)"
     source_ref: "src/core/hle/service/nfc/common/amiibo_crypto.cpp:281-302"
 
+standalone_directories:
+  - "$XDG_DATA_HOME/eden"
+  - "$HOME/.local/share/eden"
 data_root:
   windows:
     path: "%APPDATA%/eden"

emulators/lexaloffle.yml

@@ -24,12 +24,19 @@ cores:
 systems:
   - pico8
   - voxatron
+standalone_directories:
+  - "executable directory"
 
 notes: |
   Commercial fantasy consoles by Lexaloffle Games LLP, sold as ZIP archives
   per platform. Nothing in either program checks a hash of its own files:
   the hashes below are those of the files in the official 0.2.7 archives.
 
+  Each program finds its own folder through /proc/self/exe and reads its
+  .dat beside itself. The paths below are the layout of the archives, whose
+  top folders are pico-8/ and voxatron/: a launcher that runs one of these
+  files from a folder places the program folder there.
+
   PICO-8 0.2.7 ships five archives. pico-8_0.2.7_amd64.zip holds pico8
   (x86_64, SDL2 linked in) and pico8_dyn (x86_64, system libSDL2).
   pico-8_0.2.7_raspi.zip holds pico8 (armhf, SDL2 linked in, needs the
@@ -67,7 +74,7 @@ notes: |
     component_manifest.json lists pico8, pico8.dat and pico8_dyn as required.
   - RetroBat Pico8.Generator.cs runs pico8.exe from the folder its config
     names pico8 and returns nothing when pico8.exe is absent. That folder is
-    an emulator install, outside the BIOS tree, so no entry below targets it.
+    an emulator install, outside the BIOS tree.
   - ArkOS (dArkOS pico8/pico8.sh) prefers roms/pico-8/pico8_64, then
     roms/pico-8/pico8_dyn, then extracts pico8_64 and pico8.dat from a
     *raspi.zip in that folder, and starts Fake08 when the binary or
@@ -137,13 +144,13 @@ files:
     path: pico-8/pico8_dyn
     system: pico8
     required: false
-    unread_on: [amberelec, emuelec, knulli, recalbox, retrobat, rocknix]
+    unread_on: [amberelec, emuelec, knulli, recalbox, retrobat]
     size: 1805928
     md5: 724435a9e6f3ef8a55c648fc88651826
     sha1: 9b2e573250c70382b4071709a85c8d56c0371d59
     description: "PICO-8 0.2.7 x86_64 executable, system libSDL2"
-    note: "The pico8_dyn of pico-8_0.2.7_amd64.zip, the same program linked against the system SDL2. RetroDECK lists it as required in its manifest, but its launcher executes pico8 only. Batocera never runs it."
-    source_ref: "pico-8 0.2.7 amd64 pico8_dyn, NEEDED libSDL2-2.0.so.0, RetroDECK pico-8/component_manifest.json:26-32, RetroDECK pico-8/component_launcher.sh:3"
+    note: "The pico8_dyn of pico-8_0.2.7_amd64.zip, the same program linked against the system SDL2. RetroDECK lists it as required in its manifest, but its launcher executes pico8 only. Batocera never runs it. ROCKNIX runs it from roms/pico-8/ on x86_64, its HW_ARCH other than aarch64."
+    source_ref: "pico-8 0.2.7 amd64 pico8_dyn, NEEDED libSDL2-2.0.so.0, RetroDECK pico-8/component_manifest.json:26-32, RetroDECK pico-8/component_launcher.sh:3, rocknix projects/ROCKNIX/packages/emulators/standalone/pico-8/scripts/start_pico8.sh:10-17, 48"
 
   - name: pico8_dyn
     path: pico-8/pico8_dyn
@@ -173,14 +180,37 @@ files:
     path: pico-8/pico8.dat
     system: pico8
     required: true
-    unread_on: [retrobat]
     size: 11243101
     md5: 10b397305093c80109096319a538ba56
     sha1: 0f92093752bddb12210c7db6d93af3ba2413cfce
     description: "PICO-8 0.2.7 data file (boot sequence, themes, demo carts)"
-    note: "PICO-8 opens it from its own folder and quits with \"couldn't load <folder>/pico8.dat\" when it is absent (the amd64 pico8, run without it). Paired with the binary's own version, identical in pico-8_0.2.7_amd64.zip and pico-8_0.2.7_raspi.zip. AmberELEC and ArkOS check for it before starting PICO-8, and KNULLI's installer stops when the archive lacks it."
+    note: "PICO-8 opens it from its own folder and quits with \"couldn't load <folder>/pico8.dat\" when it is absent (the amd64 pico8, run without it). Paired with the binary's own version, identical in pico-8_0.2.7_amd64.zip, pico-8_0.2.7_raspi.zip and pico-8_0.2.7_windows.zip. AmberELEC and ArkOS check for it before starting PICO-8, and KNULLI's installer stops when the archive lacks it."
     source_ref: "pico-8 0.2.7 amd64 pico8, string pico8.dat at 0x231bc0, pico-8 0.2.7 raspi pico8_64, string pico8.dat at 0x110138, amberelec packages/amberelec/sources/pico-8.sh:51-52, dArkOS pico8/pico8.sh:136-142, knulli board/fsoverlay/usr/bin/knulli-install-pico8:11, 48-51, 69"
 
+  - name: pico8.exe
+    path: pico-8/pico8.exe
+    system: pico8
+    required: true
+    unread_on: [amberelec, batocera, emuelec, knulli, recalbox, retrodeck, rocknix]
+    size: 2171788
+    md5: 55b1b9db521ffd0cea0995174bd12a2b
+    sha1: 1d1b504d3283d750869a93ed9befa1e49928d68e
+    description: "PICO-8 0.2.7 Windows executable"
+    note: "The pico8.exe of pico-8_0.2.7_windows.zip. RetroBat runs it from its pico8 emulator folder and starts nothing when it is absent."
+    source_ref: "retrobat emulatorLauncher/Generators/Pico8.Generator.cs:14-18, 56-57"
+
+  - name: SDL2.dll
+    path: pico-8/SDL2.dll
+    system: pico8
+    required: true
+    unread_on: [amberelec, batocera, emuelec, knulli, recalbox, retrodeck, rocknix]
+    size: 1088000
+    md5: 098c661f98cd7fd85a82ebc34db5be15
+    sha1: 9174251921d675c204e683cdea65a8c906fcba28
+    description: "SDL2 library of the PICO-8 0.2.7 Windows build"
+    note: "pico8.exe imports SDL2.dll, which Windows loads from the executable's folder. Shipped beside it in pico-8_0.2.7_windows.zip."
+    source_ref: "pico-8 0.2.7 windows pico8.exe, import table"
+
   - name: config.txt
     unsourceable: "written by the emulator on exit, no canonical file"
     system: pico8

emulators/ryujinx.yml

@@ -16,6 +16,9 @@ systems: [nintendo-switch]
 analysis_date: "2026-03-26"
 mode: standalone
 
+standalone_directories:
+  - "$XDG_CONFIG_HOME/Ryujinx"
+  - "$HOME/.config/Ryujinx"
 data_root:
   windows:
     path: "%APPDATA%/Ryujinx"

emulators/uae4all.yml

@@ -16,6 +16,8 @@ display_name: "Commodore - Amiga (UAE4All2)"
 cores: [uae4all]
 systems: [commodore-amiga]
 verification: existence
+standalone_directories:
+  - "getcwd"
 
 notes: |
   UAE4All2 is Lubomyr's Android and Pandora Amiga emulator. RetroPie builds
@@ -26,9 +28,11 @@ notes: |
   com.cloanto.amigaforever.essentials is therefore compiled out.
   AndroidAppSettings.cfg:178 names the version 2.3.6.2.
 
-  The emulator runs from its install directory and takes it as launchDir
-  (src/main.cpp:219). Kickstarts are read from launchDir/kickstarts/, which
-  RetroPie links to the BIOS directory's amiga/ folder
+  launchDir is the working directory (getcwd, src/main.cpp:219), and the
+  Kickstarts and rom.key are read from launchDir/kickstarts/
+  (src/main.cpp:95-111). Paths below are relative to the working directory.
+  RetroPie starts the emulator in its install directory and links
+  kickstarts/ there to the BIOS directory's amiga/ folder
   (scriptmodules/emulators/uae4all.sh, configure_uae4all).
 
   The kickstart choice indexes kickstarts_rom_names and extended_rom_names
@@ -54,37 +58,36 @@ notes: |
 
 files:
   - name: "kick13.rom"
-    path: "amiga/kick13.rom"
+    path: "kickstarts/kick13.rom"
     system: commodore-amiga
     description: "Kickstart 1.3, the default selection"
     required: false
     source_ref: "upstream src/memory.cpp:34, source src/main.cpp:1, source src/main.cpp:95-103"
 
   - name: "kick12.rom"
-    path: "amiga/kick12.rom"
+    path: "kickstarts/kick12.rom"
     system: commodore-amiga
     description: "Kickstart 1.2"
     required: false
     source_ref: "upstream src/memory.cpp:34"
 
   - name: "kick20.rom"
-    path: "amiga/kick20.rom"
+    path: "kickstarts/kick20.rom"
     system: commodore-amiga
     description: "Kickstart 2.0"
     required: false
     source_ref: "upstream src/memory.cpp:34"
 
   - name: "kick31.rom"
-    path: "amiga/kick31.rom"
+    path: "kickstarts/kick31.rom"
     system: commodore-amiga
     description: "Kickstart 3.1"
     required: false
     source_ref: "upstream src/memory.cpp:34"
 
   - name: "aros-amiga-m68k-rom.bin"
-    path: "amiga/aros-amiga-m68k-rom.bin"
+    path: "kickstarts/aros-amiga-m68k-rom.bin"
     bundled: true
-    not_bundled_on: [recalbox]
     system: commodore-amiga
     description: "AROS Kickstart replacement, main ROM (build of 2014-01-10)"
     required: false
@@ -96,9 +99,8 @@ files:
     note: "Hashes are of the file in AndroidData/aros20140110.zip in the source tree. RetroPie unpacks that zip into the BIOS folder on install."
 
   - name: "aros-amiga-m68k-ext.bin"
-    path: "amiga/aros-amiga-m68k-ext.bin"
+    path: "kickstarts/aros-amiga-m68k-ext.bin"
     bundled: true
-    not_bundled_on: [recalbox]
     system: commodore-amiga
     description: "AROS Kickstart replacement, extended ROM (build of 2014-01-10)"
     required: false
@@ -110,8 +112,23 @@ files:
     note: "Loaded with the AROS main ROM only. Hashes are of the file in AndroidData/aros20140110.zip in the source tree."
 
   - name: "rom.key"
-    path: "amiga/rom.key"
+    path: "kickstarts/rom.key"
     system: commodore-amiga
     description: "Cloanto key for AMIROMTYPE1 encrypted Kickstarts"
     required: false
     source_ref: "upstream src/main.cpp:106-111, source src/memory.cpp:732-776"
+
+  - name: "kick.rom"
+    path: "kick.rom"
+    system: commodore-amiga
+    description: "Custom Kickstart, the file the custom choice opens until the user picks another"
+    required: false
+    source_ref: "source src/gp2x/menu/menu_config.cpp:139, source src/gp2x/menu/menu_config.cpp:1243-1246, source src/menu_guichan/menu_guichan.cpp:91-99, source src/menu_guichan/menu_guichan.cpp:1004-1006, source src/main.cpp:100-104"
+    note: "Read from the working directory. default_prefs also falls back to it when the selected Kickstart is missing from kickstarts/."
+
+  - name: "rom.key"
+    path: "rom.key"
+    system: commodore-amiga
+    description: "Cloanto key, read from the working directory when kickstarts/rom.key is absent"
+    required: false
+    source_ref: "source src/main.cpp:106-111, source src/memory.cpp:732-776"

emulators/yuzu.yml

@@ -56,6 +56,9 @@ files:
     note: "Amiibo decryption keys (two InternalKey structs, 0x50 bytes each)"
     source_ref: "src/core/hle/service/nfc/common/amiibo_crypto.cpp:273-294"
 
+standalone_directories:
+  - "$XDG_DATA_HOME/yuzu"
+  - "$HOME/.local/share/yuzu"
 data_root:
   windows:
     path: "%APPDATA%/yuzu"