> 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/core-features/permissions.md).

# Permissions

### Permission Format

HeadHunter uses standard Minecraft permission nodes with the prefix <mark style="color:$success;">headhunter.</mark>

<table><thead><tr><th width="297.26171875">Default Value</th><th>Meaning</th></tr></thead><tbody><tr><td><mark style="color:$success;">true</mark></td><td>All players have this permission by default</td></tr><tr><td><mark style="color:$success;">false</mark></td><td>Permission must be granted explicitly</td></tr></tbody></table>

***

### All Permissions

<table><thead><tr><th>Permission</th><th width="131.8046875">Default</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:$success;">headhunter.sell-heads</mark></td><td>false</td><td>Access to /hh sellheads command</td></tr><tr><td><mark style="color:$success;">headhunter.sell-heads.hand</mark></td><td>true</td><td>Sell heads by holding and right-clicking</td></tr><tr><td><mark style="color:$success;">headhunter.sell-heads.sign</mark></td><td>true</td><td>Create or break sell heads signs</td></tr><tr><td><mark style="color:$success;">headhunter.sell-heads.sign.use</mark></td><td>true</td><td>Use sell heads signs to open GUI</td></tr><tr><td><mark style="color:$success;">headhunter.spawner-sign</mark></td><td>false</td><td>Create or break spawner shop signs</td></tr><tr><td><mark style="color:$success;">headhunter.head-storage-block</mark></td><td>false</td><td>Use /hh headstorageblock to create blocks</td></tr><tr><td><mark style="color:$success;">headhunter.head-storage-block.use</mark></td><td>true</td><td>Use placed head storage blocks</td></tr><tr><td><mark style="color:$success;">headhunter.stats</mark></td><td>false</td><td>Access to /hh stats command</td></tr><tr><td><mark style="color:$success;">headhunter.level</mark></td><td>false</td><td>Access to /hh level command (base viewing)</td></tr><tr><td><mark style="color:$success;">headhunter.level.get</mark></td><td>false</td><td>Use /hh level get</td></tr><tr><td><mark style="color:$success;">headhunter.level.set</mark></td><td>false</td><td>Use /hh level set</td></tr><tr><td><mark style="color:$success;">headhunter.masks</mark></td><td>false</td><td>Base permission for masks commands</td></tr><tr><td><mark style="color:$success;">headhunter.masks.get</mark></td><td>false</td><td>Use /hh masks get</td></tr><tr><td><mark style="color:$success;">headhunter.masks.give</mark></td><td>false</td><td>Use /hh masks give</td></tr><tr><td><mark style="color:$success;">headhunter.heads</mark></td><td>false</td><td>Base permission for heads commands</td></tr><tr><td><mark style="color:$success;">headhunter.heads.get</mark></td><td>false</td><td>Use /hh heads get</td></tr><tr><td><mark style="color:$success;">headhunter.heads.set</mark></td><td>false</td><td>Use /hh heads set</td></tr><tr><td><mark style="color:$success;">headhunter.heads.delete</mark></td><td>false</td><td>Use /hh heads delete</td></tr><tr><td><mark style="color:$success;">headhunter.heads.give</mark></td><td>false</td><td>Use /hh heads give</td></tr><tr><td><mark style="color:$success;">headhunter.stored</mark></td><td>false</td><td>Base permission for stored heads commands</td></tr><tr><td><mark style="color:$success;">headhunter.stored.get</mark></td><td>false</td><td>Use /hh stored get</td></tr><tr><td><mark style="color:$success;">headhunter.stored.set</mark></td><td>false</td><td>Use /hh stored set</td></tr><tr><td><mark style="color:$success;">headhunter.admin</mark></td><td>false</td><td>Access to /hh admin command (opens menu)</td></tr><tr><td><mark style="color:$success;">headhunter.admin.masks</mark></td><td>false</td><td>Access to masks section in admin menu</td></tr><tr><td><mark style="color:$success;">headhunter.admin.rewards</mark></td><td>false</td><td>Access to rewards section in admin menu</td></tr><tr><td><mark style="color:$success;">headhunter.admin.rules</mark></td><td>false</td><td>Access to rules section in admin menu</td></tr><tr><td><mark style="color:$success;">headhunter.admin.player</mark></td><td>false</td><td>Access to player management in admin menu</td></tr><tr><td><mark style="color:$success;">headhunter.admin.custom-enchantments</mark></td><td>false</td><td>Access to enchantments section in admin menu</td></tr><tr><td><mark style="color:$success;">headhunter.admin.levels</mark></td><td>false</td><td>Access to levels section in admin menu</td></tr><tr><td><mark style="color:$success;">headhunter.admin.signs</mark></td><td>false</td><td>Access to signs section in admin menu</td></tr></tbody></table>

***

### Wildcard Permissions

| Wildcard                                                      | Grants                                 |
| ------------------------------------------------------------- | -------------------------------------- |
| <mark style="color:$success;">headhunter.\*</mark>            | All HeadHunter permissions             |
| <mark style="color:$success;">headhunter.admin.\*</mark>      | All admin menu sections                |
| <mark style="color:$success;">headhunter.heads.\*</mark>      | All head management permissions        |
| <mark style="color:$success;">headhunter.stored.\*</mark>     | All stored head management permissions |
| <mark style="color:$success;">headhunter.masks.\*</mark>      | All mask management permissions        |
| <mark style="color:$success;">headhunter.level.\*</mark>      | All level management permissions       |
| <mark style="color:$success;">headhunter.sell-heads.\*</mark> | All selling-related permissions        |

***

### Permissions Hierarchy Visualization

```
headhunter.*
├── headhunter.admin
│   ├── headhunter.admin.masks
│   ├── headhunter.admin.rewards
│   ├── headhunter.admin.rules
│   ├── headhunter.admin.player
│   ├── headhunter.admin.custom-enchantments
│   ├── headhunter.admin.levels
│   └── headhunter.admin.signs
│
├── headhunter.heads
│   ├── headhunter.heads.get
│   ├── headhunter.heads.set
│   ├── headhunter.heads.delete
│   └── headhunter.heads.give
│
├── headhunter.stored
│   ├── headhunter.stored.get
│   ├── headhunter.stored.set
│
├── headhunter.masks
│   ├── headhunter.masks.get
│   └── headhunter.masks.give
│
├── headhunter.level
│   ├── headhunter.level.get
│   └── headhunter.level.set
│
├── headhunter.sell-heads
│   ├── headhunter.sell-heads.hand
│   ├── headhunter.sell-heads.sign
│   └── headhunter.sell-heads.sign.use
│
├── headhunter.head-storage-block
│   └── headhunter.head-storage-block.use
│
├── headhunter.spawner-sign
├── headhunter.stats
└── (levelup has no permission - always available)
```

{% hint style="info" %}
For command usage examples, see the [Commands](/headhunter/core-features/commands.md) page. For configuration options, see the [Configurations](/headhunter/configurations/configuration-info.md) section.
{% 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/core-features/permissions.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.