PrismLauncher/nix
Sefa Eyeoglu 41bd008f5d
chore(nix): remove pre-commit tools from shell
use `pre-commit` CLI instead!

Signed-off-by: Sefa Eyeoglu <contact@scrumplex.net>
2023-08-23 13:49:10 +02:00
..
default.nix feat(nix): add darwin support 2023-08-06 15:52:32 -04:00
dev.nix chore(nix): remove pre-commit tools from shell 2023-08-23 13:49:10 +02:00
distribution.nix feat(nix): add darwin support 2023-08-06 15:52:32 -04:00
package.nix fix(nix): add canonicalize-jars-hook 2023-08-23 11:52:32 +02:00
README.md chore: update Nix docs 2023-07-31 19:16:32 +02:00

Prism Launcher Nix Packaging

Installing a stable release (nixpkgs)

Prism Launcher is packaged in nixpkgs since 22.11.

See Package variants for a list of available packages.

Installing a development release (flake)

We use garnix to build and cache our development builds. If you want to avoid rebuilds you may add the garnix cache to your substitutors.

Example (NixOS):

{...}:
{
  nix.settings = {
    trusted-substituters = [
      "https://cache.garnix.io"
    ];

    trusted-public-keys = [
      "cache.garnix.io:CTFPyKSLcx5RMJKfLo5EEPUObbA78b0YQ2DTCJXqr9g="
    ];
  };
}

Using the overlay

After adding github:PrismLauncher/PrismLauncher to your flake inputs, you can add the default overlay to your nixpkgs instance.

Example:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    prismlauncher = {
      url = "github:PrismLauncher/PrismLauncher";
      # Optional: Override the nixpkgs input of prismlauncher to use the same revision as the rest of your flake
      # Note that overriding any input of prismlauncher may break reproducibility
      # inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = {nixpkgs, prismlauncher}: {
    nixosConfigurations.foo = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";

      modules = [
        ({pkgs, ...}: {
          nixpkgs.overlays = [prismlauncher.overlays.default];

          environment.systemPackages = [pkgs.prismlauncher];
        })
      ];
    };
  }
}

Installing the package directly

Alternatively, if you don't want to use an overlay, you can install Prism Launcher directly by installing the prismlauncher package. This way the installed package is fully reproducible.

Example:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    prismlauncher = {
      url = "github:PrismLauncher/PrismLauncher";
      # Optional: Override the nixpkgs input of prismlauncher to use the same revision as the rest of your flake
      # Note that overriding any input of prismlauncher may break reproducibility
      # inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = {nixpkgs, prismlauncher}: {
    nixosConfigurations.foo = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";

      modules = [
        ({pkgs, ...}: {
          environment.systemPackages = [prismlauncher.packages.${pkgs.system}.prismlauncher];
        })
      ];
    };
  }
}

Installing the package ad-hoc (nix shell, nix run, etc.)

You can simply call the default package of this flake.

Example:

nix run github:PrismLauncher/PrismLauncher

nix shell github:PrismLauncher/PrismLauncher

nix profile install github:PrismLauncher/PrismLauncher

Installing a development release (without flakes)

We use garnix to build and cache our development builds. If you want to avoid rebuilds you may add the garnix cache to your substitutors.

Example (NixOS):

{...}:
{
  nix.settings = {
    trusted-substituters = [
      "https://cache.garnix.io"
    ];

    trusted-public-keys = [
      "cache.garnix.io:CTFPyKSLcx5RMJKfLo5EEPUObbA78b0YQ2DTCJXqr9g="
    ];
  };
}

Using the overlay (fetchTarball)

We use flake-compat to allow using this Flake on a system that doesn't use flakes.

Example:

{pkgs, ...}: {
  nixpkgs.overlays = [(import (builtins.fetchTarball "https://github.com/PrismLauncher/PrismLauncher/archive/develop.tar.gz")).overlays.default];

  environment.systemPackages = [pkgs.prismlauncher];
}

Installing the package directly (fetchTarball)

Alternatively, if you don't want to use an overlay, you can install Prism Launcher directly by installing the prismlauncher package. This way the installed package is fully reproducible.

Example:

{pkgs, ...}: {
  environment.systemPackages = [(import (builtins.fetchTarball "https://github.com/PrismLauncher/PrismLauncher/archive/develop.tar.gz")).packages.${pkgs.system}.prismlauncher];
}

Installing the package ad-hoc (nix-env)

You can add this repository as a channel and install its packages that way.

Example:

nix-channel --add https://github.com/PrismLauncher/PrismLauncher/archive/develop.tar.gz prismlauncher

nix-channel --update prismlauncher

nix-env -iA prismlauncher.prismlauncher

Package variants

Both Nixpkgs and this repository offer the following packages:

  • prismlauncher - Preferred build using Qt 6
  • prismlauncher-qt5 - Legacy build using Qt 5 (i.e. for Qt 5 theming support)

Both of these packages also have -unwrapped counterparts, that are not wrapped and can therefore be customized even further than what the wrapper packages offer.

Customizing wrapped packages

The wrapped packages (prismlauncher and prismlauncher-qt5) offer some build parameters to further customize the launcher's environment.

The following parameters can be overridden:

  • msaClientID (default: null, requires full rebuild!) Client ID used for Microsoft Authentication
  • gamemodeSupport (default: true) Turn on/off support for Feral GameMode
  • jdks (default: [ jdk17 jdk8 ]) Java runtimes added to PRISMLAUNCHER_JAVA_PATHS variable
  • additionalLibs (default: [ ]) Additional libraries that will be added to LD_LIBRARY_PATH