Metadata-Version: 2.4
Name: a2-legacy-launcher
Version: 1.0.21
Summary: A script to run Orion Drift offline
Author-email: Obelous <1@obelous.dev>
License-Expression: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: colorama

<!-- @import "[TOC]" {cmd="toc" depthFrom=1 depthTo=6 orderedList=false} -->
# Orion Drift Legacy Launcher

A small script to make Orion Drift APKs run offline.

Particularly useful when running old versions of Orion Drift that don't have servers anymore.

## Dependencies
- Python 3

## Get started

<details>
   <summary>Windows instructions:</summary>

   <br>
   
**Install:**

1. Install pipx

   `pip install --user pipx`

2. Add pipx to PATH

   `py -m pipx ensurepath`

3. Reopen command prompt

4. Install legacy launcher

   `pipx install a2-legacy-launcher`

5. Run the script

   `a2ll`

6. If you are prompted to install java follow the instructions and restart your command prompt after.

7. Provide an APK and OBB to install

    All old versions can be found here: https://dl.obelous.dev/public/A2-archive/
</details>

<details>
   <summary>Debian instructions:</summary>
   
   <br>
   
   **Install:**

1. Insall pipx

   `sudo apt install pipx`

2. Add pipx to PATH

   `pipx ensurepath`

3. Install java

   `sudo apt install openjdk-21-jdk`

4. Install legacy launcher

   `pipx install a2-legacy-launcher`

5. Run the script

   `a2ll`

6. Provide an APK and OBB to install

    All old versions can be found here: https://dl.obelous.dev/public/A2-archive/

</details>

To update run:

`pipx upgrade a2-legacy-launcher`

## Usage

```
a2ll [no parameters: interactive mode]
a2ll [-shortcut, --argument] [value]

Arguments:
-a, --apk, Location of APK to use
-o, --obb, Location of OBB to use
-i, --ini, Location of INI to use
-r, --remove, Uninstall thoroughly if installing in headset doesn't work
-p, --open, Wakes headset and opens game automatically once finished
-s, --strip, Stripts permissions to skip permission prompts on first launch
-l, --logs, Pull A2 logs for debugging
-c="", --commandline="", Specify commandline options to pass to A2
-so, --so, Inject a custom .so file into the APK
-b, --usecache, Skip decompilation and use previously decompiled files to save time
```

## How does it work?
Rebuilding the APK with debugging enabled gives permission to access the game files without root. <br>
From there we can place an Engine.ini which overrides the games file letting us load straight into the map without connecting to any servers.
