> For the complete documentation index, see [llms.txt](https://alexdev-s-organization.gitbook.io/unlimitednametags/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alexdev-s-organization.gitbook.io/unlimitednametags/features/billboards.md).

# Billboard

The billboard mode defines how display group entities rotate to face the viewer's camera. You can configure a global default facing mode for all name tags, and optionally override it on a per-row basis.

***

## Billboard Modes

| Mode             | Camera Alignment Behavior                                                                                                                |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **`CENTER`**     | Standard billboard behavior. The display faces the camera on all axes, balancing pitch and yaw (closest to Minecraft vanilla rendering). |
| **`HORIZONTAL`** | Align yaw (horizontal rotation) with the camera, while locking the pitch (vertical tilt).                                                |
| **`VERTICAL`**   | Align pitch (vertical tilt) with the camera, locking the yaw.                                                                            |
| **`FIXED`**      | Fixed orientation relative to the player model. The display does not rotate to track the viewer's camera.                                |

> \[!NOTE] The **`FIXED`** billboard mode is highly recommended for `ITEM` or `BLOCK` display groups (such as custom wings, backpacks, or status blocks) that must remain static relative to the player's physical posture.

***

## Configuration Examples

### CENTER (Default Global Setting)

```yaml
defaultBillboard: CENTER
```

![CENTER](https://1998043917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXFajS60IVNJP9RE0gA9h%2Fuploads%2Fgit-blob-f04d2d1489a0489fbe5731cdba9bd3ebe85b8614%2Fbillboard-center.gif?alt=media)

***

### HORIZONTAL

```yaml
defaultBillboard: HORIZONTAL
```

![HORIZONTAL](https://1998043917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXFajS60IVNJP9RE0gA9h%2Fuploads%2Fgit-blob-fceadcb3fa53795c6ae5f71fbfe2e584f5864b17%2Fbillboard-horizontal.gif?alt=media)

***

### VERTICAL

```yaml
defaultBillboard: VERTICAL
```

![VERTICAL](https://1998043917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXFajS60IVNJP9RE0gA9h%2Fuploads%2Fgit-blob-7c08537a7f76189aa5868ca9cc89054690043012%2Fbillboard-vertical.gif?alt=media)

***

### FIXED

```yaml
defaultBillboard: FIXED
```

![FIXED](https://1998043917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXFajS60IVNJP9RE0gA9h%2Fuploads%2Fgit-blob-6f9e8e7839ce2570389d1e65a663680f11efe00a%2Fbillboard-fixed.gif?alt=media)

***

## Scope & Overrides

* **Global Settings**: Defined by the `defaultBillboard` key in `settings.yml` (e.g., `defaultBillboard: CENTER`).
* **Display Group Overrides**: Can be configured on a per-row basis using the `billboard` key inside a specific `displayGroup` (e.g., `billboard: FIXED`).
* **Command Modifier**: Run the in-game command `/unt billboard <CENTER|HORIZONTAL|VERTICAL|FIXED>` to update and persist the default global billboard setting in `settings.yml` (requires the permission node `unt.billboard`).

***

## See Also

* [Configuration Guide (`settings.yml`)](/unlimitednametags/configuration.md)
* [Display Groups Guide](/unlimitednametags/features/display-groups.md)