Tablists

Module info
Configuration	`tablists.yml`
Manager	`TablistManager`
Support	1.8+
Free version	✔
Proxy-configurable	❌

Tablists in Minecraft Vanilla are boring player lists that allow little customization, but ChatPlugin makes the most of their potential and lets you use custom tags and create animated headers and footers. This module prints them in configurable time intervals. They can be used to show useful information and reminders or, more generally, advertisements:

Sub-modules
Custom suffix

Default configuration (tablists.yml in 1.8+)

yaml

tablists:
  settings:
    enabled: true
    random-order: false
    sending-timeout-ms: 250
    player-names:
      teams-mode: true
      update-timeout-ms: 10000
      prefix: '{tag_prefix}{tag_name_color}'
      suffix: '{tag_suffix}'
    placeholder-types:
    - SERVER
    - PLAYER
    custom-suffix:
      enabled: true
      update-timeout-ms: 5000
      displayed-value: '{ping}'
      render-type: INTEGER
      placeholder-types:
      - PLAYER
  tl-0:
    headers:
      english: |-
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &c&lChat&f&lPlugin server
        &eremigio07.me/chatplugin
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &r
      italian: |-
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &f&lServer &c&lChat&f&lPlugin
        &eremigio07.me/chatplugin
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &r
    footers:
      english: |-
        &r
        &7Ping: &r{ping_format} ms
        &7Online: &f{online_total}/{max_players}
        &7Time: &f{date_hour}
        &7RAM: &f{used_memory}/{max_memory} MB
        &7TPS: &r{tps_1_min_format}
        &r
      italian: |-
        &r
        &7Ping: &r{ping_format} ms
        &7Online: &f{online_total}/{max_players}
        &7Orario: &f{date_hour}
        &7RAM: &f{used_memory}/{max_memory} MB
        &7TPS: &r{tps_1_min_format}
        &r
  tl-1:
    headers:
      english: |-
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &c&lChat&f&lPlugin server
        &eremigio07.me/chatplugin
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &r
      italian: |-
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &f&lServer &c&lChat&f&lPlugin
        &eremigio07.me/chatplugin
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &r
    footers:
      english: |-
        &r
        &7Ping: &r{ping_format} ms
        &7Online: &f{online_total}/{max_players}
        &7Time: &f{date_hour}
        &7RAM: &f{used_memory}/{max_memory} MB
        &7TPS: &r{tps_1_min_format}
        &r
      italian: |-
        &r
        &7Ping: &r{ping_format} ms
        &7Online: &f{online_total}/{max_players}
        &7Orario: &f{date_hour}
        &7RAM: &f{used_memory}/{max_memory} MB
        &7TPS: &r{tps_1_min_format}
        &r
  tl-2:
    headers:
      english: |-
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &c&lChat&f&lPlugin server
        &e&oremigio07.me/chatplugin
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &r
      italian: |-
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &f&lServer &c&lChat&f&lPlugin
        &e&oremigio07.me/chatplugin
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &r
    footers:
      english: |-
        &r
        &7Ping: &r{ping_format} ms
        &7Online: &f{online_total}/{max_players}
        &7Time: &f{date_hour}
        &7RAM: &f{used_memory}/{max_memory} MB
        &7TPS: &r{tps_1_min_format}
        &r
      italian: |-
        &r
        &7Ping: &r{ping_format} ms
        &7Online: &f{online_total}/{max_players}
        &7Orario: &f{date_hour}
        &7RAM: &f{used_memory}/{max_memory} MB
        &7TPS: &r{tps_1_min_format}
        &r
  tl-3:
    headers:
      english: |-
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &c&lChat&f&lPlugin server
        &e&oremigio07.me/chatplugin
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &r
      italian: |-
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &f&lServer &c&lChat&f&lPlugin
        &e&oremigio07.me/chatplugin
        &8«&m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &m &8»
        &r
    footers:
      english: |-
        &r
        &7Ping: &r{ping_format} ms
        &7Online: &f{online_total}/{max_players}
        &7Time: &f{date_hour}
        &7RAM: &f{used_memory}/{max_memory} MB
        &7TPS: &r{tps_1_min_format}
        &r
      italian: |-
        &r
        &7Ping: &r{ping_format} ms
        &7Online: &f{online_total}/{max_players}
        &7Orario: &f{date_hour}
        &7RAM: &f{used_memory}/{max_memory} MB
        &7TPS: &r{tps_1_min_format}
        &r

