Tablist
The server’s player list
Section titled “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 tablist.yml, and the placeholder texts in the language file (lang/<locale>.yml); every setting related to it is described below.
Basic settings (tablist.yml)
Section titled “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: {PING-FORMAT}' 3: '&7Points: {POINTS-FORMAT}' 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}'This example opts into -FORMAT for ping and points. Rules in value-formatting in config.yml can be applied with /funnyguilds reload. {G-POINTS-FORMAT} is the total; use {G-AVG-POINTS-FORMAT} for the average.
Header and footer (tablist.yml)
Section titled “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 &b5.0.0 Primrose'# Footer appearance in the player list.footer: '&c&lThe no-value messages (shown when a player has no guild) can be changed in the language files in plugins/FunnyGuilds/lang!'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 2Pagination (tablist.yml)
Section titled “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. Pagination only runs with animated: true; setting it to false keeps the tablist on its main configuration.
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 the language files in plugins/FunnyGuilds/lang!'“No value” messages (lang/<locale>.yml)
Section titled ““No value” messages (lang/<locale>.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)
Section titled “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: 0Filling rows (tablist.yml)
Section titled “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 playersfill-cells: trueTablist activity (tablist.yml)
Section titled “Tablist activity (tablist.yml)”enabled— if set totrue, the tablist will be active; set tofalseif you don’t want it shown.update-interval— how often the tablist should refresh the information it shows.animated— whether the animated (paginated) tablist is enabled.
# Whether the tablist should be enabledenabled: true# How many ticks should pass before the player list is refreshedupdate-interval: 20# Whether the animated player list is enabledanimated: trueVariable color (tablist.yml)
Section titled “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 relationshipsuse-relationship-colors: falsePlayer-list heads (tablist.yml)
Section titled “Player-list heads (tablist.yml)”The heads section sets custom head textures shown next to tablist rows. A texture is assigned to a range of row numbers, and value and signature come from a skin generator such as mineskin.org.
heads: # Whether custom heads in the player list are enabled enabled: true textures: 1-80: value: ewogICJ0aW1lc3RhbXAiIDog... signature: JK7IOCq36OLWWKmqp0NZ... 46-46: value: ewogICJ0aW1lc3RhbXAiIDog... signature: ukTVfQx0saoV8CjINbZU...Basic variables
Section titled “Basic variables”The basic variables are described in Tablist — Variables.
PlaceholderAPI
Section titled “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
Section titled “Tablist numbering scheme”header— headerfooter— footerSlot X— row no. X
