[Animated Tab] - TabList v5.1

Tested Minecraft Versions:

• 1.8
• 1.9
• 1.10
• 1.11
• 1.12
• 1.13
• 1.14
• 1.15

Contributors:

montlikadani

Donation Link:

https://www.paypal.me/montlikadani

Bukkit link: Click

READ THE LAST UPDATE RELEASE NOTES, WHEN YOU USED THIS PLUGIN BEFORE.​

Bug report here! (Click)

Donate

If you don't use this plugin then DO NOT review!

​

Animated tab examples
​

Spoiler: More

​

​

Bukkit

➢ Animated tab (header/footer) & animated groups​

➢ Create your own animation​

➢ Option to randomize the texts
➢ Option to set update interval​

➢ Tab auto updates (in server ticks)
➢ Blacklisted players where the tab does not appear for player.
➢ PlaceholderAPI support (optional)
➢ Option to ignore vanished players in %online-players% placeholder. (Supports EssentialsX and SuperVanish)​

➢ Option to sort the groups in tablist (need test)

➢ Custom variables, to create some variables, to prevent config memory reservation.
➢ API for developers
➢ Option to show the afk status format in player list.
➢ 160+ symbols
➢ Create fake players to player list, with colored names
➢ Tab group prefixes and suffixes
➢ Hide group when player afk or vanish. (Requires EssentialsX)
➢ Hide tab when player vanished. (Requires EssentialsX)
➢ Per player group prefixes & suffixes, to show each players group in tablist.
➢ Change player tab name with one command.
➢ Blacklist tab name, to prevent any bad word usage.
➢ Set the specified player prefix/suffix from command.
➢ Using Essentials nick name in groups & tabname, to make easier.
➢ Ping placeholder format (good, medium, bad)
➢ Per world player list, to show the player list for each worlds.
➢ Per-tablist stuffs:​

➢ Per world-group
➢ Per group (Requires Vault)
➢ Per world
➢ Per player​

➢ Toggle on/off tab, toggles for all available players or just one user.
➢ Tablist object types (health, ping tab & custom value (just right))
➢ Disabled worlds where tab, tabname, health, ping tab and custom value does not appear
➢ Hides player from tab when afk (Requires EssentialsX)
​

Bungee

➢ Animated tab (header/footer)
➢ Animated groups
➢ 160+ symbols
➢ Custom variables, to create some variables, to prevent config memory reservation.
➢ Blacklisted players where the tab does not appear for player.
➢ Tab auto update (in milliseconds)
➢ Toggle on/off tab
➢ Different tablist for each server
➢ Disabled servers where the tab does not appear.
➢ Per player tablist​

WARNING!
If you use the group options in TabList and use a scoreboard plugin on your server, it is recommended that you change the changing-type in the Tablist config.yml from scoreboard to namer.​

​

[ ] = optional arguments
< > = required arguments
( ) = command abbreviations

Bukkit
- /tablist (or /tl) - Main plugin info.
- /tl help - Help commands.
- /tl reload (or rl) - Reload the plugin.
- /tl fakeplayers (or fp) - Fake player command usage.
- /tl fp <add/remove> <name> - Add/remove the fake player.
- /tl fp list - Lists all fake players.
- /tl toggle - Toggle on/off the tab.
- /tl toggle all - Toggle on/off the tab for all online players.
- /tabname <name> - Changes your player tab name.
- /tname <player> <name> - Changes specified player tab name.
- /tl setprefix <player> <prefix> - Sets the specified player prefix.
- /tl setsuffix <player> <suffix> - Sets the specified player suffix.
- /tl setpriority <player> <priority> - Sets the specified player sorting priority.
- /tl removeplayer <player> - Removes the specified player prefix/suffix.
- /tname reset [player] - Reset your or other player tab name.
- /tl get [player] - Get player tab name.

Bungee
- /tablist - Help commands.
- /tablist reload (or rl) - Reload the plugin.
- /tablist toggle - Toggle on/off the tab.​

Spoiler: Permissions

