> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seraph.si/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install Seraph through the official launcher.

Seraph installs through the **Seraph Launcher**. It handles everything: signing you in, picking your client, and injecting or installing the mod for you.

## Download the launcher

<Danger>
  Only download from official links, other downloads may compromise your own security. Our official domains will always end in `seraph.si`.
</Danger>

<Warning>
  Scammers use similar looking domains to compromise your account.
</Warning>

<Steps>
  <Step title="Windows" icon="windows">
    [Download for Windows x64](https://dl.seraph.si/launcher/0.1.0/windows/x64/seraph-launcher.exe)
  </Step>

  <Step title="MacOS" icon="apple">
    Coming soon.
  </Step>

  <Step title="Linux" icon="linux">
    Coming soon.
  </Step>
</Steps>

## First launch

<Steps>
  <Step title="Run the launcher">
    Double-click `seraph-launcher.exe`. The first launch may take a few seconds while it sets itself up.
  </Step>

  <Step title="Sign in with Discord">
    On startup the launcher prompts you to sign in with your Discord account. This creates your Seraph account and writes your auth token to disk so the mod can talk to the Seraph backend.
  </Step>

  <Step title="Pick your client">
    Once you're signed in, you'll see three options:

    * **Download Forge**: installs Minecraft Forge 1.8.9 and drops the Seraph jar into your `mods/` folder.
    * **Inject for Lunar Client**: launches Lunar and injects Seraph into the running process.
    * **Inject for Badlion Client**: launches Badlion and injects Seraph into the running process.

    Pick whichever client you actually play on.
  </Step>

  <Step title="Verify it loaded">
    In any world, run `/seraph help`. If the help menu appears, Seraph is loaded.
  </Step>
</Steps>

## Where files live

The launcher creates a per-user data folder used by every Seraph install on your machine, no matter which client:

| OS      | Path                                                            |
| ------- | --------------------------------------------------------------- |
| Windows | `%AppData%\Seraph\`                                             |
| macOS   | `~/.Seraph/`                                                    |
| Linux   | `$XDG_DATA_HOME/Seraph/` (defaults to `~/.local/share/Seraph/`) |

Inside the folder you'll see:

* `config.json`, your settings.
* `token.json`, Seraph auth token. Don't share this.
* `nicknames.json`, saved nick to real-name mappings (only "permanent" ones).

Because the folder is shared, your settings carry over automatically when you switch between Lunar, Badlion, and Forge.

## Updating

Re-run the launcher. It checks for new versions of the mod and re-installs or re-injects as needed. Your config is preserved across updates.

## Switching clients

Quit Minecraft, run the launcher again, and pick a different option. You can have Seraph running on Lunar one day and Forge the next without losing any settings.