# Tablist & Nametags

## 1. Introduction

With the builtin nametags module you can configure how nametags are displayed with a custom prefix and/or suffix.

Additionally you can set a header and footer message in the tablist which may contain placeholders.

 ![](https://s3.eu-west-3.amazonaws.com/guflimc-outline/uploads/0ccbeec6-617c-4986-be81-0c4264a71364/7f87f6a2-7aad-4ce4-be8e-20d9420c6c60/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA36KVU76QO4JLROPB%2F20260922%2Feu-west-3%2Fs3%2Faws4_request&X-Amz-Date=20260922T183000Z&X-Amz-Expires=86400&X-Amz-Signature=ce76b5bbb1b40827a2715a86c7dea8a3919f6cf4a0ab1948f2105f2c304e4aa4&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

  

## 2. Setup


:::warning
This module requires you to have [**ProtocolLib **](https://www.spigotmc.org/resources/protocollib.1997/)installed.

:::


You can configure the nametags in the **config.yml** file.

```yaml
nametags:
    enabled: true
    
    show-header-and-footer: true
    header: '\n&6KingdomCraft\n&7De #1 kingdom plugin!\n'
    footer: '\n&7www.kingdomcraft.be\n'
    
    prefix_format: '{kingdom_nametag_prefix}{rank_nametag_prefix}'
    suffix_format: '{kingdom_nametag_suffix}{rank_nametag_suffix}'
    
    nokingdom:
      prefix: '&7[&eHobo&7]'
      suffix: ''
      order: 99
```


You can use all the builtin kingdomcraft placeholders as well as placeholders from [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) or [MVdWPlaceholderAPI](https://www.spigotmc.org/resources/mvdwplaceholderapi.11182/) for every text option.


### 2.1. Enable or disable

You can disable the nametags module if you are using another plugins that provides this functionality.


### 2.1. Header & Footer

You can show a custom header and/or footer in the tablist. The special code `\n` means a new line. 


### 2.2. Prefix & Suffix

This is the content that shows up as prefix or suffix of every nametag.


## 3. Placeholders

You can configure the values of the used placeholders for each kingdom or rank with the following commands.


### 3.1. Prefix

| /k editor | kingdom.editor |
|-----------|----------------|

| /k edit nametag prefix <prefix> | kingdom.edit.nametag.prefix |
|---------------------------------|-----------------------------|
| /k edit nametag prefix <kingdom> <prefix> | kingdom.edit.nametag.prefix.other |

| /k ranks edit nametag prefix <rank> <prefix> | kingdom.ranks.edit.nametag.prefix |
|----------------------------------------------|-----------------------------------|
| /k ranks edit nametag prefix <kingdom> <rank> <prefix> | kingdom.ranks.edit.nametag.prefix.other |


### 3.2. Suffix

| /k editor | kingdom.editor |
|-----------|----------------|

| /k edit nametag suffix <suffix> | kingdom.edit.nametag.suffix |
|---------------------------------|-----------------------------|
| /k edit nametag suffix <kingdom> <suffix> | kingdom.edit.nametag.suffix.other |

| /k ranks edit nametag suffix <rank> <suffix> | kingdom.ranks.edit.nametag.suffix |
|----------------------------------------------|-----------------------------------|
| /k ranks edit nametag suffix <kingdom> <rank> <suffix> | kingdom.ranks.edit.nametag.suffix.other |


### 3.3. No kingdom

You can set the default prefix and suffix placeholder for players that are not in a kingdom in the **config.yml**. This will replace `{kingdom_nametag_prefix}` and `{kingdom_nametag_suffix}`. A high order means these players will appear at the end of the tablist.


For staff players without a kingdom, you can hide the nokingdom nametag with the permission `kingdom.placeholders.empty-no-kingdom`.


## 4. Tablist ordering

You can change the ordering of kingdoms and ranks. A higher number means further down in the tablist.

| /k editor | kingdom.editor |
|-----------|----------------|

| /k edit nametag order <order> | kingdom.edit.nametag.order |
|-------------------------------|----------------------------|
| /k edit nametag order <kingdom> <order> | kingdom.edit.nametag.order.other |

| /k ranks edit nametag order <rank> <order> | kingdom.ranks.edit.nametag.order |
|--------------------------------------------|----------------------------------|
| /k ranks edit nametag order <kingdom> <rank> <order> | kingdom.ranks.edit.nametag.order.other |

---

**Documents**

- [Getting started](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/getting-started-DMncr30uhG)
- [Sidebar](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/sidebar-wJTtc1tlZN)
- [Tablist & Nametags](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/tablist-nametags-25sz4eqfq9)
- [Kingdom selector](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/kingdom-selector-ebmkGONWFM)
- [Regions](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/regions-rhNS90NSIy)
- [Claims](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/claims-jABwG0Svr8)
- [Power](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/power-70rbbejmW6)
- [Protection](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/protection-rcHugSsHwR)
- [Visitors](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/visitors-aQMHQCji0M)
- [Modifiers](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/modifiers-NIQaQ4ARa6)
- [Resource regions](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/resource-regions-7K2ig0IKqh)
- [Dynmap/Bluemap](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/dynmapbluemap-7cM99zhpRW)
- [Channel mutes](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/channel-mutes-FsmJfHOIYs)
- [Placeholders](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/placeholders-9gQgGoKMAB)
- [Warps](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/warps-h3YmTSSZ1C)
- [Elections](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/elections-IXZCGc3Cuq)
- [Admin mode](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/admin-mode-ALQQSdUm9H)
- [All permissions](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/all-permissions-WdNzOBeqCA)
- [Events - NL](https://wiki.guflimc.com/s/kingdomcraft-premium/doc/events-nl-mOImzefI5b)