ScoreboardSync
A Paper plugin that syncs objectives, scores, and teams to a MySQL/MariaDB database so all backend servers in a Velocity or BungeeCord network share the same scoreboard state. Useful for data packs and cross-server minigames that use vanilla scoreboards.
Installation
- Drop
ScoreboardSync.jarinto every backend server'splugins/folder. - Restart each server to generate
plugins/ScoreboardSync/config.yml. - Set up the database (see below).
- Configure each server — same DB credentials, different
server-name. - Restart again (or use
/sbs reloadfor config-only changes).
Database Setup
Create a single database that all servers connect to:
CREATE DATABASE scoreboardsync CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'sbs'@'%' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON scoreboardsync.* TO 'sbs'@'%';
ScoreboardSync creates its own tables on first start.
What Gets Synced
| Type | Synced fields |
|---|---|
| Objectives | Name, display name, criteria, render type |
| Scores | Objective, entry (player/entity name), score value |
| Teams | Name, display name, prefix, suffix, color, friendly fire, see-friendly-invisibles, nametag visibility, collision rule |
| Team members | Which team each entry belongs to |
Commands
| Command | Permission | Description |
|---|---|---|
/sbs status |
scoreboardsync.admin |
Show server name, sync interval, and DB connection info |
/sbs push |
scoreboardsync.admin |
Immediately push local scoreboard state to DB |
/sbs pull |
scoreboardsync.admin |
Immediately pull DB state and apply locally |
/sbs reload |
scoreboardsync.admin |
Reload config.yml (does not reconnect to DB) |
