> For the complete documentation index, see [llms.txt](https://xerickerspigot.gitbook.io/arenalegends/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xerickerspigot.gitbook.io/arenalegends/menus/player-heads.md).

# Player Heads

Player heads can be used in menu icons, dummy skins, cosmetic previews, rewards, and collections.

Set one with `head` (or `custom-head`) in `meta-builder`:

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

A non-empty `head` replaces `type`. Potions keep their potion appearance.

## UUID

```yaml
head: "uuid->550e8400-e29b-41d4-a716-446655440000"
```

## Base64 texture

```yaml
head: "custom->eyJ0ZXh0dXJlcyI6..."
```

`custom->` is optional. A value of 100 characters or more is used as a Base64 texture value as-is.

## Texture URL

```yaml
head: "https://textures.minecraft.net/texture/8a29a81f777e847932961125122b6a61b1e294aaa0f24ab7657bc0f8d01986ba"
```

A value starting with `http` is used as the full texture URL.

## Texture hash

```yaml
head: "8a29a81f777e847932961125122b6a61b1e294aaa0f24ab7657bc0f8d01986ba"
```

A shorter value that is not a URL is treated as a hash and expanded to `https://textures.minecraft.net/texture/<value>`.

{% hint style="warning" %}
Player names are not supported. Use `uuid->` when the head must belong to a player. Head values are not processed by PlaceholderAPI.
{% endhint %}