Configuration

A global config.yml for scanning, client mode and UI, plus one file per board under boards/.

Client mode

client:
  mode: auto            # auto | always-chest | always-dialog
  min-protocol: 771      # 1.21.6. Old-client detection needs ViaVersion
  bedrock-chest: true   # Bedrock players always get the chest GUI

Scanning

scan:
  refresh-seconds: 300    # rebuild interval
  batch-size: 100        # players processed per tick
  max-players: 5000      # 0 = no cap
  max-days: 0            # only players seen in last N days (0 = all)
  include-zero: false
  on-start: true

◆

Rebuilds are async and batched — batch-size players per tick — so even a full 5000-player scan never freezes the main thread.

Rank colours & sounds

rank-colours:
  1: "&e"      # gold for #1
  2: "&f"
  3: "&6"
  default: "&f"

sounds:
  enabled: true
  click: "ui.button.click"
  denied: "block.note_block.bass"

A board file

Each board is one file under boards/. Copy the bundled board-template.yml, rename it (the name becomes the id), edit, and run /lb reload:

# money.yml  ->  /lb money
enabled: true
title: "&fTop Money"
full-title: "&fTop Money (Top %size%)"

source: vault
ascending: false
value-multiplier: 1.0

top-size: 10
full-size: 100

value-format: compact
entry-format: "&8#%rank% %head%&f%player% &8- &a$%value%"
entry-tooltip: "&7Balance: &a$%value%"
empty-text: "&7Nobody has any money yet."

icon:
  slot: 10
  material: EMERALD

Placeholders in entries

Board text supports %rank%, %player%, %value%, %head%, %size%, %page% and %pages%. An optional entry-command runs as the clicking player, and a permission can gate a board.