# SimpleScoreboard<\/p>\n
A configurable scoreboard plugin for Paper. Author your sidebar, tab-list, and below-name displays in YAML or edit them in-game from a chest GUI. Multi-board priority selection by world, permission, or gamemode. Frame rotation, horizontal scrolling, and full Adventure MiniMessage formatting.<\/p>\n
## Features<\/p>\n
– **All three scoreboard slots**: sidebar, tab-list (header + footer), below-name objective
\n– **Multi-board priority list** with conditions on world, permission, gamemode (combinable, AND-evaluated, first match wins)
\n– **Animations**: frame rotation and horizontal text scrolling, configurable per line and tick-precise
\n– **MiniMessage** for all text \u2014 colors, gradients, rainbows, click and hover events
\n– **Built-in placeholders** for player, world, ping, coords, gamemode, health, online count, max players, TPS
\n– **PlaceholderAPI** integration when present \u2014 every `%papi_*%` token just works
\n– **In-game GUI editor** (`\/sb gui`) for the impatient: edit boards, conditions, lines, and animations from a chest menu with live preview
\n– **Tab-completion** on every `\/sb` subcommand including dynamic board names
\n– **Per-player toggle** with persistence (`\/sb toggle`)
\n– **Hot reload** without server restart (`\/sb reload`)
\n– **Diff-based render**: per-player last-sent cache means packets only fire when output actually changes \u2014 static lines never re-send<\/p>\n
## Quick Example<\/p>\n
“`yaml
\ndefaults:
\n tick-interval: 1
\n scroll-width: 24<\/p>\n
boards: – name: default ## Commands<\/p>\n | Command | Permission | Description | Aliases: `\/scoreboard`, `\/simplescoreboard`.<\/p>\n ## Requirements<\/p>\n – **Paper** (built against API `26.1.2`) ## Installation<\/p>\n 1. Drop `SimpleScoreboard.jar` into your `plugins\/` folder. ## Configuration<\/p>\n `plugins\/SimpleScoreboard\/scoreboard.yml`. Top-level structure:<\/p>\n “`yaml boards: ### Line types<\/p>\n A ` “`yaml # Rotate \u2014 cycle through frames # Scroll \u2014 horizontal scroll within a fixed width ## In-Game Editor<\/p>\n `\/sb gui` opens a chest-based editor. Navigation:<\/p>\n “` Text content (titles, frame text, scroll text, score expressions) is entered through chat \u2014 when you click “Edit text” the menu closes, you type the new MiniMessage value, and the menu reopens. Type `!cancel` to abort. Inputs time out after 60 seconds.<\/p>\n While editing, your own scoreboard updates **live** with the unsaved draft so you can see how it looks before committing.<\/p>\n Saving regenerates `scoreboard.yml` (a one-time `.backup` is created first), atomically replaces the file, and re-renders for all players. Cancel discards the draft without touching the file.<\/p>\n > **Note**: GUI saves rewrite the YAML through SnakeYAML’s standard dumper. Hand-written comments are not preserved. Keep that in mind if you maintain `scoreboard.yml` by hand and use the GUI on the same file.<\/p>\n ## Built-in Placeholders<\/p>\n | Token | Resolves to | Anything else is forwarded to PlaceholderAPI when installed. Unknown tokens (no built-in, no PAPI) stay as raw text \u2014 useful for spotting typos visually.<\/p>\n ## Permissions<\/p>\n | Node | Default | Grants | ## Performance<\/p>\n Each player has a per-tick render cycle. The renderer compares the freshly-built component list against a cached last-sent snapshot and only sends an update packet when a line actually differs. Static lines without dynamic placeholders never re-send. Frame-rotation and scrolling lines re-send only when the frame index or scroll offset changes.<\/p>\n `scoreboard.yml` is parsed once at startup (and on `\/sb reload`). The `BoardRegistry` uses an atomic reference, so reloads are wait-free for the render loop.<\/p>\n ## Compatibility Notes<\/p>\n – The Sidebar slot is rendered through the FastBoard library (shaded and relocated). Plays nicely alongside any other scoreboard plugin that touches Tab-list or Below-Name only. A Plugin wich adds a new Scoreboard desing, wich can also be configured ingame with a nice GUI.<\/p>\n","protected":false},"featured_media":140536,"template":"","meta":{"_minecraft_slug":"simple-scoreboard","_minecraft_project_id":"ZoVbnwrs","_minecraft_author":"klausiiiii","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":20,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simple-scoreboard.zip","_minecraft_size_bytes":121576,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:30:22.930902Z","_minecraft_date_created":"2026-05-07T21:58:46.653160Z","_minecraft_date_modified":"2026-05-01T00:20:09.556872Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simple-scoreboard","_minecraft_icon_attachment_id":140536,"_minecraft_imported_at":"2026-06-08T08:12:57+00:00","_minecraft_import_hash":"bc9519dfe4b95ce968cefee63aab45f4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,126,127],"mod_loader":[132],"minecraft_version":[163],"class_list":["post-140535","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_loader-paper","minecraft_version-26-1-2"],"yoast_head":"\n
\n – name: pvp-arena
\n conditions:
\n worlds: [pvp_arena]
\n permission: server.staff
\n sidebar:
\n title:
\n type: rotate
\n interval: 10
\n frames:
\n – “
\n – “
\n lines:
\n – “
\n – “
\n – “
\n – “”
\n – type: scroll
\n width: 24
\n interval: 2
\n text: “Welcome to the staff PvP arena”
\n – “
\n sidebar:
\n title: “
\n lines:
\n – “
\n – “
\n tablist:
\n header: “
\n footer: “
\n“`<\/p>\n
\n|—|—|—|
\n| `\/sb gui [board]` | `simplescoreboard.admin` | Open the in-game editor (optionally jumping to a specific board) |
\n| `\/sb reload` | `simplescoreboard.admin` | Reload `scoreboard.yml`. On parse error the old config keeps running. |
\n| `\/sb list` | `simplescoreboard.admin` | List boards in priority order |
\n| `\/sb show
\n| `\/sb show none` | `simplescoreboard.admin` | Clear preview, return to normal selection |
\n| `\/sb toggle` | `simplescoreboard.toggle` | Hide\/show your own scoreboard. Preference persists across reconnects. |<\/p>\n
\n– **Java 25**
\n– **PlaceholderAPI** \u2014 optional, only needed for `%papi_*%` tokens<\/p>\n
\n2. Start the server. A default `scoreboard.yml` is created in `plugins\/SimpleScoreboard\/`.
\n3. Edit the YAML or run `\/sb gui` to customize.
\n4. `\/sb reload` applies YAML changes without restart.<\/p>\n
\ndefaults:
\n tick-interval: 1 # ticks between renders. 1 = full animation resolution.
\n scroll-width: 24 # default character window for scrolling lines<\/p>\n
\n – name:
\n conditions: # optional. omit = catch-all (matches everyone)
\n worlds: […] # optional, any of these worlds
\n permission: … # optional, player must have this permission
\n gamemodes: […] # optional, any of these gamemodes
\n sidebar: # optional, omit to leave sidebar untouched
\n title:
\n –
\n header:
\n title:
\n“`<\/p>\n
\n# Static \u2014 plain MiniMessage string
\n“
\ntype: rotate
\ninterval: 10 # ticks per frame
\nframes: [“Frame A”, “Frame B”, “Frame C”]<\/p>\n
\ntype: scroll
\ninterval: 2 # ticks per character shift
\nwidth: 24 # visible characters
\ntext: “Long welcome text that scrolls”
\n“`<\/p>\n
\nMainMenu (board list + add)
\n \u2514\u2500\u2500 BoardMenu (rename, delete, conditions, slots)
\n \u251c\u2500\u2500 ConditionsMenu (worlds, permission, gamemodes)
\n \u251c\u2500\u2500 SidebarMenu (title + lines, reorder, add, remove)
\n \u2502 \u2514\u2500\u2500 LineEditMenu (Static \/ Rotate \/ Scroll switcher)
\n \u2502 \u2514\u2500\u2500 RotateFramesMenu (for Rotate type)
\n \u251c\u2500\u2500 TablistMenu (header, footer, enable\/disable)
\n \u2514\u2500\u2500 BelowNameMenu (title, score expression, enable\/disable)
\n“`<\/p>\n
\n|—|—|
\n| `%player%` | Player name |
\n| `%displayname%` | Adventure-Component display name (string form) |
\n| `%world%` | Current world name |
\n| `%gamemode%` | `SURVIVAL` \/ `CREATIVE` \/ `ADVENTURE` \/ `SPECTATOR` |
\n| `%ping%` | Player ping in ms |
\n| `%x%`, `%y%`, `%z%` | Integer block coordinates |
\n| `%health%` | Health rounded to integer |
\n| `%online%` | Online player count |
\n| `%max-players%` | Server slot count |
\n| `%tps%` | Server TPS (1 decimal) |<\/p>\n
\n|—|—|—|
\n| `simplescoreboard.admin` | op | `\/sb reload`, `\/sb list`, `\/sb show`, `\/sb gui` |
\n| `simplescoreboard.toggle` | true | `\/sb toggle` |<\/p>\n
\n– Two plugins both writing the Sidebar will conflict \u2014 disable one or coordinate via permissions.
\n– Tab-list is set per-player via Paper’s Adventure API. Tab-list-modifying plugins (e.g. some prefix systems that write the player-list display name) are independent and won’t conflict.<\/p>\n","protected":false},"excerpt":{"rendered":"