Main Configuration

BusyTab keeps every setting in one file: plugins/BusyTab/config.yml. Run /busytab reload after editing it. No restart is needed for anything on this page.

Every option

Option	Default	Description
`refresh-interval`	`5s`	How often the tab list and nametags are rebuilt
`tablist-name-format`	`&8[&e%vault_rank%&8] &f%player_name%%busytab_afk%`	Each player's row in the tab list. See Player Names
`afk-tag`	`&7[AFK]&r`	Text used for `%busytab_afk%` while a player is AFK
`rank-order`	`owner`, `admin`, `moderator`, `vip`, `default`	Sort order, highest first. See Rank Sorting
`header`	Four lines	Lines above the player list. See Header & Footer
`footer`	Five lines	Lines below the player list
`nametag.enabled`	`true`	Show a prefix and suffix above players' heads. See Nametags
`nametag.prefix`	`&8[&e%vault_rank%&8]`	Text before the name above the head
`nametag.suffix`	`%busytab_afk%`	Text after the name above the head
`nametag.name-color`	`white`	Color of the name above the head. One of the 16 named colors

refresh-interval

yaml

refresh-interval: 5s

Accepts seconds (5s) or ticks (100t). A plain number is read as ticks. The minimum is one tick. A value BusyTab can't read logs a warning and uses 5s.

Every refresh rebuilds the header, footer, name and nametag for every online player, and runs every placeholder in them. Lower values look more live but cost more. See the Performance Guide.

The default file

yaml

refresh-interval: 5s

tablist-name-format: '&8[&e%vault_rank%&8] &f%player_name%%busytab_afk%'

afk-tag: ' &7[AFK]&r'

rank-order:
  - owner
  - admin
  - moderator
  - vip
  - default

header:
  - ''
  - 'BusyBee Network'
  - '&7Welcome, &e%player_name%&7!'
  - ''

footer:
  - ''
  - '&7Players online: &a%server_online%&7/&a%server_max_players%'
  - ''
  - '&7Ping: &a%player_ping%ms &8| &7Rank: &e%vault_rank%'
  - '&7TPS: &a%busytab_tps%'

nametag:
  enabled: true
  prefix: '&8[&e%vault_rank%&8] '
  suffix: '%busytab_afk%'
  name-color: white

Missing keys and updates

BusyTab never rewrites your config.yml. A key that is missing uses the default from the table above, with two differences from the shipped file:

A missing tablist-name-format falls back to %player_name%.
A missing afk-tag falls back to nothing.

When an update adds a setting, add the key yourself if you want to change it.

YAML tips

Wrap text in single quotes: '&7Welcome'. An unquoted line that starts with & or % is not valid YAML.
To put a single quote inside single-quoted text, write it twice: 'Steve''s server'.
Leading and trailing spaces only survive inside quotes, which matters for afk-tag, nametag.prefix and nametag.suffix.