bpsr-tool

Rust data extractor for Blue Protocol: Star Resonance.

It can:

• reconstruct localized ZTables from Panda.Table.dll
• dump protobuf descriptors
• extract Lua, UnityFS, and unknown assets from PKG containers

Usage

bpsr-tool extract --pkg <meta.pkg> --output <directory> [--dll <DummyDll>] [--all] [--asset-bundles] [--language english] [--format json-pretty]

Option	Description
--pkg, -p	Path to meta.pkg
--output, -o	Output directory (default: extracted)
--dll, -d	Existing DummyDll directory containing Panda.Table.dll
--all	Extract all package entries in addition to localized ZTables
--asset-bundles	Include UnityFS bundles; requires --all
--language, -l	ZTable language (default: english)
--format	ZTable output format (default: json-pretty)

ZTable output formats

Value	Extension	Structure
json-pretty	.json	Pretty-printed object keyed by table row
json	.json	Compact object keyed by table row
json-array	.json	Compact array of table row objects
ndjson	.ndjson	One table row object per line

Use --all to extract the remaining package entries, and add --asset-bundles to include UnityFS bundles.

DLL generation

When --dll is omitted, the tool finds GameAssembly.dll and global-metadata.dat relative to meta.pkg, then uses the embedded Il2CppInspectorRedux Legacy CLI to generate a temporary Panda.Table.dll.

<game>/GameAssembly.dll
<game>/*_Data/il2cpp_data/Metadata/global-metadata.dat
<game>/*_Data/StreamingAssets/container/meta.pkg

Automatic generation supports:

• Windows x64
• Linux x64 and ARM64
• macOS x64 and ARM64

The bundled CLI requires the .NET 10 Runtime. To skip automatic generation, pass an existing dummy DLL directory with --dll. The game installation is not modified.

To keep the generated DLL, write it to a directory with the il2cpp subcommand:

bpsr-tool il2cpp --pkg <meta.pkg> --output <DummyDll>

License

This is a GPL-3.0 Rust rewrite of PotRooms/StarResonanceTool. Real game files are not included.

The embedded Il2CppInspectorRedux 2026.2 is distributed under the AGPL-3.0 License. See asset/Il2CppInspectorRedux-NOTICE and asset/Il2CppInspectorRedux-LICENSE.