starview

A command-line tool for patching the CN version of a pinball game.

starview can additionally download the game's assets while the servers are still live.

You can download the most recent version on the releases page.

Usage

Use the --help flag when running any command to see detailed usage information.

Patching an APK

# Patch the APK to send requests to http://localhost:3000
# and bypass ID verification.
starview patch --replace "api_scheme=http,api_host=localhost:3000" <path_to_original_apk> patched.apk

Downloading Assets

# Download the game's assets ~10GB
starview fetch assets <out_path>

# Download the game's asset path file
starview fetch path <out_path>

# Download the game's asset entity lists
starview fetch list <out_path>

Creating Patches

The patches that are applied using starview are git diffs.

If you have git installed, you can generate one with the following command:

git diff -p -U0 <original_file> <modified_file> > <package path>.patch

At the top of the newly generated patch, you will see something like:

--- a/<original_file_name>.as
+++ b/<modified_file_name>.as

Replace a and b with the fully qualified package path of the file you are generating a patch for.

--- path/to/file/<original_file_name>.as
+++ path/to/file/<original_file_name>.as

Both lines should be the same aside from the --- and +++

See the patches directory for examples of how patches should be formatted.

Building

Dependencies

• Install Rust for your platform and ensure that it's up-to-date.

  rustup update
  

• Install FFDec for your platform.
• Install Android SDK Build-Tools for your platform.

To build for debugging:

cargo run

To build for release:

cargo run --release

Once built, place FFDec and the Android SDK Build-Tools in the same location as the starview binary in folders named ffdec and build-tools. For reference, you can view the windows release on the releases page

Acknowledgements

• jindrapetrik for creating FFDec, which makes patching the APK's scripts possible.