Potato Launcher

Appearance

Launcher configuration ​

Currently, the only supported deployment method is GitHub Actions, as it's the easiest way to build for all OSes.

Start by forking the https://github.com/Petr1Furious/potato_launcher repository.

Then, you have two options to configure your launcher: config file or environment variables.

Config file ​

Pros and cons

  • Pro: Everything needed to build the launcher is inside the repo, so you (or your users) can clone the repo and build the launcher right away
  • Con: May be harder to update when the upstream updates

To use this option, edit the build.env file at the root of the repository. Each line corresponds to a variable. Everything before = is the name, everything after is a value. Comments are not supported, but empty lines are ignored.

Environment variables ​

Pros and cons

  • Pro: Doesn't require changing files in the repository, so it's easier to update your repo when the upstream updates
  • Con: Nix package won't work out of the box

To use this option, go to the "Settings" tab, then choose "Secrets and variables" on the left and select "Actions". Then, add your config variables in the "Variables" tab. Make sure to not accidentally create them as secrets instead.

Variables list ​

  • LAUNCHER_NAME (required): Your launcher name, for example "Potato Launcher". Can only contain Latin letters, numbers, spaces, -, _ and '

  • VERSION_MANIFEST_URL (required): URL of a version manifest. You'll probably want to set it to https://<your-domain>/data/version_manifest.json. The vanilla URL is https://piston-meta.mojang.com/mc/game/version_manifest_v2.json

  • LAUNCHER_APP_ID (required): An application ID in a reverse domain notation. Used in macOS and Flatpak packages. For example, me.petr1furious.PotatoLauncher

  • LAUNCHER_ICON (required): A path to the launcher icon, relative to the repository root. For example, packaging/potato_launcher.png

    If you are using the environment variables option, this can also be a URL.

  • BACKEND_API_BASE (optional): An URL that will be used to download launcher updates. Doesn't impact instance download. Set it to https://<your-domain>/api/v1 if you want the launcher to update automatically (you want to). Also used to generate the .flatpakref file

  • LAUNCHER_DESCRIPTION (optional): The application description. Used in .desktop files in the Nix and Flatpak packages, can safely be omitted.

  • LAUNCHER_KEYWORDS (optional): The semicolon-separated list of additional keywords for the .desktop file. Can safely be omitted

Setting up secrets ​

If you want GitHub Actions to upload built launcher artifacts to your backend automatically, set these secrets.

Go to the "Settings" tab, then choose "Secrets and variables" on the left and select "Actions". Then, add the secrets in the "Secrets" tab.

You need to set the following secrets:

  • ADMIN_SECRET_TOKEN: Must match the ADMIN_SECRET_TOKEN used by your deployed backend (see Server setup)

Triggering the build ​

All done! Make sure to enable actions in your fork by going to the "Actions" tab and clicking "I understand my workflows".

Then, you can trigger the build:

  • By pushing to the master branch (uploads happen automatically on master when the upload secrets are set)
  • Or manually via "Run workflow" (you can enable uploads in the workflow inputs)

After a successful workflow run, the launcher binaries and packages should be available at https://your.domain/launcher