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	✅

---