Content generated with AI — it may contain mistakes.

ExyliaCapture/GuidesUpdated in v1.3.0

Show statistics and leaderboards

See what is counted, open the leaderboards and change how they look.

Page 9 of 234 min read

By the end of this page players can open a player and a clan leaderboard, you decide how many rows it shows and how much a win is worth, and you can print the numbers on any scoreboard or hologram.

Before you start#

Statistics are saved by the plugin on their own; there is nothing to enable. Players need exyliacapture.leaderboard for /capture top and exyliacapture.leaderboard.clan for /capture clantop; both are on for everyone by default. See Permissions.

Steps#

Open the leaderboards

Run /capture top for players or /capture clantop for clans. You can also run /capture and use the tab bar at the bottom to switch between events, players and clans.

Filter by event

Click Filter ▸ By event and pick one event to rank only its own results. Click Filter ▸ Global to go back to all events combined.

Change what a win is worth

Run /captureadmin, click Configurations, click the event, then Leaderboard points. Left-click adds 1, right-click removes 1, shift-click lets you type a number. The default is 1 point per win.

Change the size and look

Run /captureadmin, click Settings, then Leaderboard. Rows sets how many positions are listed (default 50) and Player heads switches between each player's head and a plain block.

Check that it works#

Win an event, wait up to a minute, then run /capture top. Your name is in the list with your points, wins and captures. The top is cached and refreshed every 60 seconds (and once at startup), so a win is not shown instantly.

Going further#

How the ranking is sorted#

Leaderboards rank by leaderboard points, not by wins or points earned. That value belongs to each event: it is 1 per win by default, so an event that should matter more can give 3 or 5 without touching the others.

Show the numbers on a scoreboard or hologram#

These placeholders need PlaceholderAPI. Replace <position> with 1, 2, 3 and so on.

PlaceholderShowsExample
%exyliacapture_stats_wins%Your global wins.3
%exyliacapture_stats_captures%Your global captures.12
%exyliacapture_stats_points%Your global points earned.240
%exyliacapture_stats_leaderboard_points%Your global leaderboard points.15
%exyliacapture_stats_time_captured%Your global time spent capturing.10m
PlaceholderShowsExample
%exyliacapture_top_player_<position>_name%Name of the player in that position. An em dash past the end of the list.Steve
%exyliacapture_top_player_<position>_wins%Wins of the player in that position.3
%exyliacapture_top_player_<position>_points%Points earned.240
%exyliacapture_top_player_<position>_leaderboard_points%Leaderboard points.15
%exyliacapture_top_player_<position>_captures%Captures.12
%exyliacapture_top_player_<position>_time_captured%Time spent capturing.10m
%exyliacapture_top_clan_<position>_name%Name of the clan in that position. An em dash past the end of the list.Dragons
%exyliacapture_top_clan_<position>_wins%Clan wins.3
%exyliacapture_top_clan_<position>_points%Clan total points.240
%exyliacapture_top_clan_<position>_leaderboard_points%Clan leaderboard points.15
%exyliacapture_top_clan_<position>_captures%Clan captures.12

What is counted#

Statistics are kept in four places at once: per player globally, per player per event, per clan globally and per clan per event.

CounterPlayerClanWhen it moves
WinsYesYesOn winning an event
Leaderboard pointsYesYesOn winning, by the event's leaderboard points
CapturesYesYesOn each capture, core break or payload win
Points earnedYesYesAs points are scored during an event
Time capturedYesNoWhile holding a zone
What each event type records
TypeRecords
KOTHCapture and capture time on each capture; win and leaderboard points on the win
KOTH Points (exclusive and multi)Points earned and one second of capture time per scoring second
KOTH Capture PointsCapture, one point and the capture time per completed capture
ConquestCapture and the zone's points on each zone capture
PayloadWin and capture on delivery
Destroy The CoreCapture and the break's points on each break

Leaderboard appearance#

Rows and player heads are in Settings ▸ Leaderboard in game. The materials are only in config.yml:

plugins/ExyliaCapture/config.yml
yaml
leaderboard:
  top-limit: 50
  use-player-heads: true
  rank-materials:
    first: GOLD_BLOCK
    second: IRON_BLOCK
    third: COPPER_BLOCK
    default-player: PLAYER_HEAD
    default-clan: SHIELD
  filter-materials:
    active: LIME_CONCRETE
    inactive: RED_CONCRETE
Leaderboard keys
KeyDefaultWhat it does
top-limit50How many rows a leaderboard holds, from 1 to 500.
use-player-headstrueDraw each row as that player's head. Heads are fetched once and cached.
rank-materialssee aboveThe items the top three rows and the rest are drawn with.
filter-materialssee aboveThe chosen and unchosen event filters.

The top is served from a memory snapshot so a scoreboard that reads %exyliacapture_top_...% every refresh never queries the database per line.

The menu layouts themselves (titles, lore, slots) are editable files; see Edit menus and Messages and languages.

Something missing on this page? Tell us on Discord