GAMMA Launcher

Starting G.A.M.M.A. .NET Launcher is not possible on GNU/Linux because of .NET / powershell scripts

This is a reimplementation of G.AM.M.A. launcher used for the first setup. You will need to follow DravenusRex's guide or the newer Red007Master's guide to have a working game.

Table of contents

• Installation
  • Using pip
  • Using easy-install
  • Using release
  • Using AUR
• Commands
• Troubleshoot
• Contributing

Installation

Using pip (from source)

It's strongly advised to install this in a venv (Python Virtual Environment)

A quick guide on how to do this is to open your terminal/command prompt and navigating to the downloaded folder containing gamma-launcher, and typing python3 -m venv env on Linux, or py -m venv env on Windows.

You will then have to enter the virtual environment by typing source env/bin/activate on Linux, or .\env\Scripts\activate on Windows.

To confirm that you're in the right place, type which python on Linux, or where python on Windows. It should print out either .../env/bin/python or ...\env\Scripts\python.exe, respectively.

You may first have to upgrade pip for the installation to work. (If it's complaining about a 'bad interpreter', for example.) If this is the case, type pip install --upgrade pip.

If currently in your gamma-launcher folder, you can simply type pip install . OR pip install directory. Replace 'directory' with the actual path of said directory. The specificed directory must contain the gamma-launcher setup.py file.

If all went well, you can now use the gamma-launcher command as intended.

(Type deactivate to leave the virtual environment. Use the previous source command to re-enter it.)

Using easy-install

Make sure you have a toolchain available to compile 7z and libunrar.so and python3-venv installed then:

$ cd easy-install
$ make -j$(nproc)
$ sudo make install

Using release

By downloading gamma-launcher from the latest release, you can use it without any installation. Everything is self contained in an executable. Release built with Ubuntu.

Use the --cache-directory option to re-use previously downloaded files.

Using AUR (Arch Linux)

This installation method is not supported on this repo, contact AUR maintainers for any issue with this installation method.

On Arch Linux and Arch-based operating systems, you can download package from AUR:

yay -S gamma-launcher

Use at your own risk!

Or you can build it by yourself:

git clone https://aur.archlinux.org/gamma-launcher.git cd gamma-launcher makepkg -sri

Commands

Anomaly Install

Create an usable Anomaly installation is target directory

To setup Anomaly: gamma-launcher anomaly-install --anomaly <Anomaly path>

Check Anomaly

Verify Anomaly installation with: gamma-launcher check-anomaly --anomaly <Anomaly path>

Check MD5

This will perform a MD5 check for all ModDB addons

To run it: gamma-launcher check-md5 --gamma <GAMMA path>

Full Install / Update

This will install/update all mods based on Stalker_GAMMA

To setup/update your GAMMA folder: gamma-launcher full-install --anomaly <Anomaly path> --gamma <GAMMA path>

Afterwards, you will need to start Mod Organizer and set Anomaly Path (launcher can't do that ... yet.)

Remove ReShade

This will do remove ReShade based on this guide

To use it: gamma-launcher remove-reshade --anomaly <Anomaly path>

Purge Shader Cache

This will delete cached shaders

To use it: gamma-launcher purge-shader-cache --anomaly <Anomaly path>

USVFS Workaround

This will create a usable GAMMA installation without ModOrganizer.

DO NOT USE IT if wine is compatible with ModOrganizer, this will remove all mods flexibility.

To use it: gamma-launcher usvfs-workaround --anomaly <Anomaly path> --gamma <GAMMA path> --final <Final Install path>

Test Mod Maker

This command will verify if additonal installation directives are valid (aka folder is in the archive)

To use it: gamma-launcher test-mod-maker --gamma <GAMMA path>

Troubleshoot

Glibc Errors

Install gamma launcher in a venv. See the Using pip (from source) section above.

ModuleNotFoundError: No module named 'distutils'

The distutils module is required to install Python packages but it was removed in Python 3.12. You can still use it by installing setuptools (inside the venv):

(venv) $ pip install setuptools

LookupError: Couldn't find path to unrar library.

You are missing a library that extracts RAR files. You can use something like libunrar on Linux. To install it run the following command:

• On Debian (non-free APT repository required): sudo apt install libunrar5
• On Ubuntu: sudo apt install libunrar5t64
• On Fedora (RPM Fusion required): sudo dnf install libunrar. Note that before the installation you will need to enable the non-free RPM Fusion repository since the default package provided by Fedora will cause problems. Instructions on how to enable it here.
• On Arch/Manjaro: sudo pacman -S libunrar

Shader compilation error

Remove ReShade with: gamma-launcher remove-reshade --anomaly <Anomaly path>

Also remove some shaders mods:

• 188- Enhanced Shaders - KennShade
• 189- Beef's NVG - theRealBeef
• 190- Screen Space Shaders - Ascii1457
• 290- Atmospherics Shaders Weathers and Reshade - Hippobot

Documentation

A documentation of launcher API can be generated with pdoc3

pip install pdoc3
pdoc3 --html -o doc/ launcher

Once executed, a doc/ folder containing a HTML documentation will be created.

Contributing

See CONTRIBUTING.md