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
    format:
      prefix: '{tag_prefix}{tag_name_color}'
      suffix: '{tag_suffix}'
    placeholder-types:
    - SERVER
    - PLAYER
    custom-suffix:
      enabled: true
      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
    format:
      prefix: '{tag_prefix}{tag_name_color}' # prefix prepended to players' names
      suffix: '{tag_suffix}' # suffix appended to players' 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
    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 red hearts after the players' names in the tablist.

Setup

yaml

    # ...tablists' settings...
    custom-suffix: 
      enabled: true # whether to enable or disable this module
      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 complete yet lightweight plugin which handles just too many features!
© 2024 Remigio07

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

Tablists ​

Setup ​

Adding tablists ​

Custom suffix ​

Setup ​

Render types ​

Tablists

Setup

Adding tablists

Custom suffix

Setup

Render types