# 👥 Tab

Provides basic tablist & nametags customization features.

## Commands & Permissions

None!

## Features

* ✅ **Animations**. Create custom animation based on milliseconds.
* ✅ **Unlimited Formats**. Create as many tablist formats as you wish.
* ✅ **World List**. Set tablist format based on player's world.
* ✅ **Rank List**. Set tablist format based on player's rank.
* ✅ **Name Format**. Set player name format in tablist based on their rank.
* ✅ **Name Tags**. Set custom nametag format based on player's rank.
* ✅ **Tablist Sorting**. Sort players in tablist by their ranks with a help of the Name Tags feature.
* ✅ **PlaceholderAPI** Support.

## Configuration

### Tablist Format

By default there is one tablist format called `default`. It's available in **all worlds** and for **all ranks**.

If you want to create different formats for different ranks/worlds, make sure to set their `Priority` setting greater than the `default` one has.

If **multiple** tablists are available for a player, the one with the greatest **priority** will be used.

If **no** tablist is available for a player, the one labeled `default` will be used (if present).

Add `*` to the `Groups` list to make format available for any rank.

Add `*` to the `Worlds` list to make format available in any world.

### Player Name Format

Add name format with the name equals to the group name in your permissions plugin.

If **multiple** name formats are available for a player, the one with the greatest **priority** will be used.

If **no** name format is available for a player, the one labeled `default` will be used (if present).

### Name Tags

Add tag format with the name equals to the group name in your permissions plugin.

If **multiple** tag formats are available for a player, the one with the greatest **priority** will be used.

If **no** tag format is available for a player, the one labeled `default` will be used (if present).

### Tablist Sorting

Tablist sorting **depends** on your **Name Tags** setup and their **Priority** setting. Name tags with the highest priority displayed first in the tablist.

For best results your `Player_Names` and `Nametags` section should contain the same rank names with the same `Priority` values.


---

# 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://nightexpress.gitbook.io/sunlight/modules/tab.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.