Files
libretro/emulators/native32emu.yml
T
Abdessamad Derraz 7560564a09 docs: follow native32emu 1.4.0 save and zip rules
1.4.0 boots a single-game package by its own .smf and, in the Emscripten build, writes saves to the frontend save directory (save_manager.rs:33-48, api.rs:194-197). Still no file outside the game package.
2026-10-26 23:10:38 +01:00

59 lines
3.1 KiB
YAML

emulator: Native32Emu
type: standalone + libretro
core_classification: pure_libretro
source: "https://github.com/AloysHF/Native32Emu"
upstream: "https://github.com/AloysHF/Native32Emu"
profiled_date: "2026-10-26"
source_commit: "059fa33c658caa4dbbad140ebf2af1197f9dd778"
core_version: "1.4.0"
display_name: "Sunplus - Native32 (Native32Emu)"
cores:
- native32emu
systems:
- sunplus-native32
notes: |
Emulator for the Sunplus Native32 game format written in Rust by
AloysHF. The libretro core and the native32emu standalone binary share
the native32emu-core crate. Content (.smf, .sgm, .ssl or a .zip
package) is read from its full path (need_fullpath = true,
crates/native32emu-libretro/src/libretro/api.rs:107;
Emulator::from_path, crates/native32emu-core/src/emulator.rs:86-149).
The header is decrypted with DES keys compiled into the core
(crates/native32emu-core/src/header_decryptor.rs:136,
crates/native32emu-core/src/des_constants.rs).
A .zip package is extracted to a temporary directory
(crates/native32emu-core/src/archive_loader.rs:17-67) and booted from
the menu found at its root, FHUI.smf first, then NA32UI.smf. A package
without a root menu boots its only .smf, or the one named like the
archive (crates/native32emu-core/src/archive_loader.rs:11,
crates/native32emu-core/src/archive_loader.rs:94-98,
crates/native32emu-core/src/archive_loader.rs:152-211). The Emscripten
build receives the archive already extracted by EmulatorJS and switches to
the root menu when one exists
(crates/native32emu-libretro/src/libretro/api.rs:146-159,
crates/native32emu-core/src/archive_loader.rs:112-117). Every later file
is resolved relative to the running content and its parent directories,
case-insensitively with trailing spaces trimmed
(crates/native32emu-core/src/content_loader.rs:73-130): child .smf and
.ssl content (crates/native32emu-core/src/emulator.rs:617-627), .dat
thumbnails for the menu (crates/native32emu-core/src/emulator.rs:565-592),
.mpg cutscenes (crates/native32emu-core/src/emulator.rs:464-480) and
the menu's game listing (crates/native32emu-core/src/file_browser.rs:75-120).
All of them ship inside the game package. Saves are written to
<content>.ssl_sav beside the content. The Emscripten build asks for the
frontend save directory and writes there instead, under a name flattened
from the content path
(crates/native32emu-core/src/save_manager.rs:6-26,
crates/native32emu-core/src/save_manager.rs:33-48,
crates/native32emu-libretro/src/libretro/api.rs:194-197,
crates/native32emu-libretro/src/libretro/callbacks.rs:205-222).
RETRO_ENVIRONMENT_GET_SYSTEM_DIRECTORY is defined
(crates/native32emu-libretro/src/libretro/constants.rs:42) but nothing
calls it. No include_bytes! data is compiled in.
exclusion_note: "No file is read outside the game package: content and every sibling it names (menu, child content, .dat thumbnails, .mpg cutscenes) resolve from the content's own directory tree, saves are written beside the content or in the frontend save directory, the system directory is never queried, no data is embedded with include_bytes!, and the .info declares firmware_count = 0."
files: []