a2-legacy-launcher 1.3.5

An integrated version manager for Oculus/Unreal games

UE Legacy Launcher

An integrated version manager/downgrader for Oculus VR games built with Unreal Engine.

Repo Mirror

Dependencies

• Python 3

Get started

Windows instructions:

Install:

1. Install pipx

   py -m pip install --user pipx

2. Add pipx to PATH

   py -m pipx ensurepath

3. Close and re-open command prompt

4. Install legacy launcher

   pipx install a2-legacy-launcher

5. Install complete

   You have installed legacy launcher. Edit the config file at %USERPROFILE%/.a2-legacy-launcher/config.yml to provide a manifest, or manually use the arguments as listed in the usage section below.

Debian instructions:

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. Install complete

   You have installed legacy launcher. Edit the config file at ~/.a2-legacy-launcher/config.yml to provide a manifest, or manually use the arguments as listed in the usage section below.

MacOS instructions:

Currently only Intel Macs are supported, if you own an ARM Mac please DM me

Install:

1. Install homebrew

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install dependencies

   brew install python3 pipx openjdk

3. Add pipx to PATH

   pipx ensurepath

4. Close and re-open terminal

5. Add java to PATH

   sudo ln -sfn /usr/local/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk
   echo 'export PATH="/opt/homebrew/opt/openjdk/bin:$PATH"' >> ~/.zshrc
   echo 'export CPPFLAGS="-I/opt/homebrew/opt/openjdk/include"' >> ~/.zshrc
   source ~/.zshrc
   

6. Install legacy launcher

   pipx install a2-legacy-launcher

7. Install complete

   You have installed legacy launcher. Edit the config file at ~/.a2-legacy-launcher/config.yml to provide a manifest, or manually use the arguments as listed in the usage section below.

Quest instructions

Only follow these steps if you dont have access to a Windows/Linux/Mac computer:

Install:

1. Connect to a computer or android phone

   Run adb tcpip 5555

2. Install termux

   Termux APK

3. Run the helper script in termux

   curl -L https://obelous.dev/uell.sh | bash
   

   I suggest opening this page on the quest browser and copy pasting this command.

   Note that some versions can take up to 5 attempts to launch correctly

Usage

UE Legacy Launcher

positional arguments:
  download              Build version to download and install

options:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -a APK, --apk APK     Path/URL to an APK file
  -o OBB, --obb OBB     Path/URL to an OBB file
  -i INI, --ini INI     Path/URL for Engine.ini
  -m MAP, --map MAP     What map to load in format "Label|Path/To/Map"
  -c COMMANDLINE, --commandline COMMANDLINE
                        Launch arguments for UE
  -so SO, --so SO       Inject a custom .so file
  -rn, --rename         Rename the package for parallel installs
  -p PATCH, --patch PATCH
                        Byte pattern to patch
  -rm, --remove         Uninstall all versions
  -l, --logs            Pull game logs from the headset
  -ls, --list           List available versions
  -op, --open           Launch the game once finished
  -sp, --strip          Strip permissions to skip pompts on first launch
  -sk, --skipdecompile  Reuse previously decompiled files
  -cc, --clearcache     Delete cached downloads
  -r, --restore         Restore to the latest version

Extra context:

• uell [Date/version code/CL/1.0.CL] This automatically downloads a version and uses the correct flags to install it, renaming if possible.

• --clearcache When providing a URL to the APK OBB or INI argument the script downloads and caches the file, to free up storage and delete cached downloads run the script with this argument.

• --skipdecompile When iterating on a single version you may wish to skip the decopilation step to save time by using the previously decompiled files, this also allows for manual modification of game files in the temp/decompiled folder.

• --rename This renames the package to allow for multiple versions to be installed at once.

  If a renamed version is installed the --log argument pulls the logs of the last version to run.

• --commandline Various features can be unlocked through the use of commandline options, for example: -c="-nullrhi"

• --ini is unique because it can be ran on its own without rebuilding or reinstalling to almost instantly swap out an ini file

Config:

The config.yml file located at ~/.a2-legacy-launcher/config.yml has these settings by default:

autoupdate: true
manifest_url: (Manifest URL Here)

Specifying a manifest allows the program to automatically select the arguments to install a desired version. See the example.json for how to format your own manifest.

---