# Player Heads

## 🧭 Overview

Player heads can display custom textures or mimic specific players. These are applied to items using the `head` field in the `item-builder`.

***

## 🛠 Format

| Type               | Format             | Description                                                  |
| ------------------ | ------------------ | ------------------------------------------------------------ |
| **Player Name**    | `player->[NAME]`   | Uses the skin of a Minecraft player (e.g., `player->Notch`). |
| **UUID**           | `uuid->[UUID]`     | Uses a player head based on UUID (e.g., `uuid->e156...`).    |
| **Custom Texture** | `custom->[BASE64]` | Uses a custom head texture value.                            |

***

## 💡 Examples

### 🔹 Player Head

```yaml
meta-builder:
  head: "player->Notch"
```

### 🔹 UUID Head

```yaml
meta-builder:
  head: "uuid->fab1534e-4a48-472e-b1db-89e1f557d3ce"
```

### 🔹 Custom Texture Head

```yaml
meta-builder:
  head: "custom->eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMWVj..."
```

{% hint style="warning" %}
**Note:** Custom texture strings can be very long. Always copy the full Base64 value provided by your head generator (like minecraft-heads.com).
{% endhint %}
