ScoreboardPL

ScoreboardPL

ScoreboardPL is a lightweight, fully customizable scoreboard plugin for Paper, Folia, Purpur and Spigot. Drop it in, edit one well-documented config.yml, done. No database, no complicated setup.

Build different scoreboards for your lobby, survival, PvP and minigames, let ScoreboardPL pick the right one for every player automatically, and style it with 35+ placeholders, PlaceholderAPI, hex colors, gradients, rainbow text and animated titles.

---

✅ Highlights

• Multiple scoreboards with automatic switching by world, gamemode, rank, permission or any placeholder
• Priorities & fallback: if several scoreboards match, the highest priority wins; if none match, your default is shown
• Per-line conditions: show a line only when it makes sense (e.g. only with an economy plugin)
• Smooth switching: the player's scoreboard is updated in place, it is never torn down and rebuilt
• Light on performance: conditions are compiled once and re-checked on events instead of every tick
• Effects: RGB hex colors, gradients, animated rainbow and animated titles
• 35+ placeholders plus any PlaceholderAPI placeholder
• Folia-ready with region-thread-safe scheduling
• Wide version support: Minecraft 1.20.x, 1.21.x and 26.1 – 26.3
• Everything lives in one commented config.yml, with live /sb reload

---

🎯 Multiple Scoreboards

Define as many scoreboards (called profiles) as you like. Each player automatically sees the one that fits their situation, and it changes by itself when the situation changes: entering another world, switching gamemode, getting a new rank.

scoreboards:
  default-profile: default       # shown when nothing else matches

  lobby:
    priority: 10                 # higher number wins
    conditions:
      world: [lobby, hub]
    title: "&b&lMY SERVER"
    lines:
      - " &7Welcome, &f%player_name%&7!"
      - " &7Rank&8: &6%luckperms_group%"
      - " &7Online&8: &a%server_online%"

  survival:
    priority: 10
    conditions:
      world: [world, world_nether, world_the_end]
    title: "&a&lSURVIVAL"
    lines:
      - " &7Your statistics"
      - text: " &7Money&8: &a$%vault_balance_int%"
        condition: "%vault_balance_int% != N/A"    # line only shown if it has a value
      - " &7Kills&8: &f%player_kills%"

  pvp:
    priority: 20                 # beats lobby/survival if both match
    conditions:
      world: [pvp]
      gamemode: [SURVIVAL]
    title: "&c&lPVP"
    lines:
      - " &7Kills&8: &c%player_kills%"
      - " &7Ping&8: %player_ping_color%"

How a scoreboard is chosen

1. Manual override (/sb set or the API from another plugin)
2. Otherwise the highest priority profile whose conditions are all met (on a tie, the one listed first in the config wins)
3. Otherwise the default-profile

A profile without conditions is never picked automatically. It is only used as the default or as an override.

Conditions

All entries inside conditions: must be true. Line conditions use a short form such as "world:survival", "permission:my.node" or "%player_level% >= 10", and a leading ! negates them.

Built for performance

• Conditions are parsed once when the config loads, never on every update
• World, gamemode and LuckPerms rank changes are picked up instantly through events, with no polling
• Only placeholder-based conditions are re-checked periodically, and the interval is configurable (condition-check-interval-ticks)
• A scoreboard is only redrawn when the chosen profile actually changes

---

⌨️ Commands & Permissions

---

📋 Placeholders (35+)

🖥️ Server

👤 Player

🕐 Date & Time

💰 Vault (requires Vault + an economy plugin)

🔑 LuckPerms (requires LuckPerms)

📊 ScoreboardPL

---

🔌 PlaceholderAPI Support

PlaceholderAPI is fully optional and needs zero extra configuration:

• Use any placeholder from any other plugin (Essentials, Jobs, mcMMO, ...) in your lines, titles and conditions, right next to ScoreboardPL's own placeholders.
• PlaceholderAPI not installed? Everything still works, you just don't get the extra placeholders.
• ScoreboardPL also publishes its own values for other plugins (chat, tab, join messages, ...):

---

✨ Effects

Give your scoreboard some flair, without a resource pack or an extra plugin:

You can also animate the title itself: give title-frames a list of lines and ScoreboardPL cycles through them automatically, with configurable speed. Each profile can have its own animated title. Everything is optional, and plain & color codes keep working exactly as before.

---

⚙️ Config Features

• A separate title and layout per scoreboard, with color codes and effects
• Add, remove and reorder lines freely (up to 15), and use "" for empty spacer lines
• Update interval in ticks (default: every second)
• Timezone for accurate time display
• Customizable plugin messages including the prefix
• Inline comments that explain every option
• Old configs keep working: if you have no scoreboards: section, your existing scoreboard: section is used automatically as the default profile

---

📦 Installation

1. Download the file that matches your Minecraft version (see Compatibility below) and drop it into your plugins folder.
2. Restart the server.
3. Edit plugins/ScoreboardPL/config.yml and run /sb reload.

Vault, LuckPerms and PlaceholderAPI are optional. ScoreboardPL detects them automatically.

---

🖥️ Compatibility

ScoreboardPL has a separate build for each Minecraft generation. Download the file that matches your server version (see the Versions tab):

---

💬 Support

Questions, bugs or feature ideas? Join the Discord. If you enjoy ScoreboardPL, you can support its development on Ko-fi or PayPal. Thank you!