> 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/main-config-main-config.yml.md).

# Main Config (main-config.yml)

### File Location

```
plugins/HeadHunter/main-config.yml
```

***

### Settings

<table><thead><tr><th>Setting</th><th width="119.9296875">Type</th><th width="112.78515625">Default</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:$success;">AllowHeadDropOnEveryLevel</mark></td><td>Boolean</td><td>false</td><td>Controls whether players can collect heads from mobs at any level or only from their current progression level and below</td></tr><tr><td><mark style="color:$success;">AllowSellHeadsOnEveryLevel</mark></td><td>Boolean</td><td>false</td><td>Controls whether players can sell any heads or only heads from their current level and below</td></tr><tr><td><mark style="color:$success;">AllowBuyingSpawnersOnEveryLevel</mark></td><td>Boolean</td><td>false</td><td>Controls whether spawner shop access is level-restricted or open to all players</td></tr><tr><td><mark style="color:$success;">AllowStoringHeadsOnEveryLevel</mark></td><td>Boolean</td><td>false</td><td>Controls whether players can store any mob heads or only heads from their current level and below</td></tr><tr><td><mark style="color:$success;">AllowNaturalMobSpawning</mark></td><td>Boolean</td><td>false</td><td>Determines if mobs should spawn naturally or only via spawner/egg's</td></tr><tr><td><mark style="color:$success;">AllowEnderDragonSpawning</mark></td><td>Boolean</td><td>true</td><td>Controls whether the Ender Dragon can spawn in the world</td></tr><tr><td><mark style="color:$success;">OnlyDropMobHeadsAsLoot</mark></td><td>Boolean</td><td>false</td><td>Determines if mobs drop only heads or their normal loot alongside heads</td></tr><tr><td><mark style="color:$success;">UseCustomXpSystem</mark></td><td>Boolean</td><td>false</td><td>Switches between vanilla Minecraft XP and HeadHunter's custom XP tracking system</td></tr><tr><td><mark style="color:$success;">PreventMobsFromAttackingPlayers</mark></td><td>Boolean</td><td>false</td><td>Controls whether hostile mobs will attack players or remain passive</td></tr></tbody></table>

### Setting Explanations

<details>

<summary>AllowHeadDropOnEveryLevel</summary>

Controls level-based head collection restrictions.

* <mark style="color:$success;">false</mark> = Strict progression - Players must reach each mob's level before collecting <mark style="color:$primary;">(recommended)</mark>
* <mark style="color:$success;">true</mark> = Casual mode - Players can collect any heads from the start

</details>

<details>

<summary>AllowSellHeadsOnEveryLevel</summary>

Controls which heads players can sell.

* <mark style="color:$success;">false</mark> = Players can only sell heads from their current progression level or below <mark style="color:$primary;">(recommended)</mark>
* <mark style="color:$success;">true</mark> = Players can sell any heads, even from higher levels

{% hint style="info" %}
Only heads sold at current progression level counts towards level XP
{% endhint %}

</details>

<details>

<summary>AllowBuyingSpawnersOnEveryLevel</summary>

Controls spawner shop access.

* <mark style="color:$success;">false</mark> = Spawners unlock as players progress through levels <mark style="color:$primary;">(recommended)</mark>
* <mark style="color:$success;">true</mark> = All spawners available immediately

</details>

<details>

<summary>AllowStoringHeadsOnEveryLevel</summary>

Controls head storage restrictions.

* <mark style="color:$success;">false</mark> = Players can only store heads from their current level or below <mark style="color:$primary;">(recommended)</mark>
* <mark style="color:$success;">true</mark> = All heads can be stored regardless of level

</details>

<details>

<summary>AllowNaturalMobSpawning</summary>

Determines which mobs count for head drops.

* <mark style="color:$success;">false</mark> = No mobs spawns, only spawner/egg mobs spawns (forces farming) <mark style="color:$primary;">(recommended)</mark>
* <mark style="color:$success;">true</mark> = Mobs spawnes normally

</details>

<details>

<summary>AllowEnderDragonSpawning</summary>

Controls Ender Dragon spawning.

* <mark style="color:$success;">false</mark> = Disables Ender Dragon entirely <mark style="color:$primary;">(recommended)</mark>
* <mark style="color:$success;">true</mark> = Normal spawning behavior

</details>

<details>