Bukkit
tablist.* - Allow all TabList permission.
tablist.reload - You can use the "/tl reload" command. - default: op
tablist.fakeplayers - You can use the "/tl fp" command. - default: false
tablist.fakeplayers.add - You can use the "/tl fp add" command. - default: false
tablist.fakeplayers.remove - You can use the "/tl fp rem" command. - default: false
tablist.fakeplayers.list - You can use the "/tl fp list" command. - default: false
tablist.onlinestaff - Online staff permission for %staff-online% placeholder to show all online staff.
tablist.help - You can use "/tl help" command. - default: false
tablist.toggle - You can use the "/tl toggle" command. - default: false
tablist.toggle.all - You can use the "/tl toggle all" sub-command. - default: false
tablist.tabname - You can use "/tabname" command. - default: false
tablist.tabname.other - You can use "/tabname [player] " command. - default: false
tablist.reset - You can use "/tabname reset" command. - default: false
tablist.reset.other - You can use "/tabname reset [player]" command. - default: false
tablist.get - You can use "/tl get" command. - default: false
tablist.get.other - You can use "/tl get [player]" command. - default: false
tablist.setprefix - You can use "/tl setprefix <player>" command. - default: false
tablist.setsuffix - You can use "/tl setsuffix <player>" command. - default: false
tablist.setpriority - You can use "/tl setpriority <player>" command. - default: false
tablist.removeplayer - You can use "/tl removeplayer <player>" command. - default: false

Bungee
tablist.help - You can use "/tablist help" command. - default: false
tablist.reload - You can use the "/tablist reload" command. - default: false
tablist.toggle - You can use the "/tablist toggle" command. - default: false

If you don't know what do you doing in the configurations then read this documentation: https://en.wikipedia.org/wiki/YAML​

Bukkit​

Code (Text):

# Hook plugins
hook:
  # Hooks into PlaceholderAPI to use custom placeholders.
  placeholderapi: false

  # Hooking to my RageMode plugin. (https://www.spigotmc.org/resources/69169/)
  # If true, will disable the tablist, groups and the tablist objects, while
  # running a game.
  RageMode: false

# Different playerlist in different world.
per-world-player-list: false

# Fake players that are on the tab.
enable-fake-players: false

# Ignoring vanished players in %online-players% placeholder.
# true - does not count the vanished players to placeholder.
# Requires Essentials or SuperVanish plugin!
ignore-vanished-players-in-online-players: false

# Hides player from tab when afk status.
# Requires Essentials plugin!
hide-player-from-tab-when-afk: false

# Placeholder formatting
placeholder-format:
  # When the player changes the afk status, changes the tablist name format.
  afk-status:
    enable: false

    # Should show the afk format in right or left side?
    # true - displays in right side
    # false - displays in left side
    show-in-right-or-left-side: true

    # Show the player group if the player afk?
    show-player-group: true

    # When the player is afk
    format-yes: "&7 [AFK]&r "
    # When the player is not afk
    format-no: ""

  time:
    # Time zones: https://www.mkyong.com/java/java-display-list-of-timezone-with-gmt/
    # Or google it: "what is my time zone"
    time-zone: "GMT0"

    # Use system default time zone instead of searching for that?
    use-system-zone: false

    # Formats/examples: https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html
    # Used for %server-time% placeholder.
    time-format:
      format: "mm:HH"
    # Used for %date% placeholder.
    date-format:
      format: "dd/MM/yyyy"

  # Ping color format for %ping% placeholder.
  ping:
    enable: true

    # Use color coding "&" for color.
    good-ping:
      color: "&a"
      amount: 200
    medium-ping:
      color: "&6"
      amount: 500
    bad-ping: "&c"

  # TPS color format for %tps% placeholder.
  tps:
    enable: true

    # Use color coding "&" for color.
    good-tps:
      color: "&a"
      amount: 18.0
    medium-tps:
      color: "&6"
      amount: 16.0
    bad-tps: "&c"

# Custom variables that will be replaced in tablist.
# This useful when we are creating a lot of lines with the same name.
# Usage: <nameOfPlaceholder>: "&6Text..."
custom-variables:
  <name>: "&5&o%player%"
  <lines>: "&5&m======================"

