Skip to content

CMVS

plugin_id: shinki.emu.cmvs · Engine family: CMVS

This is an in-tree ShinkiEMU core, with no separate external fork. See Source/Families/shinki-emu-cmvs and ORIGINS for source revisions.

The in-tree core reads CPZ5 archives and executes PS2A through its native scheduler. cmvs.profile.json uses shinki.emu.cmvs.profile.v2; ordered archive roles and role-specific loose files are explicit. The default entry is start.ps3, with Script slot 0 initialized from cmvs.cfg. Script, texture and native search domains remain distinct; a selected damaged loose resource is not silently replaced by an archive match.

The native owner controls VM, Scene and media. It preserves PS2A return-code stack behavior and native commands 693/694 for saving/loading. Menu entry suspends the story context; restoration keeps slot objects, texture relationships and placements rather than adopting the menu’s temporary scheduler. Corrupt save candidates cannot partly replace live state or overwrite original files.

Core-owned audio mixes BGM/crossfades/effects and converts to the real output device. MGV keeps its slot-2 audio clock and existing Theora rules. Cancellation wakes queues, and close joins VM, audio and decoders; CPU leases remain returnable afterward.

Only one CMVS session may be open at a time. The current reader rejects unsupported CPZ versions, unsafe paths, unknown commands and unrecovered string domains. Every platform uses the same portable rasterizer, which follows GDI’s hinted 17-level GGO_GRAY4_BITMAP rules. Advances match GDI. Grayscale bitmaps are close but not identical: across all 7,494 CP932 characters of MS Gothic at 12–48 px, inked pixels differ by 0.05–0.43 levels on average, and 64–88% of glyphs have the same black box. A font family that is not installed is substituted with the bundled Noto Sans JP, as GDI’s font mapper would substitute another face. Registry values that the original engine reads from HKCU\Software\<REG> are read from .shinki/cmvs/registry.json in the game directory. Saves stay in the original game/save/ location and format. Documents/AppData save-root behavior is not reconstructed.

See the core directory for build/release status and compatibility reports for specific releases. See also Core ABI and User guide.