> 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/sell-heads-signs-config-sell-heads-signs.yml.md).

# Sell Heads Signs Config (sell-heads-signs.yml)

### File Location

```
plugins/HeadHunter/sell-seads-signs.yml
```

***

{% hint style="warning" %}
**Auto-Managed File** - This file is automatically updated. Manual changes may be overwritten.
{% endhint %}

### How It Works

{% stepper %}
{% step %}

### Sign Creation

Player with permission creates a sell heads sign
{% endstep %}

{% step %}

### Auto-Save

Plugin saves sign location and placer name
{% endstep %}

{% step %}

### Sign Usage

Players right-click sign to open sell heads GUI
{% endstep %}

{% step %}

### Sign Removal

When sign is broken, entry is removed from config
{% endstep %}
{% endstepper %}

***

### File Structure

```yaml
SellHeadsSigns:
  1: 'world,100,64,200 / Placed by: PlayerName'
  2: 'world,-50,70,150 / Placed by: AdminName'
```

Format: <mark style="color:$success;">world\_name,x,y,z / Placed by: player\_name</mark>

### Why Track Who Placed It?

The plugin tracks who placed each sign for:

* **Moderation** - Identify who created signs
* **Permissions** - Manage sign ownership
* **Auditing** - Track sign placement history

### Manual Management

<details>

<summary>Remove Ghost Signs</summary>

If a sign no longer exists but is still in config, delete the line and restart.

</details>

<details>

<summary>World Migration</summary>

Update world names when moving servers.

</details>

<details>

<summary>Bulk Cleanup</summary>

Remove multiple entries at once if needed (backup first!).

</details>

{% hint style="danger" %}
Making incorrect manual edits can cause signs to stop working or create ghost signs. Always backup before editing!
{% endhint %}
