JPLeaderboard
Leaderboards with player statues, podiums and holograms for Paper servers.
Downloads open soon.
Features
- Leaderboards from any PlaceholderAPI value or built-in statistics
- Player statues with skins, podiums and holograms
- Includes offline players
- Colours per place
Requirements
- Paper 26.1 or newer (Java 25)
- Optional:
- PlaceholderAPI: placeholders in texts, and this plugin's own placeholders
- Vault: money (any Vault economy)
Installation
- Put
JPLeaderboard-<version>.jarin your server'spluginsfolder. - Restart the server.
plugins/JPLeaderboard/is created with the config and messages. - Change what you want in the files, then reload or restart.
Type /jp as an operator to see every JP plugin you have installed, its version and which optional plugins it found.
Commands
| Command | Description | Permission |
|---|---|---|
/lb helpAliases: /lb, /leaderboards, /jplb | Leaderboards, statues and podiums. | jpleaderboard.use |
Permissions
| Permission | Default | Description |
|---|---|---|
jpleaderboard.use | everyone | See boards with /lb and /lb top. |
jpleaderboard.admin | operators | Place statues, podiums and hologram boards. |
jpleaderboard.hidden | nobody | Never shown on any leaderboard (e.g. staff test accounts). |
Placeholders
Needs PlaceholderAPI.
| Placeholder | Shows |
|---|---|
%jpleaderboard_<board>_name_<n>% | name at place n |
%jpleaderboard_<board>_value_<n>% | formatted value at place n |
%jpleaderboard_<board>_raw_<n>% | unformatted value at place n |
%jpleaderboard_<board>_you% | the reader's own value |
%jpleaderboard_<board>_rank% | the reader's place (0 = not on the board) |
%jpleaderboard_<board>_title% | the board's title |
Configuration
All files are in plugins/JPLeaderboard/. Files: boards.yml, config.yml, messages.yml.
When you update the plugin, new options are added to your config.yml by themselves, with their comments. Your own settings stay as they are, and the old file is kept as config.old-v<number>.yml.
Languages: English, Spanish, Portuguese, French and German. Set language: in config.yml (en, es, pt, fr or de).
Default config.yml
# Used to add new options to this file after an update. Don't change it.
config-version: 1
# ╔══════════════════════════════════════════════════════════════════╗
# ║ JPLeaderboard · config.yml ║
# ╚══════════════════════════════════════════════════════════════════╝
# Leaderboards for anything: kills, playtime, blocks mined, money, or any PlaceholderAPI
# number. The boards themselves are in boards.yml; this file is about how they look.
# Apply changes with /lb reload.
#
# Quick start (as op, standing where you want it):
# /lb podium kills three statues of the top 3 with their skins, on a podium
# /lb statue playtime 1 one statue of whoever is first
# /lb hologram money 10 a floating top 10
# /lb top kills the top list in chat (everyone)
# /lb remove removes the statue/board you stand next to
# Statues change skin by themselves when someone new takes the place.
#
# Placeholders for other plugins (e.g. JPHolograms templates, scoreboards):
# %jpleaderboard_<board>_name_<n>% %jpleaderboard_<board>_value_<n>%
# %jpleaderboard_<board>_you% %jpleaderboard_<board>_rank%
#
# Statue skins come from the Minecraft account with the player's name, so they show on
# online-mode servers and for premium names on offline-mode servers.
# Language of the messages: en (messages.yml), es, pt, fr or de (lang/<code>.yml).
# Your own language: copy a file in the lang folder to lang/<code>.yml, translate it
# and set its code here (for example it for lang/it.yml).
language: en
# Replace messages.yml with the new design when the plugin is updated.
# Your old file is kept as messages.old-vX.yml. false = never touch it.
auto-update-style: true
# Register the placeholders above (needs PlaceholderAPI).
placeholderapi: true
# Seconds between two updates (online players are measured, boards re-sorted).
update-seconds: 60
# On the first start, read the statistics of every player who ever joined, so the
# statistic boards are full right away (a few players per tick, no lag).
scan-offline-players: true
scan-per-tick: 10
# Shown for an empty place.
empty-name: '&8---'
# {color} in the texts below, per place.
place-colors:
'1': '&#FFD700'
'2': '&#C0C0C0'
'3': '&#CD7F32'
other: '&7'
statues:
# Lines above a statue. {color} {place} {name} {value} {title}
text:
- '{color}&l#{place}'
- '&f{name}'
- '&7{value}'
# Blocks between the statue's head and the text.
text-height: 0.35
# STANDING, CROUCHING (sneaking), SWIMMING, FALL_FLYING or SLEEPING
pose: STANDING
hologram:
header:
- '{title}'
- '&8━━━━━━━━━━━━━━'
row: '{color}#{place} &f{name} &8- &7{value}'
footer: []
podium:
# Put blocks under the statues: a full block for 1st, a slab for 2nd, a carpet for
# 3rd (only where there is air). Removing the podium leaves the blocks.
place-blocks: true
block-1: GOLD_BLOCK
block-2: SMOOTH_QUARTZ_SLAB
block-3: ORANGE_CARPET
# A floating title above the podium.
title: trueSupport
Guides and the docs of every JP plugin are on the JP Plugins website. Questions, bugs or ideas? Join the JP Plugins Discord.
License
JPLeaderboard is free to use on any server, including servers that make money, but it is not open source. Don't reupload, sell or share modified copies of it. The full terms are in LICENSE.txt, which is also inside the jar.