> For the complete documentation index, see [llms.txt](https://mending-dev.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mending-dev.gitbook.io/docs/bossbarhud/admin-guide/installation.md).

# Installation

Install BossbarHUD on your server.

## Install the plugin

1. Download `BossbarHUD-<version>.jar` from the Releases page of the GitHub repository.
2. Put the jar into the `plugins/` folder of your server.
3. Install the resource pack, see [Resource pack](/docs/bossbarhud/admin-guide/resource-pack.md).
4. Start the server. The file `plugins/BossbarHUD/config.yml` is created on the first start.

{% hint style="info" %}
Development builds are available as the `BossbarHUD-snapshot` artifact of the "Publish SNAPSHOT" workflow run in the Actions tab of the GitHub repository. They can be unstable, use a release on a production server.
{% endhint %}

## Optional: PlaceholderAPI

The config HUD supports PlaceholderAPI placeholders. Install the expansions you need, for example:

```
/papi ecloud download Player
/papi reload
```

## Optional: Nexo

If Nexo is installed, BossbarHUD loads after it and can look up glyphs by their Nexo name. See [Glyph widths](/docs/bossbarhud/admin-guide/configuration.md#glyph-widths).

## Check the installation

Join the server. With the default configuration you should see a box with your position at the top of the screen. If nothing is visible, see [Troubleshooting](/docs/bossbarhud/admin-guide/configuration.md#troubleshooting).