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.




2. Setup

This module requires you to have ProtocolLib installed.


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

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 or MVdWPlaceholderAPI 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