KruASe76 / tablist-tweaks

Small improvements for Minecraft Tab player list

tablist-tweaks

Modrinth · CurseForge · SpigotMC

A Spigot (Bukkit) Minecraft that improves the player list (shown on Tab button press)

Default	Dimension Dots

Features (can be disabled through configuration)

• The color of the player's name is associated with the dimension in which they are located:
  • Green for Overworld
  • Red for Nether
  • Purple for The End
• The "idle" badge is placed after the player's name if they haven't moved for some time
• Placeholders

Compatibility

PlaceholderAPI placeholders

(they can be used in other plugins such as TAB)

Placeholder	Description
%tablisttweaks_dimension_color%	corresponding color code from config (obviously can be used to color anything)
%tablisttweaks_dimension_dot%	Dimension Dot with corresponding color (even if the "dimension-dots" feature is disabled)
%tablisttweaks_idle_badge%	empty or the "idle" badge with color from config (always empty if the feature is disabled)
%tablisttweaks_idle_flag%	either true or false (always false if the feature is disabled)

Usage

Commands

/tablisttweaks is the main plugin command, which has the alias /tt.

Command	Description
/tt help [command]	Show help for given command, for available commands otherwise
/tt reload	Reload config

Configuration

• The time player has to stand still to get the "idle" badge (in seconds)
• Enable/disable features
  • Dimension colors
    • Dimension Dot format (see images)
  • "Idle" badge
• Colors
  • dimensions
  • "idle" badge
• Plugin messages
  • error
  • help
  • warning

Permissions

Permission node	Default	Description
tablisttweaks.help	true	Allows to use /tt help (lists only available commands)
tablisttweaks.reload	op	Allows to use /tt reload
tablisttweaks.admin	op	Refers to tablisttweaks.reload by default

Supported versions

Plugin works properly on 1.16 and above. May work on older versions, probably without problems down to 1.13.
Requires Java 1.8 or higher.

Reference

• MineShield server's tab as inspiration

Special thanks to:

• Legitimoose for amazing Paper (Bukkit) plugin (in Kotlin) project setup tutorial
• BeBr0 for Spigot (Bukkit) plugin development tutorial [RU] with very clear API explanation

Copyright

The project itself is distributed under GNU GPLv3.