# Enables to change prefix & suffix in player tablist.
# WARNING! Overwrites the tabname function.
change-prefix-suffix-in-tablist:
  enable: false

  # Refresh interval in seconds, if using animation then counts in ticks.
  # Set to 0 if you don't want to refresh the groups.
  # If 0 you will required to execute the /tl rl command, to reload the groups.
  refresh-interval: 30

  # Do you want to use animation in groups?
  # This creates a new task scheduler when this enabled.
  # If this true, then you need to change the refresh interval such as 4, because counting in ticks.
  # If this false, then back to seconds interval.
  enable-animation: false

  # Disable groups in the given worlds.
  disabled-worlds:
    # Use the list as white list or not?
    # If true - Using the white list option and all worlds should be given to the list
    # to show in the specified worlds.
    # If false (default) - Using the disabled list option and if a world is given in the list
    # the groups will be disabled in that world.
    use-as-whitelist: false
    list:
    #- myWorld

  # By enabling this, you will be able to specify the correct Vault group name in groups file
  # and if correct, then it will grant the group to player.
  use-vault-group-names: true

  # Hide player group in tablist when the player is vanished?
  # Required Essentials plugin!
  hide-group-when-player-vanished: false

  # Hide player group in tablist when the player is afk?
  # Required Essentials plugin!
  hide-group-when-player-afk: false

  # Use the essentials nickname instead of player original name?
  # true - Using this format: "prefix playerNickName suffix"
  # false - Using this format: "prefix playerOriginalName suffix"
  # This will only works if the "changing-type" is "namer".
  use-essentials-nickname: false

  # Use the player displayname instead of groups?
  # This supports the player "prefix playerName suffix" format like on chat.
  # If the player has no any format on chat then display the player name.
  use-displayname: false

  # Scoreboard changing types (if you experience some problems by changing group).
  # scoreboard - Maximum character is 16 (if use 1.13+ version max. 64) in prefix & suffix.
  # namer - Max. character is unlimited.
  changing-type: scoreboard

# Tablist objective types
# Shows your current health (with life indicator), shows your current ping or a custom placeholder
# that shows number.
tablist-object-type:
  enable: false

  # Types:
  # ping - ping of player
  # health - health of player
  # custom - custom value
  type: ping

  # Objective settings
  object-settings:
    # The ping side next to the player's name indicates the right side.
    ping:
      # Ping update time interval in seconds.
      update-interval: 3

      # Which worlds do not show up in ping (world names)?
      disabled-worlds:
      #- testingWorld

    # The player health (life) the player's name indicates the right side.
    health:
      # Which worlds do not show the players health in tab?
      disabled-worlds:
      - world_the_end

      # Blacklisted players who do not show the health in tab.
      blacklisted-players:
      - exampleplayer
      - players

    # It only accepts number-ending placeholders, such as player levels (doubled numbers "2.1" do NOT work).
    custom:
      custom-value: "%player_level%"

      # Refresh interval in seconds.
      refresh-interval: 3

      # Which worlds do not show the custom value setting (world names)?
      disabled-worlds:
      #- worlds

# Changing player tablist name with unlimited characters.
tabname:
  # Allow to change player tab name.
  enable: false

  # Use the Essentials nickname instead of tab name?
  use-essentials-nickname: false

  # How many letters should be allowed?
  max-name-length: 200

  # When the player left the server, delete the tab name?
  clear-player-tabname-on-quit: false

  # Enables color coding for tab names. ("&")
  # false - disables all placeholders, symbols, and color codes.
  enable-color-code: true

  # Enable the default color. (If the player has not written a color code, this color will be given by default.)
  default-color:
    enable: false
    color: "&6"

  # Which worlds can not be change the tab name?
  disabled-worlds:
  #- myworld

  # Which names can not be used?
  blacklist-names:
  - tabname

#=========================================#
#             Plugin Settings             #
#=========================================#
# Check for updates.
check-update: true

# Log plugin messages into console.
logconsole: true

# Plugin enable/disable messages in console.
plugin-enable: '&6&l[&5&lTab&c&lList&6&l]&7&l >&a The plugin successfully enabled&6 v5.1&a!'
plugin-disable: '&6&l[&5&lTab&c&lList&6&l]&7&l >&c The plugin successfully disabled!'

# DO NOT CHANGE THIS!
config-version: 15

Bungee

Code (Text):

placeholder-format:
  time:
    # Time zones: https://www.mkyong.com/java/java-display-list-of-timezone-with-gmt/
    # Or google it: "what is my time zone"
    time-zone: "GMT0"

    # Use system default time zone instead of searching for that?
    use-system-zone: false

    # Formats/examples: https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html
    # Used for %time% placeholder.
    time-format: "mm:HH"
    # Used for %date% placeholder.
    date-format: "dd/MM/yyyy"

