Tablist

The server’s player list

The player list — or “tablist” — shows information about the guild, the player, the server and the top lists. Its appearance is configured in the tablist.yml and messages.yml files; every setting related to it is described below.

Basic settings (`tablist.yml`)

In the cells: section you set the appearance of the tablist’s rows. They are numbered from 1 to 80 — the Tablist numbering scheme shows the order.

cells:
  1: '&7Player: &b{PLAYER}'
  2: '&7Ping: &b{PING}'
  3: '&7Points: &b{POINTS}'
  4: '&7Kills: &b{KILLS}'
  5: '&7Deaths: &b{DEATHS}'
  6: '&7KDR: &b{KDR}'
  7: '&7Guild: &b{G-NAME}'
  9: '&7TAG: &b{G-TAG}'
  10: '&7Guild points: &b{G-POINTS-FORMAT}'
  11: '&7Guild position: &b{G-POSITION}'
  12: '&7Online members: &b{G-MEMBERS-ONLINE}'
  21: '&7Online: &b{ONLINE}'
  22: '&7TPS: &b{TPS}'
  41: '&bTop 3 Guilds'
  42: '&71. &b{GTOP-AVG_POINTS-1}'
  43: '&72. &b{GTOP-AVG_POINTS-2}'
  44: '&73. &b{GTOP-AVG_POINTS-3}'
  61: '&bTop 3 Players'
  62: '&71. &b{PTOP-POINTS-1}'
  63: '&72. &b{PTOP-POINTS-2}'
  64: '&73. &b{PTOP-POINTS-3}'

Header and footer (`tablist.yml`)

The tablist’s header and footer are marked on the Tablist numbering scheme (header and footer respectively) — you can change their appearance in the tablist.yml file.

# Header appearance in the player list.
header: '&7FunnyGuilds &b4.9.3 Tribute'
# Footer appearance in the player list.
footer: '&c&lThe no-value messages (shown when a player has no guild) can be changed in messages.yml!'

To add several lines to the header or footer, use the | character, then enter the following lines, each preceded by two spaces:

# Footer appearance in the player list.
footer: |
  line 1
  line 2

Pagination (`tablist.yml`)

Tablist pagination has been available since version 4.10.0. Pages are configured much like the regular tablist — each page only overrides the main one, and wherever a page doesn’t supply its own value, the value from the regular cells/header/footer section is used instead. The number of cycles (cycles) determines how long a given page stays visible (1 cycle = 1 tablist refresh; the refresh rate is set by update-interval in tablist.yml). The number of pages is not limited.

pages:
- cycles: 10
  cells:
    42: ' &b&lTOP &8- &b&lPoints'
    46: ' &b1. &7{PTOP-POINTS-1}'
    47: ' &b2. &7{PTOP-POINTS-2}'
    48: ' &b3. &7{PTOP-POINTS-3}'
- cycles: 10
  cells:
    42: ' &b&lTOP &8- &b&lKills'
    46: ' &b1. &7{PTOP-KILLS-1}'
    47: ' &b2. &7{PTOP-KILLS-2}'
    48: ' &b3. &7{PTOP-KILLS-3}'
  header: '&7GitHub: &agithub.com/funnyguilds'
  footer: '&a&lThe no-value messages (shown when a player has no guild)
   can be changed in messages.yml!'

“No value” messages (`messages.yml`)

This section sets the messages shown in place of missing values — when a player has no guild, a top list entry is empty, a guild has no allies or deputies, and so on.

# <------- No Value Messages -------> #
gNameNoValue: None (G-NAME/NAME)
gTagNoValue: None (G-TAG/TAG)
gOwnerNoValue: None (G-OWNER)
gDeputiesNoValue: None (G-DEPUTIES)
gDeputyNoValue: None (G-DEPUTY)
gValidityNoValue: None (G-VALIDITY)
gRegionSizeNoValue: None (G-REGION-SIZE)
alliesNoValue: None (ALLIES)
enemiesNoValue: None (ENEMIES)
gtopNoValue: None (GTOP-x)
ptopNoValue: None (PTOP-x)
wgRegionNoValue: None (WG-REGION)
minMembersToIncludeNoValue: None (guild-min-members in config.yml)

Row ping (`tablist.yml`)

cells-ping: controls the ping shown next to each tablist row.

# The ping number shown next to each cell.
cells-ping: 0

Filling rows (`tablist.yml`)

fill-cells: — if set to true, all player cells will be filled regardless of the number of online players.

# Whether all possible cells should be filled, regardless of the number of online players
fill-cells: true

Tablist activity (`tablist.yml`)

enabled — if set to true, the tablist will be active; set to false if you don’t want it shown.
update-interval — how often the tablist should refresh the information it shows.

# Whether the tablist should be enabled
enabled: true
# How many ticks should pass before the player list is refreshed
update-interval: 20

Variable color (`tablist.yml`)

use-relationship-colors: — if set to true, the colors of the {PTOP-%} and {GTOP-%} placeholders will depend on guild relationships (neutral, alliance, war). Set to false if you don’t want that coloring.

# Whether {PTOP-%} and {GTOP-%} type variables should be colored based on guild relationships
use-relationship-colors: false

Basic variables

The basic variables are described in Tablist — Variables.

PlaceholderAPI

FunnyGuilds supports additional placeholders from PlaceholderAPI. Once you’ve installed that plugin, you can download further sets of placeholders.

You’ll find the full list of available placeholders and their corresponding commands on the PAPI-placeholders page.

Tablist numbering scheme

header — header
footer — footer
Slot X — row no. X

Tablist

The server’s player list

Basic settings (tablist.yml)

Header and footer (tablist.yml)

Pagination (tablist.yml)

“No value” messages (messages.yml)

Row ping (tablist.yml)

Filling rows (tablist.yml)

Tablist activity (tablist.yml)

Variable color (tablist.yml)