Files
libretro/emulators/ishiiruka.yml
Abdessamad Derraz de1940d57c feat: hle_fallback on 39 emulator profiles (266 entries)
Batch analysis of all 273 profiles to identify HLE/embedded
fallbacks. Added hle_fallback: true where the core has verified
software replacement for missing BIOS files:

- Embedded ROMs: vice (102), ep128emu (22), fuse (18), frodo (4)
- HLE BIOS: bsnes* (33 across 3 profiles), puae (9 AROS),
  noods (4), melonds* (6 FreeBIOS), flycast (3 reios)
- Open-source replacements: sameboy (8), pokemini (1), gpsp (1)
- Built-in fallbacks: np2kai (7), atari800 (6 Altirra),
  picodrive (3), quasi88 (4), gambatte (2)

Conservative: only added where notes or source code confirm HLE.
Skipped 50+ profiles where files are optional alternatives, not
HLE replaceable (neocd, opera, kronos, pcem, etc.)
2026-03-19 13:03:48 +01:00

104 lines
3.7 KiB
YAML

emulator: Ishiiruka
type: libretro
source: "https://github.com/libretro/ishiiruka"
profiled_date: "2026-03-18"
core_version: "Git"
display_name: "Nintendo - GameCube / Wii (Ishiiruka)"
fork_of: Dolphin
systems: [nintendo-gamecube, nintendo-wii]
# Ishiiruka is a performance-focused Dolphin fork with custom GPU backends.
# As a Dolphin fork, it shares the exact same BIOS file requirements and paths.
# DSP HLE is enabled by default (ishiiruka_dsp_hle option), so DSP ROMs are
# only needed when switching to LLE audio for accuracy.
# Libretro paths (from Boot.cpp):
# Sys directory: system/dolphin-emu/Sys/
# User directory: saves/User/ (fallback: system/dolphin-emu/User/)
# Same as dolphin_libretro - uses "dolphin-emu" subdirectory, not "ishiiruka".
# Core options use "ishiiruka_" prefix (ishiiruka_dsp_hle, ishiiruka_efb_scale, etc.)
files:
# -- GameCube IPL (Boot ROM) --
# Region-specific, placed in GC/<region>/IPL.bin
# Searched in User/GC/ then Sys/GC/
- name: "IPL.bin"
path: "GC/USA/IPL.bin"
size: 2097152
required: false
hle_fallback: true
note: "GC NTSC-U boot ROM, same as Dolphin. HLE available"
source_ref: "Source/Core/Common/CommonPaths.h:115"
- name: "IPL.bin"
path: "GC/EUR/IPL.bin"
size: 2097152
required: false
hle_fallback: true
note: "GC PAL boot ROM"
- name: "IPL.bin"
path: "GC/JAP/IPL.bin"
size: 2097152
required: false
hle_fallback: true
note: "GC NTSC-J boot ROM"
# -- DSP ROMs --
# Only needed if DSP LLE is selected (ishiiruka_dsp_hle = disabled)
# Searched in User/GC/ then Sys/GC/
- name: "dsp_rom.bin"
path: "GC/dsp_rom.bin"
size: 8192
required: false
hle_fallback: true
note: "DSP instruction ROM for LLE audio. Free replacement included, real dump more accurate"
source_ref: "Source/Core/Common/CommonPaths.h:112, Source/Core/Core/HW/DSPLLE/DSPLLE.cpp:142-150"
- name: "dsp_coef.bin"
path: "GC/dsp_coef.bin"
size: 4096
required: false
hle_fallback: true
note: "DSP coefficient ROM for LLE audio. Free replacement included"
source_ref: "Source/Core/Common/CommonPaths.h:113, Source/Core/Core/HW/DSPLLE/DSPLLE.cpp:143-152"
# -- GameCube Fonts --
# Loaded from Sys/GC/, free alternatives bundled
- name: "font_western.bin"
path: "GC/font_western.bin"
required: false
hle_fallback: true
note: "Windows-1252 font for GC/Wii text. Free alternative bundled"
source_ref: "Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:123"
- name: "font_japanese.bin"
path: "GC/font_japanese.bin"
required: false
hle_fallback: true
note: "Shift-JIS font for Japanese text. Free alternative bundled"
source_ref: "Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:122"
notes:
dolphin_fork: true
fork_differences: >
Ishiiruka is a Dolphin fork focused on GPU performance (custom texture cache,
asynchronous shader compilation, post-processing). The BIOS/firmware handling
is identical to upstream Dolphin - same files, same paths, same HLE fallbacks.
hle_available: true
hle_note: >
DSP HLE is the default (ishiiruka_dsp_hle = enabled). No BIOS files are
required for most games. All files are optional with HLE/free replacements.
libretro_path: "system/dolphin-emu/"
libretro_note: >
Despite being named Ishiiruka, the libretro core uses "dolphin-emu" as its
system subdirectory (Boot.cpp:46,49). Users with existing Dolphin BIOS files
already have everything Ishiiruka needs.
data_dir_standalone: "ishiiruka"
data_dir_note: >
Standalone builds use "ishiiruka" as DOLPHIN_DATA_DIR (CommonPaths.h:24,27),
but the libretro core overrides this to use "dolphin-emu" paths.
library_name: "Ishiiruka"
valid_extensions: "elf|dol|gcm|iso|tgc|wbfs|ciso|gcz|wad"