# Overview

> Fancy stacked name tags on Paper: **plain text**, **items**, and **blocks** above the head; works with PlaceholderAPI; optional movement and colour effects.

This wiki goes with [**UnlimitedNameTags**](https://github.com/alexdev03/UnlimitedNameTags) on GitHub.

[![Discord](https://img.shields.io/discord/1263414013040263249?label=Discord\&logo=discord\&color=5865F2)](https://discord.gg/W4Fu8fqCKs) [![Release](https://img.shields.io/github/v/release/alexdev03/UnlimitedNametags?color=blue)](https://github.com/alexdev03/UnlimitedNameTags/releases/latest)

|                         |                                                                                                           |
| ----------------------- | --------------------------------------------------------------------------------------------------------- |
| **Server**              | Paper **1.20.1+** (Spigot 1.20.2+ works; Paper is recommended)                                            |
| **Required add-on**     | [PacketEvents](https://modrinth.com/plugin/packetevents) — install it like any other plugin               |
| **Main settings**       | `plugins/UnlimitedNameTags/settings.yml` (created when the plugin first runs)                             |
| **Optional extra file** | `advanced.yml` — only if you need to nudge nametag height for certain helmets (not created automatically) |

![Name tags preview](/files/5Pv07HqSQH5Be2mZvtoJ)

***

## Where to Start

| Page                                                                 | What you’ll find                                          |
| -------------------------------------------------------------------- | --------------------------------------------------------- |
| [Getting Started](/unlimitednametags/getting-started.md)             | Installation, first run, minimal working config           |
| [Configuration](/unlimitednametags/configuration.md)                 | Main settings file explained step by step                 |
| [Display Groups](/unlimitednametags/features/display-groups.md)      | Stacking multiple rows, conditions, text vs item vs block |
| [Performance](/unlimitednametags/performance.md)                     | If the server feels heavy — what to turn down or slow     |
| [FAQ](/unlimitednametags/faq.md)                                     | Common “why doesn’t this work?” answers                   |
| [Commands & Permissions](/unlimitednametags/commands-permissions.md) | `/unt` and who can use what                               |
| [Migration Guide](/unlimitednametags/migration.md)                   | Upgrading from an older config version                    |
| [Developer API](/unlimitednametags/api.md)                           | Java API for integrating your plugin with UNT             |
| [Integrations](/unlimitednametags/integrations.md)                   | Other plugins (Nexo, Geyser, PlaceholderAPI, …)           |

### Feature Guides

* [Animations](/unlimitednametags/features/animations.md) — moving or colour-cycling text and tags
* [Billboard](/unlimitednametags/features/billboards.md) — how the tag turns toward the camera
* [Placeholder Replacements](/unlimitednametags/features/placeholders-replacements.md) — turn raw placeholder text into nicer labels
* [Show While Looking](/unlimitednametags/features/show-while-looking.md) — only show the tag when someone looks at the player
* [Advanced (`advanced.yml`)](/unlimitednametags/features/advanced-yml.md) — fine-tune helmet height by hand
* [Performance](/unlimitednametags/performance.md) — optional tuning when many players are online

***

## Supported versions

**Server:** Paper 1.20.1+; Spigot 1.20.2+ (Paper is still preferred).

**Java players:** custom tags need **Minecraft Java 1.19.4 or newer**. Older game versions simply cannot show this kind of nametag — that is a game limit, not something you fix in config alone. **ViaVersion does not** make ancient clients magically support these tags.

**Bedrock (Geyser):** works partially; colours, backgrounds, and multi-line may not look the same as on Java.

***

## Support

[Discord](https://discord.gg/W4Fu8fqCKs) — for help after purchase, open a ticket with a verified license where required.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alexdev-s-organization.gitbook.io/unlimitednametags/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.