Leaderboard

Leaderboard

Overview

The Leaderboard is a component that displays a ranked list of players directly in the world using a floating text display (billboard). It refreshes in real-time after each player victory.

Two types of leaderboards are available:

• Area leaderboard — ranks players based on their performance in a specific puzzle area.
• Global leaderboard — ranks players across all puzzle areas on the server.

This page explains how to place and configure the Leaderboard component.

How to Place a Leaderboard

1. Open the Main Shortcut Bar:
   • Type the /lasers command to open the main shortcut bar.
2. Select a Placement Location:
   • Aim at the block where you want to place the leaderboard.
3. Place the Component:
   • Right-click with the "Place component" button in hand and select Leaderboard.

The leaderboard must be placed inside a puzzle area.

How to Edit a Leaderboard

Open the component menu (right-click the leaderboard while in edition mode). The following options are available:

Scope

Choose whether the leaderboard is:

• Area — shows rankings for a single specific puzzle area.
• Global — shows rankings aggregated across all puzzle areas.

Ranking Criteria

The criterion used to rank players. Available criteria depend on the scope:

Criterion	Scope	Description
Best time (area)	Area	Ranks by fastest completion time in a winning run (lowest first).
Fewest actions (area)	Area	Ranks by fewest actions taken in a winning run (lowest first).
Fewest steps (area)	Area	Ranks by fewest steps taken in a winning run (lowest first).
Most bonuses (area)	Area	Ranks by most bonus components collected in a single winning run (highest first).
Most victories (area)	Area	Ranks by total number of victories in this area (highest first).
Most entries (area)	Area	Ranks by total number of runs entered in this area (highest first).
Most time spent (area)	Area	Ranks by total time spent in this area across all runs (highest first).
Most steps (area)	Area	Ranks by total steps taken in this area across all runs (highest first).
Most actions (area)	Area	Ranks by total actions taken in this area across all runs (highest first).
Areas won	Global	Ranks by number of distinct puzzle areas won (highest first).
Total victories	Global	Ranks by total number of victories across all areas (highest first).
Most runs (global)	Global	Ranks by total number of puzzle runs entered globally (highest first).
Most time spent (global)	Global	Ranks by total time spent across all areas (highest first).
Most steps (global)	Global	Ranks by total steps taken globally (highest first).
Most actions (global)	Global	Ranks by total actions taken globally (highest first).
Bonuses obtained	Global	Ranks by total unique bonuses obtained across all areas (highest first).

Global-only criteria cannot be used on area-scoped leaderboards, and vice versa.

Number of Lines

Controls how many player entries are displayed (minimum 3, maximum 10). Use the More lines / Fewer lines buttons in the shortcut bar or the component menu.

Target Area (Area scope only)

When the scope is set to Area, you must select the target area via the Select target area button. A paginated picker lists all available puzzle areas by id.

If no target area is configured, or if the target area no longer exists, the leaderboard displays an error message instead of rankings.

Display

The leaderboard renders as a floating text panel (Text Display entity). It is always visible and faces the player. The top 3 entries are highlighted in gold, silver and dark red respectively.

Example display:

  ── Best time (area) ──
  #1 PlayerOne  1m23.456s
  #2 PlayerTwo  1m45.000s
  #3 PlayerThree  2m01.123s

Refresh

The leaderboard refreshes automatically:

• After each player victory in any puzzle area.
• When the leaderboard configuration is changed (scope, criteria, nbLines, target area).

Player names are stored in the database at login time so offline players still appear with their correct Minecraft name.

Common Issues

The leaderboard shows an error message:

• Check that the target area id is set (Area scope).
• Check that the target area still exists.

A player's name appears as "Unknown":

• The player has never connected since the feature was added. Their name will be updated on next login.

See our issue board for more information.