Musica
plugin_id: shinki.emu.musica · Engine family: Musica
This is an in-tree ShinkiEMU core, with no separate external fork. See Source/Families/shinki-emu-musica and ORIGINS for source revisions.
Formats
Section titled “Formats”This in-tree core reads PAZ archives and native SC scripts, including split archives, archive-role keys, transforms and bounded decompression. The private key.toml uses shinki.emu.musica.keys.v2; algorithm parameters and keys are explicit. Probe recognition does not install keys. Standard loose SC and configured PNG replacements remain confined to the game root.
Native behavior and limits
Section titled “Native behavior and limits”A core owner runs the SC VM, hardware offscreen composition and native audio. Title launch precedes story execution by default. Input and frame polling never advance the VM. The current presentation includes a 1280×720 layout and Noto Sans JP binding; host resizing does not rewrite game coordinates. Movie ASS subtitles use actual movie clocks and explicit fonts; BGM subtitle mappings are rejected on this path.
Unknown commands, unsupported effects and device failures remain explicit. Audio currently decodes whole bounded resources rather than arbitrary-length streaming.
When the game directory holds eden_en.exe or perseus.exe, Musica reads and writes the original minori files byte-compatibly under <game>/.shinki/musica/minori/<title>/. The original keeps the same files in Documents\minori\<title>\; Musica never writes to Documents. The title folder is eden (English edition) for eden and 夏空のペルセウス for Perseus. The original Perseus passes that name to ANSI APIs, so on a Windows system whose code page is not CP932 its Documents folder appears under a garbled name (for example 壞嬻偺儁儖僙僂僗 with GBK).
| File | Contents |
|---|---|
system.dat |
Global flags and clear state |
sysparams.txt |
Settings, quick save and auto save cursors (tab-separated, CRLF) |
<script>.tbr |
Read-message bitmap of one script |
cgv.dat |
Viewed CG list |
edenNNNN.sav / edenPMNNNN.sav, perseus_NNNN.sav |
Native message checkpoint and history |
Matching .png |
Opaque RGB box-average thumbnail: eden 128×80, Perseus 106×60 |
To use an original installation’s progress or settings, copy the files from Documents\minori\<title>\ into .shinki/musica/minori/<title>/; copy them back the same way to continue in the original executable. sysparams.txt keys Musica does not use, such as the font name or window size, are kept as they are. Settings the original has no key for are stored in .shinki/musica/musica-settings.txt in the same layout; for eden this holds the five per-character voice toggles.
Compressed files start with a prefix derived from the Perseus SerialCode. On Windows, Musica reads the CRC32 of HKLM\Software\minori\perseus SerialCode. Without that value it reuses the prefix of an existing original file in the folder, otherwise it writes 0. eden always uses 0.
Known difference: system.dat, sysparams.txt and the file prefixes are byte-identical to the original. For the zlib-compressed .tbr and cgv.dat, the decompressed contents are identical but the compressed bytes usually differ, because Musica’s deflate encoder makes different choices than the original’s zlib. The original executable reads these files normally. Musica rewrites a file only when its contents change, so copied files stay byte-for-byte as they were until a new read flag or CG is recorded.
Earlier JSON settings, quick-save cursors and global progress in .shinki/musica/saves/ retain their one-time, no-clobber import into native files. Unknown executables cannot read or write native slots.
All live save/load actions use the native backend. Checkpoints restore script variables, background, composite foreground, stand positions/offsets, BGM, message history and novel-mode (CP1=2) page lines with L4_n positions. Loading restarts the recorded message and its voice; playback clocks, translations and menu focus are not stored. Unsupported effect/secondary-layer state is rejected, with no snapshot fallback.
eden uses auto slot 0 and quick slots 1–9; AppendPlaying selects the edenPM namespace. Perseus uses quick slots 0–9, auto slots 10–19 and manual slots 20 onward. Autosaves run at the native command-count cycle, before selections of up to four choices, and before movies; local exitFromEvent/prohibitAutoSave and global prohibitSaveLoad prohibit autosaving. prohibitSaveLoad also blocks manual save/load. The native thumbnail is written before the compressed slot, each by atomic replacement.
Old beta .asav files (AMUSSV06 and earlier) are incompatible. Musica does not read, convert, move, rename or delete them in either .shinki-musica/saves/ or .shinki/musica/saves/. Keep backups and start a new native slot.
ReMinori is a separate implementation with different execution, configuration and saves.
See the core directory for build/release status and compatibility reports for specific releases. See also Core ABI and User guide.