ScoreboardPlus

A lightweight, fully configurable sidebar scoreboard plugin for Spigot/Paper servers — one command, one config file, and a bunch of handy subcommands to manage everything without ever touching the file system.

✨ Features

• 🪶 Lightweight — no external dependencies, pure Bukkit API
• ⚙️ Single config.yml — title, lines, update interval, and messages all in one place
• 🧩 Live editing in-game — change the title or lines with commands, no restarts needed
• 🔄 Auto-updating — refreshes on a configurable tick interval
• 🎨 Full color code support (&-codes)
• 🧠 Built-in placeholders — %player%, %online%, %maxplayers%, %world%, %date%, %time%
• 🔌 PlaceholderAPI support (soft-dependency, auto-detected)
• 👤 Per-player toggle — players can turn their own scoreboard on/off

📜 Commands

Everything lives under a single command: /scoreboardplus (aliases: /sb, /sbp, /scoreboard).

Every editing command saves straight to config.yml and instantly refreshes the scoreboard for all online players — no /reload required.

🔑 Permissions

🧠 Placeholders

Use these directly inside title and lines in config.yml:

%player%       -> player's name
%online%       -> online player count
%maxplayers%   -> max player count
%world%        -> the player's current world
%date%         -> current date
%time%         -> current time

If PlaceholderAPI is installed, its placeholders (%plugin_something%) work automatically — no extra setup needed.

⚙️ Example configuration

settings:
  enabled-by-default: true
  update-interval: 20

scoreboard:
  title: "&6&lMyServer"
  lines:
    - "&7&m----------------"
    - "&fPlayer: &e%player%"
    - "&fOnline: &e%online%&7/&e%maxplayers%"
    - "&fWorld: &e%world%"
    - "&fTime: &e%time%"
    - " "
    - "&aplay.example.com"
    - "&7&m----------------"

📥 Installation

1. Drop the .jar file into your server's plugins/ folder.
2. Restart (or start) the server — this generates the default config.yml.
3. Edit config.yml or use the in-game commands to customize the scoreboard.
4. Run /sb reload to apply changes without restarting.

🖥️ Compatibility

• Platform: Spigot / Paper
• Minecraft version: 1.20+ (built and tested against 1.20.x-1.21)
• Dependencies: none required
• Soft-dependencies: PlaceholderAPI (optional)