Setup

The following snippet of code represents and explains the tablists' configuration.

yaml

tablists: 
  settings:
    enabled: true # whether to enable or disable this module
    random-order: false # whether to use a random order when sending the tablists
    sending-timeout-ms: 250 # timeout between sendings, in milliseconds
    player-names:
      teams-mode: true # whether to use teams to display player names
      update-timeout-ms: 10000 # timeout between player names' updates, in milliseconds
      prefix: '{tag_prefix}{tag_name_color}' # prefix prepended to player names
      suffix: '{tag_suffix}' # suffix appended to player names
    placeholder-types: # read below
    - SERVER
    - PLAYER
    # ...custom suffix's settings...
  # ...default tablists...

Just like for the other modules, you have to specify which placeholder types you wish to use. Refer to the Modules/Placeholders page for more info.

Adding tablists

To add a new tablist, you just need to specify its ID, its headers and its footers. Note that they support multi line strings. The ID has to respect the following pattern: ^[a-zA-Z0-9-_]{2,36}$.

yaml

  # ...tablists' settings...
  # ...default tablists...
  new-tablist: # ID - required // [!code focus:11]
    headers: # required
      english: |- # main language's translation - required
        &eWelcome to the server, &f{player}&e!
        &aBe respectful and have fun!
      italian: |- # other language's translation - optional
        &eBenvenuti nel server, &f{player}&e!
        &aSiate rispettosi e divertitevi!
    footers: # required
      english: '&aCheck out our &9Discord servery&a!' # main language's translation - required
      italian: '&bDai un''occhiata al nostro &9server Discord&a!' # other language's translation - optional

You can always specify values of '' (an empty string) to reset the header/footer.

Remember to perform /chatplugin reload after applying changes to configuration files.

Custom suffix

Module info
Configuration	`tablists.settings.custom-suffix` in `tablists.yml`
Manager	`CustomSuffixManager`
Support	1.8+
Free version	❌
Proxy-configurable	❌

This module displays either a yellow number or hearts (❤❤❤❤❤❤❤❤❤❤💛💛) after the players' names in the tablist.

Setup

yaml

    # ...tablists' settings...
    custom-suffix: 
      enabled: true # whether to enable or disable this module
      update-timeout-ms: 5000 # timeout between updates, in milliseconds
      displayed-value: '{ping}' # what to display as custom suffix
      render-type: INTEGER # how to display the custom suffix
      placeholder-types: # read above
      - PLAYER
  # ...default tablists...

Note that displayed-value accepts either a fixed value or a placeholder that represents a numeric value.

Render types

The plugin supports 2 render types specifiable at render-type:

HEARTS - displays red hearts after the player's name; supports the {health} placeholder only
INTEGER - displays a yellow integer after the player's name

ChatPlugin — A feature-rich and modular chat ecosystem, lightweight and efficient by design.
© 2025 Remigio07

This wiki is currently updated to version 1.10.4.
Please report any mistakes and misspellings as described at Home/Reporting issues.

Integrations

Chat

Join-quit

⭐ Punishments

Tablists

Tablists

Setup

Adding tablists

Custom suffix

Setup

Render types

Integrations

Tablists

Tablists ​

Setup ​

Adding tablists ​

Custom suffix ​

Setup ​

Render types ​

Tablists

Setup

Adding tablists

Custom suffix

Setup

Render types