ScoreboardPL

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 (25+)

🖥️ 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 |

👤 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_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 |

🕐 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 |

---

⚙️ Config Features

- Set your own inline comments with color codes - Add, remove and reorder inline comments freely - Use `""` as an inline comments - Set the inline comments in ticks (default: every second) - Configure your inline comments for accurate time display - Customize all inline comments including the prefix - Everything is explained with inline comments directly in the config

---

🖥️ Compatibility

| Server Software | Version | Supported | |---|---|---| | Paper | 1.21 – 1.21.x | ✅ | | Folia | 1.21 – 1.21.x | ✅ | | Spigot | 1.21 – 1.21.x | ✅ | | Purpur | 1.21 – 1.21.x | ✅ | | CraftBukkit | 1.21 | ✅ |

---

💬 Support & Updates: Support & Updates: