JP Plugins
All plugins

JPLeaderboard

Leaderboards with player statues, podiums and holograms for Paper servers.

Display plugin, version 1.0.0

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

  1. Put JPLeaderboard-<version>.jar in your server's plugins folder.
  2. Restart the server. plugins/JPLeaderboard/ is created with the config and messages.
  3. 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

CommandDescriptionPermission
/lb help
Aliases: /lb, /leaderboards, /jplb
Leaderboards, statues and podiums.jpleaderboard.use

Permissions

PermissionDefaultDescription
jpleaderboard.useeveryoneSee boards with /lb and /lb top.
jpleaderboard.adminoperatorsPlace statues, podiums and hologram boards.
jpleaderboard.hiddennobodyNever shown on any leaderboard (e.g. staff test accounts).

Placeholders

Needs PlaceholderAPI.

PlaceholderShows
%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: true

Support

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.