# 👥 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.
