Skip to content

PercyStar v1.5.0 — Speed Release

Choose a tag to compare

@rpatty-dev rpatty-dev released this 22 Nov 18:39
· 4 commits to main since this release

Every hot path was timed on a real GTA VI build (Ryzen 5 3600XT, 16 GB RAM, game on a 7200 rpm HDD), then made faster without changing a single result. Best of 3 runs, warm files, same machine, back to back:

Task v1.4.8 v1.5.0 Faster
Load scan index at startup (1.32M entries) 1671 ms 640 ms 2.6x
Build search index 687 ms 62 ms 11x
Search query (adder) 54.5 ms 12.4 ms 4.4x
Search query (tex_ bc7 -mip) 61.4 ms 11.9 ms 5.2x
Save scan index 4227 ms 509 ms 8.3x
Open 40 texture dictionaries (textures.rpf) 15428 ms 5980 ms 2.6x
Decode 60 TTPF textures 9.8 ms 5.1 ms 1.9x
Scan data.rpf (459 MB) 4517 ms 1887 ms 2.4x
Scan shaders.rpf (393 MB) 1347 ms 945 ms 1.4x
Scan script.rpf 34.5 ms 19.8 ms 1.7x
Scan common.rpf 82.2 ms 49.6 ms 1.7x
Scan packs.rpf (4.5 GB, disk bound) 40.4 s 33.3 s 1.2x

Proof the output is identical: the benchmark prints a checksum of every scan result, every decoded pixel and the whole search index. All of them match between v1.4.8 and v1.5.0, and a save then reload of the scan index gives back the same data. Full raw output: docs/bench/v1.4.8_vs_v1.5.0.txt.

Run it yourself: PercyStar.exe --bench "<game folder>" [runs] [filter] (filter is a comma list such as cache,txd,data.rpf).

What changed:

  • BC1 / BC2 / BC3 / BC4 / BC5 / BC6H / BC7 decoding uses every CPU core (image split into bands of block rows). BC7 was 80% of texture dictionary load time.
  • zlib now uses the zlib-rs backend (pure Rust, faster inflate) for all archive reads.
  • Archive scanning probes every 4 KB page on all cores and reads the next 16 MB chunk on its own thread while the current one is probed, so the disk never waits. Same for the levels.rpf vehicle index.
  • Scan index (scan_cache_v9.tsv) loads and saves on all cores; a failed save no longer replaces a good cache with a cut one.
  • Search index, filtering and the Model Viewer list are built on all cores; sorting skips the merge buffer while keeping the exact same order.
  • Verified Test Suite: 98 passed; 0 failed (cargo test --release).

Raw benchmark output

PercyStar 1.4.8 bench, best of 3, D:\Grand Theft Auto VI Build
cache: load index                      1670.8 ms
  (79 archives, digest 8d7d0203cea74231)
cache: save index                      4226.8 ms
cache: fill entry list                  555.9 ms
search: build index                     686.5 ms
  (index digest e76551da894bc900)
search: query 'adder'                    54.5 ms
  (241 hits)
search: query 'tex_ bc7 -mip'            61.4 ms
  (24892 hits)
search: query 'zzzz_no_match'            57.6 ms
  (0 hits)
  (1324566 entries)
scan: script.rpf                         34.5 ms
  (1013 entries, digest 39e2de13d136ebcc)
scan: common.rpf                         82.2 ms
  (275 entries, digest d134b8bf5f3842d7)
scan: textures.rpf                      248.0 ms
  (4047 entries, digest 90c5e1929442220d)
scan: shaders.rpf                      1347.4 ms
  (1 entries, digest 14af23f9317e0ab6)
scan: data.rpf                         4516.5 ms
  (40348 entries, digest 8dbea80359262777)
scan: packs.rpf                       40365.7 ms
  (58220 entries, digest 9325ccd7081a2d0e)
scan: ttdb_graphics.ttpf                  0.2 ms
decode: 60 TTPF textures                  9.8 ms
  (pixel digest d74dbf08781c3103)
decode: 40 TXD dictionaries           15427.6 ms
  (pixel digest b9ff1b3afdc7518e)
decode: 25 packs.rpf models               6.2 ms
  (25 decoded, (625, 800))
PercyStar 1.5.0 bench, best of 3, D:\Grand Theft Auto VI Build
cache: load index                       640.3 ms
  (79 archives, digest 8d7d0203cea74231)
cache: save index                       509.1 ms
  (save then load gives the same index: true)
cache: fill entry list                  450.3 ms
search: build index                      62.1 ms
  (index digest e76551da894bc900)
search: query 'adder'                    12.4 ms
  (241 hits)
search: query 'tex_ bc7 -mip'            11.9 ms
  (24892 hits)
search: query 'zzzz_no_match'             9.6 ms
  (0 hits)
  (1324566 entries)
scan: script.rpf                         19.8 ms
  (1013 entries, digest 39e2de13d136ebcc)
scan: common.rpf                         49.6 ms
  (275 entries, digest d134b8bf5f3842d7)
scan: textures.rpf                      234.5 ms
  (4047 entries, digest 90c5e1929442220d)
scan: shaders.rpf                       944.5 ms
  (1 entries, digest 14af23f9317e0ab6)
scan: data.rpf                         1887.2 ms
  (40348 entries, digest 8dbea80359262777)
scan: packs.rpf                       33297.3 ms
  (58220 entries, digest 9325ccd7081a2d0e)
scan: ttdb_graphics.ttpf                  0.3 ms
decode: 60 TTPF textures                  5.1 ms
  (pixel digest d74dbf08781c3103)
decode: 40 TXD dictionaries            5980.3 ms
  (pixel digest b9ff1b3afdc7518e)
decode: 25 packs.rpf models              10.7 ms
  (25 decoded, (625, 800))

Existing installs update in place: the in-app updater picks up PercyStar_v1.5.0_Win64.zip (all versions since v1.0.3 use this layout).