Developer Reference

Developer Reference

Repositories

• PlayFusion source
• Runtime catalog/downloads
• Kazeta upstream
• Kazeta+ upstream

Runtime format

.kzr files are compressed EROFS images. An emulator runtime commonly contains:

.config/retroarch/cores/CORE_libretro.so
.kazeta/share/licenses/
.kazeta/share/run
RetroArch.AppImage

Build/inspection requires erofs-utils (fsck.erofs, mkfs.erofs). The main source repository includes builders for the PlayFusion RetroArch suite and standalone Vita3K/xemu packages.

Cart metadata

[Desktop Entry]
Name=Example Game
Id=example-game
Exec=example/game.rom
Icon=example/icon.png
Runtime=systemname

IDs must be stable and unique. Use a 32x32 or larger PNG icon; PlayFusion also supports common cover formats and normalizes cached artwork.

Public release rules

• Never commit BIOS, keys, ROMs, games, saves, profiles, passwords, or tokens.
• Keep third-party source/license attribution.
• Publish large installers and .kzr files as GitHub Release assets, not Git blobs.
• Provide SHA-256 manifests and verify remote asset sizes/digests.
• Test a clean install, fresh save creation, profile save isolation, both factory games, and failed services before promoting a release.