TidyTab

A clean, rank-sorted tab list — with LuckPerms support built in.

TidyTab gives your tab list a header/footer, rank prefixes, and proper sorting (staff at the top, default players at the bottom). It works with or without LuckPerms.

Features

• Header & footer — shows online count, max players, and live color-coded TPS; refreshes automatically
• Rank prefixes — [Owner], [Admin], [VIP]… shown in the tab list only (your chat plugin stays in charge of chat)
• Rank sorting — higher ranks appear at the top of the tab list
• LuckPerms aware — if LuckPerms is installed, TidyTab uses your real LuckPerms prefixes and group weights automatically. If not, it uses the ranks from config.yml. Either way it just works.

Install

1. Drop tidytab-x.y.z.jar into your plugins/ folder.
2. Restart the server.
3. (Optional) Edit plugins/TidyTab/config.yml, then run /tidytab reload.

Requires Paper 1.21.x (or a fork) and Java 21. LuckPerms is optional.

Config (the short version)

refresh-interval-seconds: 5   # how often the header/footer updates

sort-players: true            # set false if ANOTHER plugin manages
                              # scoreboard teams (nametag/tab plugins)

header:                       # placeholders: {online} {max} {tps}
  - "&6&lMy Server"
  - "&7Players online: &f{online}&7/&f{max}"
footer:
  - "&7TPS: {tps}"

ranks:                        # match your LuckPerms group names
  - group: admin
    weight: 90                # higher weight = higher in the tab list
    prefix: "&4[Admin] "
    color: "&4"
  - group: default
    weight: 0
    prefix: ""
    color: "&7"

Colors use & codes (&a green, &c red, &6 gold, &l bold, …).

Command & permission

Command	What it does	Permission	Default
/tidytab reload	Reloads config.yml	tidytab.reload	OP

Plays nice with other plugins

• Chat is never touched — only the tab list name is changed.
• Sorting uses scoreboard teams. TidyTab only creates/removes its own teams, and if a player already belongs to another plugin's team, TidyTab backs off instead of stealing them. If another plugin fully manages teams (nametag plugins etc.), set sort-players: false.
• On shutdown, TidyTab cleans up after itself: tab names, header/footer, and all its teams are restored to vanilla.

The only network activity is a one-time update check on startup (Modrinth public API, notify-only) and anonymous bStats usage stats.

How the sorting works (for the curious)

Minecraft sorts the tab list alphabetically by scoreboard team name. TidyTab names its teams NNN_group where NNN = 999 - weight — so weight 90 becomes 909_admin, which alphabetically sorts before 999_default. Higher weight → smaller number → higher in the list. The client does the sorting; the plugin just assigns teams.

Building from source

./gradlew :tidytab:build

Output: tidytab/build/libs/tidytab-<version>.jar