# XLabs

[![patreon](https://img.shields.io/badge/patreon-support-blue.svg?logo=patreon)](https://www.patreon.com/xlabsproject)
[![discord](https://img.shields.io/endpoint?url=https://momo5502.com/iw4x/members-badge.php)](https://discord.gg/sKeVmR3)
[![website](https://img.shields.io/badge/Repackers-_Website-blue)](https://rimmyscorner.com/)

<p align="center">
  <img src="assets/github/banner-iw4x.png?raw=true" />
</p>

<br/>

<p align="center">
  <img src="assets/github/banner-s1x.png?raw=true" />
</p>

<br/>

<p align="center">
  <img alig src="assets/github/banner-iw6x.png?raw=true"/>
</p>

## Prerequisites: Installing Git

If you don't have `git` installed on your machine, follow these steps:

1. Visit the [Git download page](https://git-scm.com/downloads).
2. Download the appropriate version for your operating system.
3. Run the installer.
   - During the installation, you will be asked if you want to add Git to your system's PATH environment variable. Ensure you choose the option to do so. This allows you to use Git from the command line without specifying its full path.
4. After installation, open a terminal or command prompt and type `git --version` to ensure Git is correctly installed.

## Download
Clone the Git repo. Do NOT download it as ZIP, that won't work.

   - Open a terminal or command prompt.
   - Run the following command:
     ```
     git clone https://github.com/Ahrimdon/xlabs.git
     ```

## Repository Contents
  - All XLabs Clients
  - All XLabs Dedicated Server Configuration Files
  - Complete XLabs Launcher
  - All Original Game Binaries
  - xlabs.dev Website
  - Client Documentation (e.g. Changelogs, README's, etc.)

## Installation

### Clients

1. Move the the folder contents of the desired client into your game folder.
2. Launch the executable.
   > **Note**: The executable and any accompanying folders should be in the base game directory.

### Launcher

1. Move the `xlabs` folder from `localappdata/xlabs` to your LocalAppData directory.
    > **Note**: On Windows, press `Win + R`, type `%localappdata%`, click ok.
2. Extract `IW4XLauncher.exe` and run it.
3. Select the proper game path for your game(s) of choice and launch.

## Disclaimer

This software has been created purely for the purposes of
academic research. It is not intended to be used to attack
other systems. Project maintainers are not responsible or
liable for misuse of the software. Use responsibly.