Zero-dependency native Rust RPF9 (9FPR) & TTPF (RDS5/ETPF) explorer — native Xbox Series X PS\x00\x09 AMD RDNA2 (GFX10.3) Shader Disassembler & HLSL/SPIR-V Lifter, dedicated 10-category RAGE 9 3D Model Viewer, 100% RDNA2 texture decoder (all 20 DXGI formats), native 0DRPz/RBF0/GFx UI & text decoders, CNavMesh 3D viewer, pure-Rust ADAT Opus audio, and docked D3D11 Bink2 player
Latest Release: Download PercyStar v1.3.8 (Win64 + In-App Auto-Updater) · macOS Universal Build
Live Research & Breakthroughs Dashboard: percystar-breakthroughs.vercel.app · Interactive NavMesh World Map
Windows users on v1.0.3+ can click the golden ★ Update Available pill inside PercyStar for 1-click self-update.

Watch the 31-second promo (MP4)
- Format 99
float3Meshlet Positions & Signed UVs (src/model3d/vertex_stream.rs)- Bounded vertex-stream decoder supporting raw
float3(format99) alongside packed format66(cables, water, compact headers without quantization), signed format-40/ float format-66UVs, and atomic rejection of corrupt/non-finite streams.
- Bounded vertex-stream decoder supporting raw
- 4 GiB+ TTPF Logical Texture Addressing (
src/tex.rs)- Reads full
40-bitTTPF logical size and21-bitpage addresses so>4 GiBmap/vehicle texture descriptors resolve without wrapping.
- Reads full
- 3D World Map & Hillshaded Terrain (
src/worldmap.rs)- Interactive World Map tab with
2048×2048MHIUelevation map, clickableNavMeshsector overlay,3D Terrain(256×256mesh with baked512×512sun-angle hillshaded texture + daylight skybox +WASD/Q/Efly camera), and async background-loaded 3D City Blocks (Brickell SLOD).
- Interactive World Map tab with
- 3D Cutout Transparency, Glass & Decal Blending (
src/model3d.rs,src/tex.rs)- Preserves BC1 1-bit cutout alpha & A8 opacity masks, hides shadow-only proxy meshes in
Textured/Matpreview, and composites decals + translucent glass far-to-near. - Added Videos shortcut in Model Viewer and unified Open File... support for
.rpf,.ttpf,.obj, and.ps09.
- Preserves BC1 1-bit cutout alpha & A8 opacity masks, hides shadow-only proxy meshes in
- Upgraded AWC Waveform Audio Player & Superblock Splitting (
src/awc.rs,src/audio_player.rs)- Detailed
ADATheader/chunk hex diagnostics with Copy button,0x80000(512 KB) superblock stream de-interleaving, virtualizedScrollArea::show_rowsstream list with search filter, 200-bin peak/RMS waveform seek bar with smooth drag scrubbing, live dBFS meter,Loop/Autoadvance,Space/Left/Rightshortcuts, and Export WAV.
- Detailed
- Keyboard Asset Navigation (
src/main.rs)- Fast
ArrowUp/ArrowDown/PageUp/PageDown/Home/End(plusW/Swhen not in 3D view) browsing across Explorer & Model Viewer lists with auto-scroll.
- Fast
-
MHIU2048×2048World Heightmap Decoder (src/tex.rs)- Decodes row-compressed
MHIUterrain heightmaps (-13000..+7000X,-9000..+11000Y,-50..+500mZ) into a colorized2048×2048elevation texture with zoom & PNG export.
- Decodes row-compressed
-
DATAudio Metadata (src/dat.rs),Cutscene.cutc&phBoundAABB (src/rsc9.rs)- Decodes
DAT25/26/41/61.relhash->object index tables,story000cutscene cast/prop/.animmanifests, andphBoundcollision AABBs.
- Decodes
-
Live 3D Stick-Man Dummy Animation Player (
src/anim.rs)- Z-up articulated 3D stick-man rig with Play/Pause + timeline scrubber driven by decoded
crClipDictionarydurations, track counts, and clip hashes.
- Z-up articulated 3D stick-man rig with Play/Pause + timeline scrubber driven by decoded
-
SGD5Shader-Group &DXBC/NOBC/FSSMRDNA2 Pipeline- Fast
0x1000-alignedSGD5page scanner (src/sgd5.rs) +NOBCzlib fast-path (0x64/0xA0) +OnceLock-cacheddxcompiler.dlllookup (src/dxbc.rs) feeding directly into the GFX10.3 RDNA2 → HLSL / SPIR-V lifter.
- Fast
-
Full
PSINBinary PSO Schema, Enum & Instance Decoder (src/psin.rs)- Decodes
PSINinstance tables (pppppppp-delimited, 16-byte aligned payloads),LSCH32-byte struct headers & 16-byte field descriptors,LENMenum tables, and resolves JOAAT field/struct/enum hashes across3,900+binary PSO configs (script.rpf,story000_script.rpf,data.rpf).
- Decodes
-
crClipDictionary(ANIM) Decoder (src/anim.rs)- Detects and decodes
0DRPz-backedcrClipDictionaryresources (anim.rpf), extracting clip counts, hash tables, flags, and animation block pointers.
- Detects and decodes
-
0x71717171Pointer-TaggedRSC9Table Decoder (src/rsc9.rs) & SmartRBF0Naming- Decodes
0x71717171pointer-relocatedRSC9hash/data dictionaries (e.g.30,683-entryscript.rpftable) and auto-namesRBF0/ XML config streams by root struct slug.
- Decodes
-
CLI Bring-Up & Format Examples 😉
PercyStar.exe --inspect-exe <example_binary.exe>— inspects PE64 sections, GDK/console imports,9FPR/scrProgramanchors, andMicrosoftGame.Configlayout 😉PercyStar.exe --extract-sgd5 <shaders.rpf> <out_dir>— extractsSGD5DXBC/FSSM RDNA2 shaders 😉
-
Native Xbox Series X
PS\x00\x09AMD RDNA2 (GFX10.3) Shader Disassembler & HLSL / SPIR-V Lifter (Shaders (RDNA2)Tab)- Parses the complete
PS\x00\x09PSO cache (25,471Graphics PSOs,2,693Compute PSOs,54,576metadata blobs,21,522compiled AMD GFX10.3 shaders), including0x41USER_DATAroot-signature bindings (SRV/CBV/UAV/Sampler),COMPUTE_PGM_RSRC1/2, and[numthreads(x,y,z)]. - Auto-tags every shader stage (PS, VS, CS, NGG/Meshlet
exp prim, and Hardware RTimage_bvh64_intersect_ray). - Live 3-view inspector (
GFX10.3 ASM·Lifted HLSL (SM 6.6)·SPIR-V 1.5 / SGPR ABI) + 1-click Export.hlsl/.spv/.asmand CLI batch exporter.
- Parses the complete
-
Dedicated 3D Model Viewer Tab (
Explorer | Model Viewer | Shaders (RDNA2))- Full-screen 3D workspace built for instant 60 FPS browsing across 144,000+ RAGE 9 3D models.
- 10 Strict RAGE 9 Categories with live counts: All Models, Vehicles, Air & Sea, Weapons, Characters, Clothing, Animals (
cr[mbfraci]_taxonomy), Props & Items, World / Map, and NavMesh 3D. - Hide LODs/Bounds toggle (filters
_lod/_slod/batchlod/bipedbounds/collision_),◀ Prev/Next ▶/Randombuttons,Up/Downarrow-key browsing, 5 Camera Presets (3/4,Front,Side,Back,Top), and 1-Click Catalog CSV Import +.OBJloader.
-
100% Console RDNA2 Texture Engine (
.#td&.ttpf)- 100.00% TTPF Format Identification (357,115 / 357,115 textures): Solved ETPF descriptor
u1bits 3..9 ((u1 >> 3) & 0x7F= exact MicrosoftDXGI_FORMATenum) — zero unknown texture formats. - All 20+ DXGI Formats Decoded Natively in Pure Rust:
BC1–BC7,BC6H_UF16/SF16HDR,R16G16B16A16_FLOAT/UNORM,R16_FLOAT/UNORM,R16G16_FLOAT,R32_FLOAT,R10G10B10A2_UNORM,R8G8B8A8,B8G8R8A8,R8_UNORM,A8_UNORM(texture2ddecoder+ IEEE-754 half-float Reinhard tonemapping). - Verified RDNA2 4KB (
SW_4KB_D) & 64KB Deswizzle for All 5 Bit Depths (8 / 16 / 32 / 64 / 128bpp): Plus reverse-mipmip0tail addressing, instantO(log N)RDS5 chunk seeking, exact RDS5 chunk codec decoding (0=RAW,1..7=HW BCPack BC1..BC7,8=ZLIB), interactive zoom viewer, multi-texture strip, and Export PNG / Export DDS (DX10).
- 100.00% TTPF Format Identification (357,115 / 357,115 textures): Solved ETPF descriptor
-
Expanded RAGE 9 3D Meshlet Decoder (
.#dr,.#ft,.#dd,.obj)- Direct click-to-view decoding of unencrypted RAGE 9 virtual (
0x50xxxxxx) + physical (0x60xxxxxx) meshlet resources straight out of.rpfarchives, including+0xA8drawable name resolution and non-zero page header support (38× more models discovered). - Clean LOD0-only extraction (
Lod0 -> grmModel -> grmGeometry), 24/24/16-bit quantized vertices, 7-bit packed meshlet triangles +u16remap table, UV0 (type 0x28), upgraded embeddedSW_4KB_DBC7/BC3/BC1 textures, custom.png/.bmptexture loading, and full.OBJexport (v+vt+f v/vt).
- Direct click-to-view decoding of unencrypted RAGE 9 virtual (
-
Native UI, Localization & NavMesh Decoders (
RBF0,GFX,0DRPz,CNavMesh)0DRPzText / GXT Viewer: Decodes multi-chunk RAGE 9 UTF-8 localization tables & standalone string pools under UI & Text (RBF0/GFX/GXT) with searchable preview-slug filenames.RBF0(fwui) → XML: Handles the 4-byte0xFB 0xFF 0x01 0x00header to decode binary UI resources cleanly into XML (with.xmlexport).- Scaleform GFx v42 (AS3) Inspector: Dumps ActionScript 3 classes, packages, and symbol references.
CNavMesh(0x00010015) 3D Viewer: Detects navigation tiles with world grid coordinates (nav_{gx}_{gy}_(x,y).ynv), triangulates polygons colored by surface type (land/water/road/pavement/interior), and exports.OBJ.
-
100% Native Runtime Dependencies for Audio, 3D, Textures, UI, XML & PSO
- No Python, no FFmpeg, no external DLLs required —
ADAT(.awc) Opus streams decode natively via pure-Rustrusty-opus(RFC 6716). All crates pinned inCargo.lock.
- No Python, no FFmpeg, no external DLLs required —
-
Whole-Folder & Single-Archive Scanning (
.rpf&.ttpf)- Multi-threaded live scanning cached to
%LOCALAPPDATA%\PercyStar\scan_cache_v8.tsv.
- Multi-threaded live scanning cached to
-
Docked D3D11 Bink2 Video Player (Optional
binkplay.exe)- Docks RAD
binkplay.exe(/NoBorder /DrawD3D11 /L) directly into the inspector pane. Runscripts/setup_deps.ps1if needed.
- Docks RAD
-
CLI Batch Exporters (Models, Textures & RDNA2 Shaders)
PercyStar.exe --extract-vehicles "<path-to-levels.rpf>" "<output-dir>" PercyStar.exe --extract-models "<path-to-archive.rpf>" "<output-dir>" "filter1,filter2" PercyStar.exe --dump-textures "<path-to-archive.rpf|.ttpf>" "<output-dir>" [limit] PercyStar.exe --disasm-shaders "<path-to-shaders.rpf|zlib_dir|.ps09>" "<output-dir>" [limit] PercyStar.exe --extract-sgd5 "<path-to-shaders.rpf|SGD5.bin>" "<output-dir>" [limit] PercyStar.exe --disassemble-dxbc "<path-to-shader.dxbc>" ["<output.asm>"]
The Shaders tab is source-driven: opening a raw
shaders.rpfloads the PS09 runtime cache and every SGD5 group, while separate buttons load a PS09 cache, zlib directory, or SGD5.bin. Selecting either source or any shader switches the browser and viewer to that dataset. Both sources support GFX10.3 disassembly plus experimental HLSL and SPIR-V lifting; SGD5 extraction gives each group its own output folder andsgd5_index.csv. GTAWrapped/NOBCshaders are unwrapped to their zlibFSSMpayload before RDNA2 decoding.
PercyStar/
├── assets/
│ ├── logo.png # App & window icon
│ ├── logo.ico # Windows executable icon
│ ├── demo_overview.webp # 30fps Neon Sunset UI, search & updater showcase
│ ├── demo_3d.webp # 30fps 3D meshlet viewer shading modes showcase
│ ├── demo_inspector.webp # 30fps XML / PSIN / ADAT Opus audio showcase
│ ├── preview.png # High-res Neon Sunset screenshot
│ ├── promo.mp4 # 31s promo video
│ └── promo-poster.jpg # Promo poster frame
├── promo/ # HyperFrames source for the promo video
├── scripts/
│ ├── build_macos.sh # Universal macOS (.app / .zip) build helper
│ ├── setup_deps.ps1 # Optional RAD Video Tools (binkplay.exe) setup
│ ├── awc_extract.py # Standalone CLI ADAT (.awc) Opus -> .wav helper
│ └── rpf9_carve.py # Standalone CLI RPF9 carver
├── docs/
│ └── breakthroughs.json # Live-synced research & breakthroughs timeline feed
├── src/
│ ├── main.rs # PercyStar egui app, Model Viewer, RDNA2 Shader Lifter, RPF9/TTPF scanner & CLI
│ ├── rdna2.rs # Console RDNA2 PS\x00\x09 parser, AMD GFX10.3 disassembler, HLSL SM 6.6 & SPIR-V 1.5 lifter
│ ├── sgd5.rs # SGD5 shader-group container & DXBC/FSSM extractor
│ ├── dxbc.rs # DXBC / NOBC / FSSM RDNA2 shader disassembler
│ ├── psin.rs # PSIN binary PSO schema, enum & instance decoder
│ ├── anim.rs # crClipDictionary (0DRPz) animation header decoder
│ ├── dat.rs # RAGE 9 audio metadata (DAT25/26/41/61) decoder
│ ├── rsc9.rs # RSC9 0x71717171 table & phBound AABB inspector
│ ├── boot.rs # PE64 bring-up & manifest inspector (--inspect-exe) 😉
│ ├── model3d.rs # RAGE 9 meshlet decoder, UV/TXD parser & Z-buffer renderer
│ ├── tex.rs # Console RDNA2 4KB/64KB textures, TTPF, RBF0, GFx, 0DRPz & CNavMesh
│ └── awc.rs # Pure-Rust ADAT (.awc) Opus -> .wav decoder
├── app.rc / build.rs # Win32 icon resource
├── Cargo.toml / Cargo.lock # All Rust crate dependencies pinned cleanly
└── LICENSE
Requires Rust (x86_64-pc-windows-gnu with MinGW windres/dlltool, or msvc). Cargo fetches all pinned dependencies from Cargo.lock:
- Original Creator:
@rpatty-dev(@rpatty) - Contributors:
@Ahmet-Dedeler(Percy6Stars) — macOS build & 3D viewer PRs (#6, #7),RADTools.exeinstaller fix, mip0/mip1 placement insight, cutout/glass/decal blending, shadow-proxy hiding, and Videos/OBJ/PS09 UX improvements.@GamingChelsea(PR #10) — AWC decode diagnostics, 512 KB superblock stream splitting, and waveform audio player foundation (upgraded with zero-copy ring buffers, smooth drag scrubbing, stream filter, Loop/Auto-Next, WAV export, and keyboard shortcuts).@kotelkonrad(Issue #11) — suggested arrow-key / WASD asset browsing navigation.@techfoundrynz(PRs #12, #13) — 40-bit/21-bit>4 GiBTTPF texture addressing and format 99float3meshlet vertex-stream decoder.@paryzius(ttpf-viewer) —.ttpfreduced-mip fallback when mip 0 sits in unreadable BCPack/truncated chunks.@holdmysocks(SixNG) —0DRPz(0x7a) map placement schema (0xd3593fa6/0xce501483) for world entity streaming.@Xyzstk—SGD5&DXBC/FSSMRDNA2 shader PR (#8).
cargo test --release
cargo build --releaseCompiled standalone binary: target/release/PercyStar.exe.
PercyStar is an independent, clean-room binary inspection and parser tool built from scratch in Rust. It only parses unencrypted, user-supplied files (KB2* streams, ADAT audio, plain zlib XML/PSIN containers, and standard uncompressed meshlet vertex/index blocks) for research and interoperability (cf. 17 U.S.C. § 1201(f)):
- Zero Circumvention / Zero Keys: Contains no decryption routines, encryption keys, hashes, DRM bypasses, or access-control workarounds. Encrypted data is skipped untouched.
- Zero Proprietary Content: Ships no third-party binaries, copyrighted models, textures, audio, shaders, or game assets. Users are solely responsible for supplying archives they legally own or are authorized to inspect.
- Independent Trademark Disclaimer: PercyStar is an independent open-source project and is not affiliated with, endorsed by, or sponsored by any game studio or publisher.
Copyright (c) 2026 rpatty-dev — All Rights Reserved.
See LICENSE. You may download, run, and fork this repository on GitHub for personal use/reference, but you may not modify, alter, or redistribute modified versions of the code or binaries without explicit written permission.