# Custom variables with unlimited variables.
# Use: <something>: "&6Message...'
custom-variables:
  <name>: "&7&o%player-name%"
  <lines>: "&5&m======================"

# Should enable the tablist groups?
tablist-groups:
  enabled: false

  # Group refreshing time in milliseconds.
  # If you want animation just decrease the value.
  refresh-time: 160

# Group list
groups:
  admin:
    name:
    - "&a[&cAdmin&a]&6 %player-name%"
    - "&a"
    - "&a["
    - "&a[&cA"
    - "&a[&cAd"
    - "&a[&cAdm"
    - "&a[&cAdmi"
    - "&a[&cAdmin"
    - "&a[&cAdmin&a"
    - "&a[&cAdmin&a]"
    - "&a[&cAdmin&a]&6 %player-name%"
    - "&a[&cAdmin&a]&6 %player-name%"
    - "&a[&cAdmin&a]&a %player-name%"
    - "&a[&cAdmin&a]&e %player-name%"
    - "&a[&cAdmin&a]&f %player-name%"
    - "&a[&cAdmin&a]&c %player-name%"
    - "&a[&cAdmin&a]&b %player-name%"
    - "&a[&cAdmin&a]&9 %player-name%"
    permission: groups.admin # any permission name are accepted
  default:
    name: "&7 %player-name%"
    permission: tablist.default

# TabList, header & footer
# Current plugin placeholders: https://github.com/montlikadani/TabList/wiki/Placeholders#bungee
# Use symbols: https://github.com/montlikadani/TabList/wiki/Symbols
tablist:
  # Enable tablist header & footer?
  enable: true

  # Disabled servers, where you can not see the tab.
  disabled-servers:
  #- serverName

  # Blacklisted players, where the player not see the tab.
  blacklisted-players:
  #- playerName

  # How often to refresh the tablist (in milliseconds).
  refresh-interval: 180

  header:
  - "&b&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&6&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&4&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&9&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&a&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&e&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&5&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&b&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&6&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&4&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&9&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&a&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&e&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&5&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&b&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&6&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&4&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&9&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&a&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&e&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&5&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"
  - "&b&lTabList\n&6Ping:&r %ping%&7ms\n<lines>"

  footer:
  - "<lines>\n&7Website:&2 example.com"

  # Per player tablist
  per-player:
    playername:
      header:
      - "&2Tab&6List\n&7<93>&3 Welcome&e &l%player-name%&7! <91>\n \n&5&l&m================="
      footer:
      - "&5&l&m================="
      - "&a&l&m================="
      - "&b&l&m================="
      - "&f&l&m================="
      - "&7&l&m================="
      - "&4&l&m================="
      - "&6&l&m================="

    someone:
      header:
      - "&7<93>&3 Welcome&e &l%player-name%&7! <91>\n \n&5&l&m================="
      footer:
      - "<lines>"
  # Per server tablist
  per-server:
    pvp:
      header:
      - "&7<93>&3 Welcome&e &l%player-name%&7! <91>&6 to&4 M&ay&3 Kit&4PvP&9 S&6e&2r&8v&5e&1r&6!"
      footer:
      - "&aGo to the PvP server!"

    lobby:
      per-player:
        exampleplayer:
          header:
          - ""
          footer:
          - "&7Website&7: example.org"

      header:
      - "&7<93>&3 Welcome&e &l%player-name%&7! <91>&6 to&4 M&ay&9 S&6e&2r&8v&5e&1r&6!"
      footer:
      - "&7<28>&a Choose a minigame or server and start playing!&7 <28>"

# Plugin messages
messages:
  reload-config: "&aThe plugin successfully reloaded!"
  no-permission: "&cYou don't have permission for this!"
  toggle:
    enabled: "&aThe tab is successfully turned on!"
    disabled: "&cThe tab is successfully turned off!"
    no-player: "&cThere is no player available on the server."
  chat-messages:
  - "&8&l-----------"
  - "&7/&atablist reload&7 (or rl)&e -&6 Reloads the plugin and config."
  - "&7/&atablist toggle&e -&6 Toggle the tablist."
  - "&8&l-----------"

# DO NOT CHANGE THIS!
config-version: 7

What do these features mean in the configuration?
Here you will find it. (Click)​

How to create a group?
Here you will find it. (Click)​

Dependencies (Bukkit)​

- PlaceholderAPI (optional)​