<summary>OnlyDropMobHeadsAsLoot</summary>

Changes mob loot tables.

* <mark style="color:$success;">false</mark> = Normal drops + heads
* <mark style="color:$success;">true</mark> = ONLY heads drop (removes all other loot) <mark style="color:$primary;">(recommended)</mark>

</details>

<details>

<summary>UseCustomXpSystem</summary>

Switches between XP systems.

* <mark style="color:$success;">false</mark> = Vanilla Minecraft XP orbs
* <mark style="color:$success;">true</mark> = HeadHunter's internal XP tracking <mark style="color:$primary;">(recommended)</mark>

</details>

<details>

<summary>PreventMobsFromAttackingPlayers</summary>

Makes mobs passive.

* <mark style="color:$success;">false</mark> = Normal mob AI (hostile mobs attack)
* <mark style="color:$success;">true</mark> = Mobs won't attack (safe farming) <mark style="color:$primary;">(recommended)</mark>

</details>

{% hint style="danger" %}
Changing <mark style="color:$danger;">AllowNaturalMobSpawning</mark> from false to true mid-game can significantly affect balance. Players may suddenly have access to many new heads they couldn't get before.
{% endhint %}

### Default Configuration

```yaml
# ################################# #
# HeadHunter Plugin by DisabledGoat #
# ################################# #

# AllowHeadDropOnEveryLevel Explanation:
# ------------------------
# Determines if mobs drop heads regardless of the player's level.
# If true, all mobs will drop heads when killed, ignoring level restrictions.
# If false, mobs will only drop heads if the player meets the required level.
# 
# AllowSellHeadsOnEveryLevel Explanation:
# ------------------------
# Determines if players can sell heads regardless of the player's level.
# If true, all heads can be sold, ignoring level restrictions.
# If false, heads can only be sold if the player meets the required level.
# 
# AllowBuyingSpawnersOnEveryLevel Explanation:
# ------------------------
# Determines if players can buy spawners regardless of the player's level.
# If true, all spawners can be bought, ignoring level restrictions.
# If false, spawners can only be bought if the player meets the required level.
# 
# AllowStoringHeadsOnEveryLevel Explanation:
# ------------------------
# Determines if players can store heads regardless of the player's level.
# If true, all heads can be stored, ignoring level restrictions.
# If false, heads can only be stored if the player meets the required level.
# 
# AllowNaturalMobSpawning Explanation:
# ------------------------
# Determines if mobs should spawn naturally in the world.
# If true, all mobs can be spawned naturally.
# If false, only mobs from spawners and spawn eggs are allowed to spawn.
# 
# AllowEnderDragonSpawning Explanation:
# ------------------------
# Determines if ender dragons should spawn naturally in the end.
# If true, ender dragons spawn naturally.
# If false, they don't spawn at all.
# 
# AllowWitherSpawning Explanation:
# ------------------------
# Determines if withers are allowed to be created.
# If true, withers can be created.
# If false, withers can not be created.
# 
# OnlyDropMobHeadsAsLoot Explanation:
# ------------------------
# Controls whether mobs drop only heads as loot.
# If true, mobs will exclusively drop heads upon death.
# If false, mobs will drop their regular loot along with heads.
# 
# UseCustomXpSystem Explanation:
# ------------------------
# Controls whether to use the custom HeadHunter XP system.
# If true, the vanilla XP system will be disabled. The level bar will display the HeadHunter level, and anything altering the vanilla level will be unavailable.
# If false, the vanilla XP system will remain active, and the HeadHunter level system will operate in the background.
# 
# PreventMobsFromAttackingPlayers Explanation:
# ------------------------
# Controls whether mobs can attack players.

AllowHeadDropOnEveryLevel: true

AllowSellHeadsOnEveryLevel: false

AllowBuyingSpawnersOnEveryLevel: false

AllowStoringHeadsOnEveryLevel: false

AllowNaturalMobSpawning: false

AllowEnderDragonSpawning: true

AllowWitherSpawning: true

OnlyDropMobHeadsAsLoot: false

UseCustomXpSystem: true

PreventMobsFromAttackingPlayers: false

```

{% hint style="warning" %}
Changes to <mark style="color:$warning;">main-config.yml</mark> require a server restart to take effect. Players currently online won't be affected until they rejoin.
{% endhint %}


---

# 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/main-config-main-config.yml.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.