Leaderboard holograms¶

A board is a floating panel in the world that ranks your voters. It is a single text display entity, so there is no hologram plugin to install and no armour stands to clean up after.

Placing one¶

Stand where you want it, look at the spot, and run:

/voting board add top

It appears at head height in front of you and move mode opens immediately.

Move mode¶

Your hotbar is replaced by seven tools, and put back exactly as it was when you leave. Left-click and right-click do opposite things.

Tool	Left-click	Right-click
Red block	Move left	Move right
Lime block	Move down	Move up
Blue block	Move toward you	Move away
Comparator	Cycle the step size: 0.1, 0.25, 0.5, 1 block
Spyglass	Smaller	Bigger
Ladder	Fewer rows	More rows
Paper	Cycle what the board shows
Emerald	Done

Left, right, closer and further are relative to where you are looking, not to the world's compass, so the board goes the way it looks like it should go. The action bar shows the position, size, row count and step as you nudge.

Every nudge saves. Closing the game mid-edit loses nothing.

To edit one later, stand near it:

/voting board move

What a board can show¶

Type	Shows
`top`	Most votes of all time
`month`	Most votes this month
`streaks`	Longest current daily streaks
`points`	Biggest vote point balances
`party`	A progress bar for the vote party

Cycle between them with the paper tool without leaving move mode, so you can see each one in place before you decide.

The rest¶

/voting board list          every board, its type and where it stands
/voting board remove        the one you are standing near
/voting board remove <name> a particular one

Name a board when you place it to give it a custom title:

/voting board add top Hall-of-Fame

Dashes become spaces on the board, so that one reads HALL OF FAME.

Settings¶

boards:
  rows: 10             # rows a new board starts with
  refresh-seconds: 60  # how often the numbers update
  view-blocks: 100     # how far away it is still drawn

Boards are stored in boards.yml and respawned on start. The displays themselves are not saved into the world, so a world rollback or a chunk copy can never leave a duplicate behind, and any stray one is swept at startup.

On a network with MySQL, every server's boards read the same numbers, so a board in the lobby and a board on survival always agree.