> 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/resource-pack.md).

# Resource pack

Use the bundled resource pack or generate your own.

The plugin draws the box background with a custom font (`hud:bg`) and hides its own bossbar with transparent sprites. Both are part of a resource pack. You have two options:

| Option                       | Use it if                                                                     |
| ---------------------------- | ----------------------------------------------------------------------------- |
| **A. Bundled resource pack** | You want to get started quickly with the default look.                        |
| **B. Generate your own**     | You want your own colors, a different bossbar color or a different box shape. |

{% hint style="warning" %}
Every bossbar with the transparent color becomes invisible. Choose a color that no other plugin on your server uses, and set the same color in `bossbar.color` of the [config](/docs/bossbarhud/admin-guide/configuration.md).
{% endhint %}

## Option A: bundled resource pack

The resource pack is attached to every release as a download.

1. Download the resource pack from the files of the release.
2. Add it to your server:
   * If you already use a resource pack (for example the one that Nexo generates), copy the `assets` folder of the bundled pack into it and republish your pack.
   * Otherwise you can use the bundled pack as your server resource pack.
3. Keep `bossbar.color` on `PURPLE` (the default). The bundled pack makes the purple bossbar transparent.

## Option B: generate your own

Generate the assets with the included script. It requires Python 3 and Pillow.

```bash
pip install pillow
python generate_hud_pack.py --out ./pack --fill 2b3a55 --alpha 170 --border 4a5f8a
```

| Option            | Description                            | Default  |
| ----------------- | -------------------------------------- | -------- |
| `--out`           | output folder                          | `./pack` |
| `--fill`          | fill color (hex)                       | `2b3a55` |
| `--alpha`         | fill opacity, 1-255                    | `170`    |
| `--border`        | optional 1px border color (hex)        | none     |
| `--border-alpha`  | border opacity, 1-255                  | `255`    |
| `--bossbar-color` | bossbar color that is made transparent | `purple` |

Copy the generated `assets` folder into your resource pack (for example the pack that Nexo generates for you) and republish the pack. If you change `--bossbar-color`, set the same color in `bossbar.color` of the config.