> For the complete documentation index, see [llms.txt](https://wiki.halosdev.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.halosdev.com/halos-player-spoofer/setup-guide/first-install.md).

# First Install

HalosPlayerSpoofer is delivered through **HalosLoader**, our loader plugin. The loader verifies your license, downloads the latest build automatically, and keeps it up to date. You never need to manually download and upload jars for updates.

{% hint style="info" %}
**Running a network?** Install HalosLoader on your proxy (BungeeCord or Velocity) **and** on every backend server you want fakes to join. The steps below are the same on each one, and your license key works on all of them.
{% endhint %}

### Step 1 - Put the Loader in your plugins folder

Drop **HalosLoader.jar** into the `plugins` folder on your Minecraft server. On a network, do this on the proxy and every backend server.

### Step 2 - Start the server once

Start the server so the loader can generate its config file:

```
plugins/HalosLoader/config.yml
```

HalosPlayerSpoofer won't load yet. That's expected, you still need to enable it in the next steps.

### Step 3 - Get your license key

Join our [Discord server](https://discord.gg/halosdev) and open a support ticket to verify your purchase. Make sure you include **proof of purchase**. Our team will send you your **license key**.

One license key covers your whole network. Use the same key on the proxy and every backend server.

### Step 4 - Enable HalosPlayerSpoofer in the loader config

Open `plugins/HalosLoader/config.yml` and find the HalosPlayerSpoofer entry under `plugins`. Set `enabled` to `true` and paste your license key:

```yaml
plugins:
- name: HalosPlayerSpoofer
  enabled: true
  license: XXXX-XXXX-XXXX
  version: STABLE
```

On a network, repeat this on every server running the loader.

{% hint style="info" %}
Leave `version` on `STABLE`. Only switch to `DEV` or `PREV` if our team asks you to.
{% endhint %}

### Step 5 - Restart the server

Restart your server (on a network, restart the proxy and backends). The loader will verify your license and download HalosPlayerSpoofer. Once it loads, a `plugins/HalosPlayerSpoofer` folder will generate with the plugin's config files.

From there, follow the additional pages below for configurations on spigot server and network setup.

### Troubleshooting

**HalosPlayerSpoofer didn't load after restarting?** Check these in order:

1. `enabled` is set to `true` in `plugins/HalosLoader/config.yml`
2. Your license key is pasted correctly (no extra spaces, replaces the `XXXX-XXXX-XXXX` placeholder)
3. Your server has internet access, the loader needs it to verify your license and download the plugin
4. Check the server console for HalosLoader errors on startup

Still stuck? Open a ticket in our [Discord](https://discord.gg/halosdev) and send us your startup log.