Description
Gallery
Changelog
Versions
Overview
ScoreboardPL is a powerful, lightweight and fully customizable scoreboard plugin for your Minecraft server. Designed for simplicity and performance, it works completely out of the box — no database, no complex setup, just drop it in and configure.
Every single aspect of the scoreboard is controlled through a single, well-documented config.yml file. Add lines, remove lines, reorder them, change colors, swap placeholders — all without touching a single line of code.
⌨️ Commands
| Command | Alias | Permission | Description |
|---|---|---|---|
/scoreboard toggle |
/sb toggle |
all players | Toggle your scoreboard on or off |
/scoreboard reload |
/sb reload |
scoreboardpl.reload (OP) |
Reload the config live |
📋 Placeholders (35+)
🖥️ Server
| Placeholder | Description |
|---|---|
%server_name% |
Your server name (set in config) |
%server_online% |
Number of currently online players |
%server_max_players% |
Maximum player slots |
%server_tps% |
Live server TPS (max 20.0) |
%server_version% |
Server Minecraft version |
%server_uptime% |
Server uptime since last start (e.g. "2h 14m") |
%server_ram_used% |
RAM currently in use, in MB |
%server_ram_max% |
Maximum RAM allocated, in MB |
👤 Player
| Placeholder | Description |
|---|---|
%player_name% |
Player's username |
%player_displayname% |
Player's display name |
%player_health% |
Current health (e.g. 18.0) |
%player_max_health% |
Maximum health (e.g. 20.0) |
%player_food% |
Food level (0–20) |
%player_level% |
XP level |
%player_exp% |
XP progress percentage |
%player_ping% |
Connection ping in ms |
%player_ping_color% |
Ping, automatically colored green/yellow/red |
%player_world% |
Current world name |
%player_gamemode% |
Current gamemode |
%player_x% |
X coordinate |
%player_y% |
Y coordinate |
%player_z% |
Z coordinate |
%player_deaths% |
Total death count |
%player_kills% |
Total player kills |
%player_blocks_walked% |
Total blocks walked in meters |
%player_playtime_hours% |
Total playtime in hours |
%player_armor% |
Armor points (0–20) |
%player_direction% |
Compass direction the player is facing |
%player_item_in_hand% |
Item currently held in the main hand |
%player_biome% |
Biome the player is currently standing in |
🕐 Date & Time
| Placeholder | Description |
|---|---|
%time% |
Current server time (HH:mm:ss) |
%date% |
Current date (dd.MM.yyyy) |
%day% |
Current day of the week |
💰 Vault (requires Vault + Economy plugin)
| Placeholder | Description |
|---|---|
%vault_balance% |
Player balance with decimals (1,234.50) |
%vault_balance_int% |
Player balance without decimals (1,234) |
%vault_rank% |
Primary permission group via Vault |
🔑 LuckPerms (requires LuckPerms)
| Placeholder | Description |
|---|---|
%luckperms_group% |
Player's primary LuckPerms group |
%luckperms_prefix% |
Player's LuckPerms prefix |
%luckperms_suffix% |
Player's LuckPerms suffix |
🔌 PlaceholderAPI Support
ScoreboardPL now hooks into PlaceholderAPI — fully optional, zero extra config:
- Use any placeholder from any other plugin that registers with PlaceholderAPI (Essentials, Jobs, mcMMO, ...) directly in your lines or title, right alongside ScoreboardPL's own 35+ built-in placeholders.
- PlaceholderAPI not installed? Nothing changes — everything works exactly like before.
- ScoreboardPL also publishes its own values for other plugins to use, via
%scoreboardpl_visible%and%scoreboardpl_toggle_status%.
✨ Effects
Give your scoreboard some flair, without any resource pack or extra plugin:
| Tag | Effect |
|---|---|
&#RRGGBB |
A single true RGB hex color |
<gradient:#00c6ff:#0072ff>Text</gradient> |
A smooth color gradient across the text |
<rainbow>Text</rainbow> |
An animated, moving rainbow |
You can also animate the title itself: instead of one static title, give title-frames a list of 2+ lines and ScoreboardPL cycles through them automatically (speed configurable). All of this is 100% optional — a plain config with just &-color codes still looks and works exactly as before.
⚙️ Config Features
- Set your own scoreboard title with color codes
- Add, remove and reorder unlimited lines freely
- Use
""as an empty spacer line - Set the update interval in ticks (default: every second)
- Configure your timezone for accurate time display
- Customize all plugin messages including the prefix
- Optional animated title — cycle through multiple title-frames automatically
- Optional PlaceholderAPI integration — works with zero extra setup if installed
- Everything is explained with inline comments directly in the config
🖥️ Compatibility
| Server Software | Version | Supported |
|---|---|---|
| Paper | 1.21 – 26.2 | ✅ |
| Folia | 1.21 – 26.2 | ✅ |
| Spigot | 1.21 – 26.2 | ✅ |
| Purpur | 1.21 – 26.2 | ✅ |
| CraftBukkit | 1.21 – 26.2 | ✅ |
All Versions
+ Add Version
[1.5.0] ScoreboardPL 1.5.0
by Max_01001 on Oct 15, 2026
Download
## [1.5.0] — Paper 26.1 / 26.2
### Changed
### Requirements
### Notes
### Changed
- Plugin now targets Paper 26.1 and 26.2 specifically: compiled against paper-api 26.1.2–26.2, built with Java 25
plugin.ymlapi-versionraised to26.1- Bumped the shade plugin's bundled ASM to 9.8 so the shaded jar can correctly relocate Java 25 bytecode
### Requirements
- Server must run **Java 25** (required by Paper 26.1+)
### Notes
- No feature/config changes — all placeholders, the PlaceholderAPI hook and the rainbow/gradient/hex effects from 1.4.0 are unchanged
- Running an MC 1.21.x server? Stay on the 1.4.x release, which targets Java 21
[1.4.0] ScoreboardPL 1.4.0
by Max_01001 on Oct 15, 2026
Download
## [1.4.0]
### Added
### Changed
### Notes
### Added
- Full **PlaceholderAPI** integration (soft-depend) — use any placeholder from any other plugin directly in your scoreboard lines and title
- ScoreboardPL now exposes its own values to other plugins via PlaceholderAPI:
%scoreboardpl_visible%,%scoreboardpl_toggle_status% - New text effects: RGB hex colors (
&#RRGGBB), color gradients (<gradient:#..:#..>text</gradient>), and an animated rainbow (<rainbow>text</rainbow>) - Animated scoreboard titles — set
title-framesto a list of lines to cycle through automatically, with configurable speed
### Changed
config.ymlupdated with documentation for the new placeholders and effects (fully backwards-compatible — existing configs keep working unchanged)
### Notes
- All new features are opt-in. If you don't touch the new config options, your scoreboard behaves exactly as before.
[1.3.1] ScoreboardPL 1.3.1
by Max_01001 on Oct 15, 2026
Download
### 🔧 Platform Support
### ✨ Placeholders (unchanged from 1.3.1)
Includes all 8 placeholders added in this version:
All new placeholders are documented in
### 📖 Notes
- ScoreboardPL is now also available for **Minecraft 1.21 – 1.21.11** (Paper, Spigot, Bukkit, Purpur, Folia), built against Java 21.
- Same jar, same features as the 26.x release — nothing was removed or changed functionally.
### ✨ Placeholders (unchanged from 1.3.1)
Includes all 8 placeholders added in this version:
- Player**
%player_armor%,%player_direction%,%player_item_in_hand%,%player_biome%,%player_ping_color%
- Server**
%server_uptime%,%server_ram_used%,%server_ram_max%
All new placeholders are documented in
config.yml but not added to the default layout — add them to scoreboard.lines yourself if you want to use them.### 📖 Notes
- No config migration needed, just drop in the new jar.
- Requires **Java 21** on this build (the 26.x build requires Java 25).
[1.3.1] ScoreboardPL 1.3.1
by Max_01001 on Oct 15, 2026
Download
### ✨ New Placeholders
All 8 placeholders are documented in
### 📖 Notes
- Player**
%player_armor%— current armor points (0–20)%player_direction%— compass direction the player is facing (N/NO/O/SO/S/SW/W/NW)%player_item_in_hand%— name of the item currently held in the main hand%player_biome%— biome the player is currently standing in%player_ping_color%— ping, automatically colored (green <50ms, yellow <150ms, red above)
- Server**
%server_uptime%— server uptime since the last start (e.g.2h 14m)%server_ram_used%— RAM currently in use, in MB%server_ram_max%— maximum RAM allocated to the server, in MB
All 8 placeholders are documented in
config.yml but **not** added to the default scoreboard layout — add them to scoreboard.lines yourself if you want to use them.### 📖 Notes
- No config migration needed, just drop in the new jar.
[1.3.0] ScoreboardPL 1.3.0
by Max_01001 on Oct 15, 2026
Download
The plugin has been updated to versions 26.1 and 26.2.
[1.2.0] ScoreboardPL 1.2.0
by Max_01001 on Oct 15, 2026
Download
Now the scoreboard doesn't flicker anymore when you use it with in-game money
[1.1.1] ScoreboardPL 1.1.1
by Max_01001 on Oct 15, 2026
Download
There was just a small fix for the time zones and a few minor bug fixes.
[1.1.0] ScoreboardPL 1.1.0
by Max_01001 on Oct 15, 2026
Download
Two small bugs were fixed in the new version 1.1.0 of the plugin.
[1.0.0] ScoreboardPL-1.0.0
by Max_01001 on Oct 15, 2026
Download
## v1.0.0 — Initial Release
### ✨ Features
### ⌨️ Commands
### ⚙️ Config
### 🔌 Compatibility
### ✨ Features
- Fully customizable scoreboard via
config.yml - 25+ built-in placeholders across 5 categories
- Live TPS display pulled directly from the server
- Vault integration — balance (with/without decimals) and permission group
- LuckPerms integration — group, prefix and suffix support
- Real-time clock, date and day-of-week display with configurable timezone
- Player stats — kills, deaths, blocks walked, playtime in hours
- Player coordinates — X, Y, Z updated every tick cycle
- Health and food level display
- XP level and progress percentage
- Current world and gamemode display
- Player ping in milliseconds
- Server online count and max slots
- Minecraft server version display
### ⌨️ Commands
/scoreboard toggle— Toggle scoreboard on/off per player/scoreboard reload— Live config reload without server restart- Aliases:
/sb,/sboard
### ⚙️ Config
- Fully commented
config.ymlexplaining every placeholder - Instructions for adding, removing and reordering lines
- Configurable update interval (in ticks)
- Configurable timezone for time/date placeholders
- Custom scoreboard title with color code support
- Customizable plugin messages and prefix
- Auto-creates config on first launch
### 🔌 Compatibility
- Compatible with Paper, Spigot, Purpur, Folia and CraftBukkit 1.21+
- Vault and LuckPerms as soft-dependencies (plugin works without them)
- Built with Java 21 and Paper API 1.21
