> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nameplatebuilder.frotty27.com/llms.txt
> Use this file to discover all available pages before exploring further.

# UI Overview

> Navigate the NameplateBuilder player interface.

<Info>This documentation is written for **NameplateBuilder >= v4.260326.7** with **API >= v2.2.0**.</Info>

Open the editor with `/npb` (aliases: `/nameplatebuilder`, `/nameplateui`). The UI features a sidebar on the left with three sections. The current version number is displayed in the title bar. Scrollable areas use gold-tinted scrollbars.

## Sidebar Layout

| Section        | Tab           | Description                                                                        |
| :------------- | :------------ | :--------------------------------------------------------------------------------- |
| **GENERAL**    | Settings      | Master enable/disable, NPC look-at toggle, vertical offset, welcome message toggle |
| **NAMEPLATES** | NPCs          | Segment chain editor for NPC nameplates                                            |
|                | Players       | Segment chain editor for player nameplates                                         |
|                | Disabled      | Read-only view of all admin-disabled segments                                      |
| **ADMIN**      | NPCs          | Admin NPC chain order editor (Chain / Settings sub-tabs)                           |
|                | Players       | Admin Player chain order editor (Chain / Settings sub-tabs)                        |
|                | Configuration | Required, Disabled, Settings, and Blacklist sub-tabs                               |

The **ADMIN** section is only visible to players with the `nameplatebuilder.admin` permission.

## How Nameplates Work

Each player has their own **segment chain** - an ordered list of segments that get composited into the nameplate string. The chain determines what appears above entities and in what order.

For example, if a player's NPC chain is `[Health Bar, Guild Tag, Elite Tier]` with `-` separators, entities would show:

```
42/67 - [Warriors] - [Elite]
```

Every installed mod can contribute segments. Players pick the ones they want, order them however they like, and choose display formats per segment.

## Built-in Segments

NameplateBuilder ships with four built-in segments, shown with a warm-purple tint in the UI:

| Segment         | Variants                     | Target  |
| :-------------- | :--------------------------- | :------ |
| **Player Name** | Name, Anonymized             | Players |
| **Health**      | Current/Max, Percentage, Bar | All     |
| **Stamina**     | Current/Max, Percentage, Bar | All     |
| **Mana**        | Current/Max, Percentage, Bar | All     |

## Empty State

When no segments are enabled, entities display an empty nameplate (no text).