Pokémon Survivor Burst — Android Port

Android Studio wrapper and compatibility layer for running Pokémon Survivor Burst on Android using an mkxp-z/SDL runtime.

Important: This repository is intended to contain the Android wrapper, compatibility code, build configuration, and development documentation only. The bundled game payload (app/src/main/assets/game.zip) is intentionally excluded from GitHub.

Current port version

• Compatibility build: v5.37.8 — Direct Movement Dash
• Android package: com.pokemonsurvivor.burst
• Minimum Android API: 23
• Target Android API: 35
• Compile Android API: 36

Current controller mapping

Control	Action
Left Stick	Move
Right Stick	Aim
R2 / Right Trigger	Dash
L2 / Left Trigger	Shoot
L1	Zoom Out
R1	Zoom In
X	Menu / Save
Y	Ready Menu / Leaderboards
A / B	Existing game/menu behavior
Start / Select	Existing game behavior

The current R2 Dash compatibility layer applies a temporary movement-speed multiplier during the game's existing movement update rather than globally remapping the input system.

Rotom updater

The Android wrapper contains Rotom/Game Launcher update support.

Current behavior is intended to:

• Check the installed game version against the remote version.
• Leave the installation untouched when the versions are equal.
• Display Downloading update... while obtaining a real update.
• Display Installing update... while applying it.
• Preserve the installed game when it is already structurally valid.
• Preserve save data during normal in-place APK upgrades.

Diagnostic output may be written to:

Download/PSB_Diagnostics_Latest.txt

Build requirements

The project currently expects:

• Android Studio
• JDK 17
• Gradle 8.13
• Android Gradle Plugin 8.13.2
• Android SDK / compile SDK 36

The project intentionally does not ship a custom Gradle wrapper. Android Studio can provide the required Gradle installation.

Required local game payload

The game payload is not included in this GitHub repository.

For a local build, place your legally obtained/local development payload at:

app/src/main/assets/game.zip

Do not commit this file to GitHub.

The current development package uses this file as a recovery/first-install payload while preserving a valid game already installed in app-private storage.

Building in Android Studio

1. Clone or download this repository.

2. Open the repository root in Android Studio.

3. Confirm Android Studio is using JDK 17.

4. Install Android SDK API 36 if Android Studio requests it.

5. Place your local game.zip at:

   app/src/main/assets/game.zip
   

6. Allow Gradle sync to complete.

7. Build with:

   Build → Build APK(s)

   or use:

   Build → Generate Signed App Bundle / APK

8. Install the APK over the existing application when preserving app-private save data.

Signing warning

Android only allows an APK to update an already installed app when both APKs use a compatible signing certificate.

The current project deliberately uses the local Android Studio debug certificate for its release build type so builds from the same development machine/profile can remain compatible with earlier development installs.

Do not switch to a new permanent release key and uninstall the existing app until save migration/backup has been implemented and verified.

Save-data warning

Survivor Burst currently stores game data under Android app-private storage.

Uninstalling:

com.pokemonsurvivor.burst

can delete that private data.

If you care about an existing save, do not uninstall the app before installing a compatible update APK.

mkxp-z runtime

The build configuration imports pinned mkxp-z Android runtime components.

The Gradle build verifies the downloaded runtime APK against its expected SHA-256 before extracting runtime files. The runtime APK itself is not installed or executed by the Gradle task.

See app/build.gradle for the exact pinned runtime commit, download URL, and SHA-256.

Repository policy

The .gitignore intentionally excludes:

• app/src/main/assets/game.zip
• APK/AAB outputs
• Gradle and Android Studio build directories
• local SDK configuration
• signing keystores and signing-property files
• diagnostic logs
• multipart release archives and generated ZIP packages

This keeps the repository focused on source and prevents accidental publication of large or sensitive files.

Validation

The source package contains project-specific validation scripts and reports. These are static/source-level checks and are not a substitute for real-device testing.

For controller behavior, the AYN Odin 3 hardware result is treated as authoritative.

Disclaimer

This is an unofficial compatibility/porting project.

Pokémon and related names, characters, trademarks, and game assets belong to their respective rights holders. This project is not affiliated with, endorsed by, or sponsored by Nintendo, The Pokémon Company, GAME FREAK, or the original Pokémon Survivor Burst publisher/developer.

The repository's MIT license applies only to original wrapper/compatibility code authored for this repository. It does not grant rights to third-party game code, assets, trademarks, libraries, or other material.

License

Original Android wrapper and compatibility code authored for this repository is available under the terms in LICENSE, subject to the third-party exclusions stated there.