AnyPS5/docs/dev/debt/libScePlayGo.md

libScePlayGo technical debt

Unknown function info

• scePlayGoRequestNextChunk, scePlayGoSnapshot (libScePlayGo) - their names and NIDs are in the PS5 3.20 export inventory, but no credible prototypes were found. They are declared without parameters solely to resolve known imports; this is not an ABI claim
• scePlayGoSetLanguageMask (libScePlayGo) - stores the mask that scePlayGoGetLanguageMask then reports, and returns SCE_PLAYGO_ERROR_BAD_HANDLE for another handle, as shadPS4 does on the PS4. shadPS4 also returns SCE_PLAYGO_ERROR_NOT_INITIALIZED before scePlayGoInitialize and starts from the system language's mask; here the mask starts with every language and initialization is not tracked. Not measured on a PS5
• libScePlayGo - the chunk set comes from playgo-chunkdefs.xml (every listed chunk plus chunks 0 through the default chunk), otherwise from sce_sys/playgo-chunk.dat, whose plgx header is read as holding the chunk count as a 16-bit value at offset 0x0A and ids 0 to count - 1 are taken as valid. The field was identified on four dumps, where exactly that many 0x20-byte entries follow from offset 0x100 (RIDE 4 PPSA01599: 35, Persona 5 Royal PPSA05110: 25, LEGO Horizon Adventures PPSA14632 and Kena PPSA01802: 1); the rest of the format is not decoded and ids are assumed to be contiguous. Every listed chunk is reported as installed (LOCAL_FAST). Without either file, a package with sce_sys/playgo-scenario.json (PPSA01748, whose dump lists no chunks) accepts every chunk id as installed, and scePlayGoGetChunkId lists ids 0 to 999. A title that builds its set of installed chunks from that list skips any chunk it does not see. The console's chunk limit is not known here, and a package with more chunks would see ids from 1000 up as not listed. A package with no playgo-* file in sce_sys (PPSA03001, PPSA03490 and PPSA01285 here) accepts chunk 0; querying any other id throws with a message naming the missing playgo-chunk.dat and playgo-scenario.json, since the incomplete dump cannot establish whether that id exists; APS5_PLAYGO_UNLISTED_CHUNKS=installed answers every such id as installed (LOCAL_FAST, which PPSA15388 needs to load its saves) and =absent answers SCE_PLAYGO_ERROR_BAD_CHUNK_ID (which ends PPSA03001's id walk), as the user's choice for that dump. A sce_sys that holds other playgo-* files (playgo-ficm.dat, playgo-hash-table.dat) without playgo-chunk.dat or playgo-scenario.json, or a playgo-chunk.dat without a plgx header and a nonzero count, throws naming the file, because no such dump is known. These answers are unverified on a console, as is the console's answer for an id outside a package's chunk table.
• libScePlayGo - scePlayGoGetSupportedOptionalChunk and scePlayGoGetOptionalChunk report every bit set for type 0, 1 or 2, i.e. every optional chunk (language pack) supported and installed, like scePlayGoGetLanguageMask. Native requests confirm types 0 through 2 and an eight-byte result; their meanings and bit layout are still determined by the external service, not this module; PPSA01748 calls both with type 0 and hides every text language listed in playgo-scenario.json chunkSupportedLanguages when the bitmask is 0. The console's answer for a package that ships no optional chunks is unverified.