Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Library:JSystem

From ReverseEngineering.wiki
Library
Vendor Nintendo EAD
Uses Library:Dolphin SDK
Platforms Platform:Nintendo GameCube, Wii
On this wiki Facts · Code · Notes · Topics

Nintendo EAD's in-house C++ middleware for GameCube and Wii games (Super Mario Sunshine, The Wind Waker, Pikmin 2, Twilight Princess, Mario Kart: Double Dash!!, Super Mario Galaxy). Classes carry a J-prefix by module: JKR (JKernel: heaps, threads, archives, Yaz0/Yay0 decoding, ARAM), J3D (3D models), J2D, JUT (utilities), JAudio, JPA (particles), JStudio (cutscenes).

Overview

JSystem is compiled with Tool:Metrowerks CodeWarrior, so its names are CodeWarrior-mangled C++ (decodeSZS__9JKRDecompFPUcPUcUlUl, __vt__10JKRArchive). The module prefixes make it easy to spot in a symbol list or in assertion strings (JKRMemArchive.cpp).

Modules

As split in Software:The Legend of Zelda: The Wind Waker (number of source files): JAudio (66), JStudio (26), JKernel (25), JUtility (21), JParticle (18), J3DGraphBase (11), J3DGraphAnimator (9), J2DGraph (8), J3DGraphLoader (8), JStage (7), JMessage (4), JSupport (4), J3DU (3), JGadget (3), JFramework (2), JMath (2), JRenderer (1). About 4,000 functions in that game.

JKernel resources

  • JKRArchive and subclasses mount Format:RARC archives from memory (JKRMemArchive), ARAM (JKRAramArchive), DVD (JKRDvdArchive) or a mixed layout (JKRCompArchive).
  • JKRDecomp decodes Format:Yaz0 (decodeSZS) and Format:Yay0 (decodeSZP); checkCompressed looks at bytes 0, 1 and 3 for Ya?0 and byte 2 for z or y.
  • JKRDvdRipper/JKRDvdAramRipper stream and decompress files from disc.

Code & repositories

  • https://github.com/zeldaret/tww @ 8b93b372dc8e841f12ddfb7e0215626f62b05417 · license: CC0-1.0
    Matching decompilation of The Wind Waker for all GameCube releases (GZLE01, GZLP01, GZLJ01, D44J01), CC0-1.0. Decompiled JSystem (JKernel archives and Yaz0/Yay0 decoders), Dolphin SDK (OS, OSLink REL linker, DVD, GX), CodeWarrior runtime; config/<ID>/build.sha1, symbols.txt and splits.txt map every build.
    Tested on: Read at commit 8b93b37: config/GZLE01 (build.sha1, config.yml, symbols.txt, splits.txt), include/dolphin/os/OSLink.h, src/dolphin/os/OSLink.c, src/dolphin/os/__start.c, include/JSystem/JKernel/JKRArchive.h, src/JSystem/JKernel/JKRDecomp.cpp, JKRArchivePri.cpp, JKRCompArchive.cpp; no game files used. · checked 2026-10-17; last activity 2026-10-14
  • https://github.com/magcius/noclip.website @ fd973ff240233c63883750a557c62baf6ff2a6c7 · license: MIT (declared by the contributor for the files used; GitHub reports MIT (read from LICENSE; GitHub's detector did not classify it) for the repository)
    Browser-based map viewer; src/Common/JSYSTEM holds readers for J3D models and animations (J3DLoader.ts), JKRArchive (RARC), JPA particles, J2D and JStudio
    Tested on: source read, not run: source read, not run · checked 2026-10-18; last activity 2026-10-06