• Adds ability to use placeholders, which registered in this plugin.

If you do not use PlaceholderAPI, here is the article about what it says: Click

- Vault (optional)​

• Adds ability to use per-group tablist
• Adds ability to use the vault group names in group prefixes/suffixes to ignore permission checking.

- EssentialsX (optional)​

• Ability to change the groups & player tab name to nick name.
• Ability to ignore the vanished players in %online-players% placeholder.

- SuperVanish (optional)

• Ability to ignore the vanished players in %online-players% placeholder.

- RageMode (optional)

• Ability to disable the tablist, groups and objects while a player is playing in a game.

Known bugs:

- Fix for %tps% placeholder not working in CraftBukkit versions. Issue: #15, #35, #321803
- Health tab is a problem that does not completely show the health level from the tab. (Re-connection is required to show.) SPIGOT-3835
- Per-world player list is not work correctly when a new player joins to the server. (Fixed in v4.9)​

​

Questions about plugin

• Is there anyway to show in tablist after my name my client version or other variable?

Spoiler

Everything in PlaceholderAPI

• If I use %online-players% placeholder, and if a player is vanished, then counts that one player?

Spoiler

It does not count because if the Essentials or SuperVanish plugin is installed it will work.

• How can I use the custom tablist objectives option?

Spoiler

It can be found here: https://github.com/montlikadani/TabList/wiki/How-can-I-use-the-custom-tablist-object-type?

• How can I create groups?

Spoiler

https://github.com/montlikadani/TabList/wiki/How-to-create-a-group?

• Why is the permission for the player's rank to display the group prefix/suffix on the tab?

Spoiler

It has to be because there are many plugins that do not support the Vault plugin and have their own Permission system and group. So this is so easy and it is not need to do this with a permission system update with lots of upgrades.

• Why freezes the tablist when a new player joins the server?

Spoiler

You can do the following options:

• In the config.yml file, the update interval for the tablist is set to 0 so the tab not refresh anymore.
• Make sure your server does not have too many unnecessary plugins that are running, or check the server tps, or at least the server timings, which shows what kind of deceleration occurs on the server.
• Try restart your server completely.

Also, this tablist freezing is fixed in the latest versions when new player joins.

• Is it possible for temporary groups? (time)

Spoiler

Yes!! If you use the LuckPerms plugin, you can set a timer with its temporary command and the specified group permission, so that after the time has elapsed, the player will not see the groups on the tablist.

• How can I use the tablist name so that the nickname and prefix/suffix remains?

Spoiler

You have two options:
- Use tabname or use the prefix/suffix group name modifier to use the nickname.
- Use use-essentials-nickname option (found in the config.yml file)

• Is there any way to rename my tablist name without group?

Spoiler

See this instructions: https://github.com/montlikadani/TabList/wiki/How-do-I-rename-my-tablist-name-without-group?

• How can I show the player money to tablist?

Spoiler

Use PlaceholderAPI, add the Vault plugin and find the amount of money here: Vault-Economy

More​

This plugin is written with simple coding because heavy coding doesn't make sense, so it's a little plugin.

Software requirements:​

• Spigot
• Paper
  
• CraftBukkit
• Bungeecord (to use the plugin in bungee server)
• Sponge (IN PROGRESS)

Todos

Spoiler

- Add BungeeCord support. #24 ✔ (Done)
- Add a sorting list to sort the player groups on the tab. ✔ (Done)
- Move tablist options to a new file. ✔ (Done)

Please use always the latest version of this plugin to get additions and fixes!​

API​

​

Videos​

Spoiler: Open!

Thanks @ChestHub the video! (Version v1.4)


Thanks @Zurdo257 the video! (Version v3.9)

PlaceholderAPI usage​

Spoiler

You don't want to use the PlaceholderAPI?
No prob, just see this: https://github.com/montlikadani/TabList/wiki/PlaceholderAPI-usage#without-placeholderapi

You must first enable the cloud_enabled boolean in the PlaceholderAPI configuration to use.
/papi ecloud download Player - Enables %player_name%,%player_displayname% etc. placeholder.
/papi reload - Reloads the plugin and the cloud.
More help: https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders

bStats

PLEASE DO NOT WRITE ERRORS OR SUGGESTIONS IN THE REVIEWS!

Do you want to code your own Minecraft plugins and build unique servers?

Also thanks for @Nety for creating image titles!​