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`