> For the complete documentation index, see [llms.txt](https://headhunter-1.gitbook.io/headhunter/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://headhunter-1.gitbook.io/headhunter/configurations/configuration-info.md).

# Configuration Info

<table data-view="cards" data-full-width="true"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>⚙️ <strong>Main Config</strong></td><td>Core plugin settings and gameplay rules</td><td><a href="/pages/nk59dA0l207n9tyLQTt6">/pages/nk59dA0l207n9tyLQTt6</a></td></tr><tr><td>💬 <strong>Lang Config</strong></td><td>All messages, GUI text</td><td><a href="/pages/Y1bMRkRjHLc40WExAUM9">/pages/Y1bMRkRjHLc40WExAUM9</a></td></tr><tr><td>📊 <strong>Levels</strong></td><td>Level progression, XP, and costs for each mob</td><td><a href="/pages/I3JZuCufE4nbKWklHbD8">/pages/I3JZuCufE4nbKWklHbD8</a></td></tr><tr><td>🎁 <strong>Level Up Rewards</strong></td><td>Configure rewards when players level up</td><td><a href="/pages/0DKDf097TizpMrL6hPJo">/pages/0DKDf097TizpMrL6hPJo</a></td></tr><tr><td>🔊 <strong>Sounds</strong></td><td>Customize sounds for various plugin actions</td><td><a href="/pages/UxL5maksTYp7MMtVPjn6">/pages/UxL5maksTYp7MMtVPjn6</a></td></tr><tr><td>🎭 <strong>Masks</strong></td><td>Define mask properties, requirements, and enchantments</td><td><a href="/pages/tpshNj81za4LGTa6Y4yW">/pages/tpshNj81za4LGTa6Y4yW</a></td></tr><tr><td>🏆 <strong>Mask Rewards</strong></td><td>Configure rewards for creating masks</td><td><a href="/pages/5vo51KIK4SK1yigOiMsF">/pages/5vo51KIK4SK1yigOiMsF</a></td></tr><tr><td>✨ <strong>Custom Enchantments</strong></td><td>Configure custom enchantments and effects</td><td><a href="/pages/nmVqGoV96bR1LCAepTpm">/pages/nmVqGoV96bR1LCAepTpm</a></td></tr><tr><td>📦 <strong>Head Storage Blocks</strong></td><td>Head storage block locations (auto-managed)</td><td><a href="/pages/Joy98YjiOVElTw2k1NzP">/pages/Joy98YjiOVElTw2k1NzP</a></td></tr><tr><td>🪧 <strong>Sell Heads Signs</strong></td><td>Sell heads sign locations (auto-managed)</td><td><a href="/pages/VhsT76BXwWgTklqsUlZ0">/pages/VhsT76BXwWgTklqsUlZ0</a></td></tr><tr><td>🪧 <strong>Spawner Shop Signs</strong></td><td>Spawner shop sign locations (auto-managed)</td><td><a href="/pages/dTcBFwBVYuaBN7TkdeyU">/pages/dTcBFwBVYuaBN7TkdeyU</a></td></tr></tbody></table>

{% hint style="info" %}
Configuration files are located in <mark style="color:$success;">plugins/HeadHunter/</mark> and are created automatically on first run.
{% endhint %}

***

### Configuration Sections

{% tabs %}
{% tab title="Gameplay Settings" %}
**Files that control how the plugin behaves:**

* Main Config
* Levels
* Level Up Rewards
* Mask Rewards
  {% endtab %}

{% tab title="Customization" %}
**Files for appearance and messages:**

* Lang
* Sounds
* Masks
* Custom Enchantments
  {% endtab %}

{% tab title="Auto-Managed" %}
**Files automatically updated by the plugin:**

* Head Storage Blocks
* Sell Heads Signs
* Spawner Shop Signs
  {% endtab %}
  {% endtabs %}

***

### Quick Tips

<details>

<summary>Always Backup First</summary>

Before making changes, backup your configuration files. If something breaks, you can restore them easily.

</details>

<details>

<summary>Use YAML Validators</summary>

YAML is sensitive to spacing. Use a validator like <mark style="color:blue;"><https://www.yamllint.com/></mark> to check syntax.

</details>

<details>

<summary>Restart, Don't Reload</summary>

Always restart your server after config changes. <mark style="color:$success;">/reload</mark> can cause issues.

</details>

<details>

<summary>Don't Edit Auto-Managed Files</summary>

Files like HeadStorageBlocks, SellHeadsSigns, and SpawnerShopSigns are managed by the plugin. Manual changes may be overwritten.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://headhunter-1.gitbook.io/headhunter/configurations/configuration-info.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.