Skip to main content

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.

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

Only download from official links, other downloads may compromise your own security. Our official domains will always end in seraph.si.
Scammers use similar looking domains to compromise your account.

Windows

Download for Windows x64

MacOS

Download for MacOS

Linux

Download for Linux

​
First launch

1

Run the launcher

Double-click seraph-launcher.exe. The first launch may take a few seconds while it sets itself up.
2

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.
3

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.
4

Verify it loaded

In any world, run /seraph help. If the help menu appears, Seraph is loaded.

​
Where files live

The launcher creates a per-user data folder used by every Seraph install on your machine, no matter which client:
OSPath
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.