Velocitab

Velocitab 1.7.1 fixes bugs and changes the default formatter to MiniMessage.

• The default text formatter is now MINIMESSAGE instead of MINEDOWN. (#208)
• Added a config option to force-send TAB list packets that may improve compatibility with certain fabric mods.
• Fixed a few logic bugs related to conditional placeholders.
• Fixed an issue with the regex match used to find certain placeholders (#209)

To update, drag+drop.

Velocitab 1.7 adds the ability to customize server links, adds conditional placeholders, fixes bugs, and more.

• Added the ability to customize server links (#201)
• Added relational and conditional MiniPlaceholders support, courtesy of @alexdev03 (#197)
  • Check the conditional and relational placeholder docs for details on how to use these
  • Also added new time formatting placeholders for each unit of time
• Fixed the wrong permission node check being used for /velocitab
• Fixed the 300ms delay before TAB would update after joining a server

To update, just drag+drop and regenerate your config.yml file.

Velocitab 1.6.6 adds support for Minecraft 1.21

• Added support for Minecraft 1.21
• Now requires Velocity 3.3.0-398 or newer.
• Fixed an issue with duplicate TAB entries that could occur for offline accounts (#190)
• Improved a few of the /velocitab command's messages

To update from the previous release, just drag+drop. From v1.5.x or earlier, you will need to regenerate your config.yml file.

Note: If you are updating from Velocitab 1.5.x, you will need to regenerate your config files as there is a new format in place.

Velocitab 1.6.5 adds support for Minecraft 1.20.5.

• Added support for Minecraft 1.20.5.
• Now requires Velocity 3.3.0-380 or newer.
• Added a new show_all_players_from_all_groups option to config.yml

To update from the previous release, just drag+drop. From v1.5.x or earlier, you will need to regenerate your config.yml file.

Velocitab 1.6.4 fixes bugs, adds the ability to specify group server names by regex, and now allows you to specify whether to list players in the same TAB group on a per-group basis.

• Added the ability to specify server names by regex, useful for dynamically-spun networks (#174)
• The setting for specifying whether a TAB group should list all players on the server, instead of just those on the group has been moved to the group config, letting you change this for each group (#179)
• Fixed an issue causing a NullPointerException error when users quit the proxy server (#170)
• Resolved an error when handling packets for users not handled by Velocitab (#170)
• Fixed a problem with the LuckPerms hook (#170)
• Fixed a bug where the TAB list could fall out of sync in cases where players disconnected in certain ways (#176, #180)

To update, just drag+drop — please note if you modified the setting for specifying whether to restrict the TAB list to only list grouped members, you will need to update your tab_groups config as this option has been moved.

Velocitab 1.6.3 improves startup config validation, improves /velocitab name, adds some new placeholders, and adds a plugin messaging API. Requires Velocity 3.3.0 build 329 or newer.

• The config.yml and tab_groups.yml files will now be validated on startup to check for errors, courtesy of @alexdev03 (#152)
• Added a config option to allow LuckPerms to fallback to backend placeholders over PAPIProxyBridge if LuckPerms on the proxy does not return a role, courtesy of @Boy0000 (#153)
• Minor improvements to /velocitab name, courtesy of @Boy0000 (#154)

• Now allows for special characters in the name argument
• Now provides command feedback on success/fail
• Now allows the custom-name to be reset if no name argument is passed

• Added GROUP_PLAYERS_ONLINE placeholders, for showing the number of online users in a group, courtesy of @alexdev03 (#157)
• You can now pass an environment variable to skip the Velocity version/build compatibility check, courtesy of @alexdev03 (#162)
• API: Added an API for interfacing with the plugin over Plugin Messages. Check the docs!

To update, just drag+drop.

Note: Velocitab v1.6 changed the configuration structure. If you're updating from v1.5 or lower, you'll need to copy over your existing TAB formats to the new one. Check the v1.6 release notes for more info.

Velocitab 1.6.2 fixes bugs from the previous version. Requires Velocity 3.3.0 build 329 or newer.

• The plugin will now stop loading if an attempt is made to load it on a server running an incompatible Velocity proxy version/build.
• Fixed the /velocitab name command not having a permission node.
• Fixed servers not present in any tab groups having their header and footer needlessly cleared.
• Fixed an exception that could be thrown when the plugin attempted to parse placeholders formed in certain ways (#146)
• Fixed disconnected players haunting the TAB list if they lost connection unexpectedly, such as when moving between servers (#149)

To update from 1.6.x, just drag+drop. If you're updating from v1.5.x, please check the v1.6 release notes.

Note: Velocitab v1.6 changed the configuration structure. If you're updating from v1.5 or lower, you'll need to copy over your existing TAB formats to the new one. Check the previous release notes for more info.

Velocitab 1.6.1 fixes compatibility issues with newer builds of Velocity, and makes a few bug fixes with packet handling.

• Fixed compatibility with the latest Velocity 3.3.0-SNAPSHOT builds.
• Fixed users sometimes getting kicked with DecoderException: failed to decode: Not a map: null null due to malformed packet update handling (#144)
• Bumped a few dependencies

To update from 1.6, just drag+drop. If you're updating from v1.5, please check the v1.6 release notes.

Note: This release reworks how your TAB groups are laid out in your config. As such, you'll need to copy over your existing TAB formats to the new one. Sorry about that - but it'll be worth it in the long-term!

Velocitab 1.6 fixes bugs and introduces a new, improved config structure. Thanks to @alexdev03 for their work on this release.

• Improved the plugin config structure
  • Separated TAB group definitions into their own tab_groups.yml file
  • config.yml still contains the bulk of all plugin options, and has had its layout improved as a result
• Added a %username_lower% built-in placeholder (lower case usernames; useful for sorting).
• Added a config option to disable the Spectator Mode effect in the TAB menu
• Reduced the size of the plugin JAR file
• Various internal refactors to improve plugin efficiency, improve how caching is handled, and correct a few logic errors
• Fixed compatibility with newer versions of Velocity 3.3

To update, drag+drop. You will need to regenerate your config.yml file for this release (see the note above).

Velocitab 1.5.2 adds support for Minecraft 1.20.4 on Velocity v3.3.0, among other improvements.

• Added support for sorted TAB for Minecraft 1.20.3/1.20.4 clients (#126)
• Added a %luckperms_meta_(key)% placeholder, courtesy of @alexdev03 (#125)
• Added an option to remove nametags if prefix & suffix are empty, courtesy of @alexdev03 (#108)
• Added a team exists check when vanishing/unvanishing a player, courtesy of @alexdev03 (#110)
• Added PlayerAddedToTabEvent, improved PlayerTabList performance and more, courtesy of @alexdev03 (#114, #117)
• Improved serializer system for packet adapters, courtesy of @alexdev03 (#123)
• Improved nametag organization logic (#122)
• Negative values will now be normalized to 0 when sorting the TAB list.
• Fixed various bugs related to the vanish API feature, courtesy of @alexdev03 (#116)
• Fixed an issue where the plugin would not update correctly when groups changed in LuckPerms (#120)
• Fixed RGB-colored nametags not working correctly when using the legacy text format.
• Fixed the plugin not handling escape characters in usernames.
• Fixed player who were kicked from a server while staying online not having the TAB list update for that player.

To update, just drag+drop. You may want to regenerate your config file to see the new options for nametags.

Note: If you're upgrading from v1.4.x and below, please regenerate your config file for this release as there have been config changes.

Velocitab 1.5.1 adds a new Developer API, makes a few improvements, and fixes bugs present in the previous release.

• Fixed compatibility with intermediary versions (e.g., 1.16.4, 1.19.2, etc.), courtesy of @unilock (#102)
• Improved sorting logic to better handle both high and low role weight values, courtesy of @alexdev03 (#103)
• Integer values parsed via PAPIProxyBridge placeholders now correctly parse as sortable weighted integers cross-server, courtesy of @alexdev03 (#105)
• API: Added a new Developer API, courtesy of @alexdev03 (#106)
  • Supports vanishing (hiding) and un-vanishing users from the TAB list, and providing VanishIntegration managers to do this as well
  • Supports changing the display names of users on the TAB list

To update from v1.5, just drag+drop. If you're updating from v1.4.x, you should regenerate (delete and allow the server to re-create) your config.yml file.

Note: Please regenerate your config file for this release as there have been config changes.

Velocitab 1.5 is a significant release that adds support for Minecraft 1.20.2, makes it possible to customise nametags displayed above players in-game, and improves the flexibility of the list sorting system.

• Added support for Minecraft 1.20.2 (#99)
  • You must be running the absolute latest build of Velocity for this to work, as some critical TAB-related issues have only just been fixed!
• The config option for sorting users by now supports placeholders instead of sorting keys, courtesy of @alexdev03 (#94)
  • Works with both built-in placeholders and PAPIProxyBridge placeholders
  • Will sort alphabetically based on the resolved placeholder
  • Note that integer-returning placeholders may not sort correctly; the built-in role weight placeholder will account for this
• Added a few new built-in placeholders:
  • Added the %server_group_index% placeholder (useful for sorting users by server), courtesy of @StrixG (#88)
  • Added the %role_weight% placeholder. This placeholder returns a comparable stringified version of the user's role weight
• Added support for formatting above-head nametags, courtesy of @alexdev03 (#84)
  • You can now customize the nametag displayed above players heads with additional text and colors.
  • Check the docs for more information!
• Added a new option to config.yml for turning on/off scoreboard packet dispatching; required for both sorting and nametags.
• Added support for dispatching and sorting teams for Minecraft 1.8.x and 1.12.2 clients, courtesy of @alexdev03 (#87)
• Fixed the DisconnectEvent still being handled even if the login state was not SUCCESSFUL_LOGIN, courtesy of @Apehum (#80)
• Fixed Update teams packets not being unregistered when the plugin disabled, courtesy of @alexdev03 (#83)
• Fixed a rare packet encoding error on Minecraft 1.20.1, courtesy of @alexdev03 (#90)

To update, just drag+drop and regenerate your config.yml file for this release as there have been config changes.

Velocitab 1.4.1 makes a few quality-of-life and stability improvements. It is compatible with the latest Minecraft version (1.20.1) as there were no packet mapping changes from 1.19.4.

• Set 200ms as the minimum period between list update executions, courtesy of @ironboundred (#52)
• Added a new placeholder: %role_display_name%, which will display the corresponding user's primary LuckPerms group's configure display name, if there is one (falling back to their group ID if not)
• Added an option to configure the PAPIProxyBridge cache time (default is 30 seconds): papi_cache_time

To update, just drag+drop. If you wish to use the new papi_cache_time config option, you must regenerate your config file.

Velocitab 1.4 removes the dependency on Protocolize to make the plugin much more lightweight to use, adds an update checker, and fixes a number of bugs.

• Implement native packets handling and removed the Protocolize dependency, courtesy of @4drian3d (#44)
• Added an update checker, which runs on startup (can be turned off) and through the /velocitab update command. (#46)
• Add plugin metrics and update checker (#46)
• Fixed NullPointerException in Player Join Listener, courtesy of @4drian3d (#47)

To update, just drag+drop. Thanks to 4drian's excellent work, you can remove Protocolize as Velocitab now uses Velocity's internals directly.

⚠️ You must regenerate your config file for this update!

Velocitab 1.3 adds header and footer animation support, an option to disable player sorting, lets you customise how server names are displayed, and fixes a number of issues related to player sorting.

• Added support for header and footer animations by @ironboundred (#25)
  • The header and footer config sections now accept a string list of "frames" in the config file
  • The config will switch between frames on each update (set with update_rate)
• Added a config option to disable player sorting
  • As a result, Protocolize is no longer a hard dependency and the plugin will work fine without it installed (though it is still recommended for proper TAB sorting support)
• Added a config setting to choose a "display name" for servers, courtesy of @FreeMonoid (#30)
  • This lets you choose how the server names will appear when using the server placeholder
• Added reload and About Commands, courtesy of @ironboundred and @4drian3d (#32, #34)
• Added support for using legacy RGB color codes, couretsy of @FreeMonoid (#37)
• Made it so Velocitab will now reload its config when the proxy reload event is fired, courtesy of @ironboundred (#33)
• Fixed a number of issues and console warnings related to player list sorting
  • Fixed a "failed Dispatch Packet" error in console that could appear when a user left the game, courtesy of @ironboundred (#28, #40, #42)
  • Fixed a console warning that could occur when the TAB needs to update due to a LuckPErms permission recalculation event firing, couretsy of @ironboundred (#43)

To update to this release, you must regenerate your config.yml file. If you're using PAPIProxyBridge, an update for that released today and you should also upgrade, as it fixes an important issue with how it was caching requests.
Enjoy!

Velocitab 1.2.3 fixes compatibility support for Minecraft 1.19.4

• Fixed compatibility with Minecraft 1.19.4 clients

To update, just drag+drop. There are no config changes in this release.

Veloictab 1.2.2 fixes a few critical issues from the previous release.

• Fixed an issue where LuckPerms prefix / role data wasn't properly cached when it was updated
• Fixed an issue where the config would fail to load

Please regenerate your config for this release.

Velocitab 1.2.1 adds the ability to customize how players are sorted in the TAB list, and fixes a few bugs.

• Added initial support for Minecraft 1.19.4 servers (please update Protocolize to the latest version (2.2.6+). It may take a little while before this becomes fully stable)
• Added the ability to customize the order of elements and which elements are used for sorting user names in the list through a list in the config file
  • By default, ROLE_WEIGHT and ROLE_NAME are used
  • You can also now add SERVER_NAME to this list, enabling sorting by the name of server the user is on, if you so wish
• Fixed an issue where the plugin would fail to handle some older / modded clients due to nullable collision rule flag values in the update teams packet and cause an error
• Fixed double-underscore formatting escaping still happening for users with the MiniMessage formatter
• Tweaked the fallback values on lists used when values are not set in the config for a group to correctly display with the MiniMessage formatter

To update, drag+drop. You should regenerate your config file.

Velocitab 1.2 adds support for MiniMessage with extended support for MiniPlaceholders available as an alternative to MineDown and adds support for Minecraft versions 1.16.5 through 1.19.3

• Added support for all major Minecraft versions between 1.16.5 and 1.18.2, in addition to 1.19 versions.
  • Support for Minecraft 1.13.2+ has also been added but not officially supported.
  • Modded clients may have issues with this plugin as it relies on protocol logic and protocolize does not support this.
• Added the ability to use MiniMessage for formatting instead of MineDown, if you prefer that syntax
  • Set the new formatting_type option in config.yml to MINIMESSAGE
• Added support for MiniPlaceholders through a hook, if you're using MiniMessage and wish to display those in your TAB menu
  • This can be disabled with the enable_miniplaceholders_hook option if you wish
• Fixed an issue where the periodic update feature would apply an additional 500ms of latency from its scheduled update period
• Fixed an issue where the period update feature would not update the TAB list header and footer text

To update, just drag+drop. You must regenerate your config file.

Velocitab 1.1 adds PlaceholderAPI formatting support via a bridge library plugin, lets you define formats for different groups of servers, and adds a feature for the list to update periodically (not just on player join/leave).

• Added support for PlaceholderAPI formatting. This means you can now use backend-provided Placeholders on your TAB list.
  • Requires the PAPIProxyBridge library plugin installed on both your Velocity proxy and backend servers.
• Added support for defining formatting on separate server groups, courtesy of @Emibergo02
  • This is also now the way in which you exclude servers from being TAB-formatted
• Added support for periodically updating the TAB list on a schedule, courtesy of @ironboundred
  • Off by default. This is useful if you wish to display time-sensitive placeholders in TAB
• Docs: Added plugin docs, available to read here

To update, drag+drop and regenerate your config.yml file (needed due to the config changes brought about by the server groups feature).