KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #ai-agent #claude-code #mcp #typescript #codex #cli #rust #deepseek-harness

gamma-launcher

★ 199 Open GitHub ↗

Just another Launcher to setup S.T.A.L.K.E.R.: G.A.M.M.A.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://github.com/DravenusRex/stalker-gamma-linux-guide) or
the newer [Red007Master's guide](https://github.com/Red007Master/Red-s-Guide-on-Installing-G.A.M.M.A.-on-Linux)
to have a working game.

## Table of contents

* [Installation](#installation)
  * [Using pip](#using-pip-from-source)
  * [Using easy-install](#using-easy-install)
  * [Using release](#using-release)
* [Commands](#commands)
* [Troubleshoot](#troubleshoot)
* [Documentation](#documentation)
* [Contributing](CONTRIBUTING.md)

## Installation

### Using pip (from source)

It's strongly advised to install this in a [venv](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/#creating-a-virtual-environment) (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:

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

### Using release

By downloading gamma-launcher from the [latest release](https://github.com/Mord3rca/gamma-launcher/releases/latest), 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.

## 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](https://github.com/Grokitach/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](https://reshade.me/forum/general-discussion/4398-howto-uninstall-reshade)

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)](#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):

```sh
(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](https://rpmfusion.org/Configuration).
- 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`

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

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

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md)

gamma-launcher

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README