ScoreboardPL

ScoreboardPL 1.7.4 (Minecraft 1.20.x)

New: Multiple scoreboards (profiles)

- Define any number of scoreboards under scoreboards: (e.g. lobby, survival, PvP, minigames), each with its own title, lines and optional animated title-frames - Players automatically see the profile that fits them, and it switches by itself when the situation changes - Conditions per profile: world (with * wildcards), gamemode, group, permission and placeholder comparisons (==, !=, >=, <=, >, <), plus any: (OR) and not: - Priorities: if several profiles match, the highest priority wins (ties: the one listed first) - `default-profile`: shown when no conditions match - Per-line conditions: show a line only when its condition is true, e.g. only when an economy plugin is present - Placeholders from PlaceholderAPI, Vault and LuckPerms also work inside conditions

Performance

- Conditions are compiled once on load, never re-parsed on updates - Profile switching is event-driven: join, world change, gamemode change and LuckPerms rank changes are detected instantly - Only placeholder-based conditions are re-checked periodically, configurable via the new settings.condition-check-interval-ticks (default: 40) - Switching a profile updates the player's existing scoreboard in place instead of recreating it

New commands & permissions

- /sb info shows your active profile, why it was chosen and which profiles currently match (scoreboardpl.info) - /sb set <profile|clear> [player] forces a profile for testing or events (scoreboardpl.set)

New placeholder & API

- %scoreboardpl_profile% returns the ID of the profile a player currently sees (built in and via PlaceholderAPI) - Other plugins (e.g. minigames) can use ScoreboardManager#setOverride and #clearOverride to force a profile

Changed

- This build is for Minecraft 1.20.x (1.20.1 – 1.20.6) and runs on Java 17 or newer (api-version: 1.20) - Not compatible with 1.21.x: please use the 1.21 build of ScoreboardPL there - The default config.yml now ships with example profiles and documentation for all condition types

Fixed

- Improved thread safety on Folia: shared player data now uses concurrent collections and money formatting is thread-local

Updating from an older 1.20.x version

- No config changes required. If your config has no scoreboards: section, your existing scoreboard: section is used automatically as the default profile - To use the new features, copy the scoreboards: section from the new default config.yml, or delete your old config and let the plugin generate a fresh one - Run /sb reload after editing the config

Other versions

- Minecraft 1.21.4+: version 1.7.0 - Minecraft 26.1.x: version 1.7.3 - Minecraft 26.2.x: version 1.7.2 - Minecraft 26.3: version 1.7.1

ScoreboardPL 1.7.3 (Minecraft 26.1.x)

New: Multiple scoreboards (profiles)

- Define any number of scoreboards under scoreboards: (e.g. lobby, survival, PvP, minigames), each with its own title, lines and optional animated title-frames - Players automatically see the profile that fits them, and it switches by itself when the situation changes - Conditions per profile: world (with * wildcards), gamemode, group, permission and placeholder comparisons (==, !=, >=, <=, >, <), plus any: (OR) and not: - Priorities: if several profiles match, the highest priority wins (ties: the one listed first) - `default-profile`: shown when no conditions match - Per-line conditions: show a line only when its condition is true, e.g. only when an economy plugin is present - Placeholders from PlaceholderAPI, Vault and LuckPerms also work inside conditions

Performance

- Conditions are compiled once on load, never re-parsed on updates - Profile switching is event-driven: join, world change, gamemode change and LuckPerms rank changes are detected instantly - Only placeholder-based conditions are re-checked periodically, configurable via the new settings.condition-check-interval-ticks (default: 40) - Switching a profile updates the player's existing scoreboard in place instead of recreating it

New commands & permissions

- /sb info shows your active profile, why it was chosen and which profiles currently match (scoreboardpl.info) - /sb set <profile|clear> [player] forces a profile for testing or events (scoreboardpl.set)

New placeholder & API

- %scoreboardpl_profile% returns the ID of the profile a player currently sees (built in and via PlaceholderAPI) - Other plugins (e.g. minigames) can use ScoreboardManager#setOverride and #clearOverride to force a profile

Changed

- This build is for Minecraft 26.1.x and requires Java 25 (api-version: 26.1) - %player_biome% now uses the biome key, so custom biomes are shown correctly too - The default config.yml now ships with example profiles and documentation for all condition types

Fixed

- Improved thread safety on Folia: shared player data now uses concurrent collections and money formatting is thread-local

Updating from 1.5.x

- No config changes required. If your config has no scoreboards: section, your existing scoreboard: section is used automatically as the default profile - To use the new features, copy the scoreboards: section from the new default config.yml, or delete your old config and let the plugin generate a fresh one - Run /sb reload after editing the config

Other versions

- Minecraft 26.2.x: version 1.7.2 - Minecraft 26.3: version 1.7.1 - Minecraft 1.21.4+: version 1.7.0

ScoreboardPL 1.7.2 (Minecraft 26.2)

New: Multiple scoreboards (profiles)

- Define any number of scoreboards under scoreboards: (e.g. lobby, survival, PvP, minigames), each with its own title, lines and optional animated title-frames - Players automatically see the profile that fits them, and it switches by itself when the situation changes - Conditions per profile: world (with * wildcards), gamemode, group, permission and placeholder comparisons (==, !=, >=, <=, >, <), plus any: (OR) and not: - Priorities: if several profiles match, the highest priority wins (ties: the one listed first) - `default-profile`: shown when no conditions match - Per-line conditions: show a line only when its condition is true, e.g. only when an economy plugin is present - Placeholders from PlaceholderAPI, Vault and LuckPerms also work inside conditions

Performance

- Conditions are compiled once on load, never re-parsed on updates - Profile switching is event-driven: join, world change, gamemode change and LuckPerms rank changes are detected instantly - Only placeholder-based conditions are re-checked periodically, configurable via the new settings.condition-check-interval-ticks (default: 40) - Switching a profile updates the player's existing scoreboard in place instead of recreating it

New commands & permissions

- /sb info shows your active profile, why it was chosen and which profiles currently match (scoreboardpl.info) - /sb set <profile|clear> [player] forces a profile for testing or events (scoreboardpl.set)

New placeholder & API

- %scoreboardpl_profile% returns the ID of the profile a player currently sees (built in and via PlaceholderAPI) - Other plugins (e.g. minigames) can use ScoreboardManager#setOverride and #clearOverride to force a profile

Changed

- This build is for Minecraft 26.2.x and requires Java 25 (api-version: 26.2) - %player_biome% now uses the biome key, so custom biomes are shown correctly too - The default config.yml now ships with example profiles and documentation for all condition types

Fixed

- Improved thread safety on Folia: shared player data now uses concurrent collections and money formatting is thread-local

Updating from 1.5.x

- No config changes required. If your config has no scoreboards: section, your existing scoreboard: section is used automatically as the default profile - To use the new features, copy the scoreboards: section from the new default config.yml, or delete your old config and let the plugin generate a fresh one - Run /sb reload after editing the config

Other versions

- Minecraft 26.3: version 1.7.1 - Minecraft 1.21.4+: version 1.7.0

ScoreboardPL 1.7.1

Changed

- Nothing has changed, as the plugin runs on version 26.3 but not yet on 26.1 or 26.2.x.

ScoreboardPL 1.7.0

New: Multiple scoreboards (profiles)

- Define any number of scoreboards under scoreboards: (e.g. lobby, survival, PvP, minigames), each with its own title, lines and optional animated title-frames - Players automatically see the profile that fits them, and it switches by itself when the situation changes - Conditions per profile: world (with * wildcards), gamemode, group, permission and placeholder comparisons (==, !=, >=, <=, >, <), plus any: (OR) and not: - Priorities: if several profiles match, the highest priority wins (ties: the one listed first) - `default-profile`: shown when no conditions match - Per-line conditions: show a line only when its condition is true, e.g. only when an economy plugin is present - Placeholders from PlaceholderAPI, Vault and LuckPerms also work inside conditions

Performance

- Conditions are compiled once on load, never re-parsed on updates - Profile switching is event-driven: join, world change, gamemode change and LuckPerms rank changes are detected instantly - Only placeholder-based conditions are re-checked periodically, configurable via the new settings.condition-check-interval-ticks (default: 40) - Switching a profile updates the player's existing scoreboard in place instead of recreating it

New commands & permissions

- /sb info shows your active profile, why it was chosen and which profiles currently match (scoreboardpl.info) - /sb set <profile|clear> [player] forces a profile for testing or events (scoreboardpl.set)

New placeholder & API

- %scoreboardpl_profile% returns the ID of the profile a player currently sees (built in and via PlaceholderAPI) - Other plugins (e.g. minigames) can use ScoreboardManager#setOverride and #clearOverride to force a profile

Changed

- This build targets Minecraft 1.21.4 and newer and requires Java 21 (api-version: 1.21) - The default config.yml now ships with example profiles and documentation for all condition types

Fixed

- %player_biome% no longer breaks on 1.21.3+, where Biome is no longer an enum - Improved thread safety on Folia: shared player data now uses concurrent collections and money formatting is thread-local

Updating from 1.6.x

- No config changes required. If your config has no scoreboards: section, your existing scoreboard: section is used automatically as the default profile - To use the new features, copy the scoreboards: section from the new default config.yml, or delete your old config and let the plugin generate a fresh one - Run /sb reload after editing the config

ScoreboardPL 1.6.0 – Minecraft 26.3 support

Added

- Support for Minecraft 26.3 on Paper, Purpur, Folia, Spigot and Bukkit.

[1.5.0] — Paper 26.1 / 26.2

Changed

- Plugin now targets Paper 26.1 and 26.2 specifically: compiled against paper-api 26.1.2–26.2, built with Java 25 - plugin.yml api-version raised to 26.1 - Bumped the shade plugin's bundled ASM to 9.8 so the shaded jar can correctly relocate Java 25 bytecode

Requirements

- Server must run Java 25 (required by Paper 26.1+)

Notes

- No feature/config changes — all placeholders, the PlaceholderAPI hook and the rainbow/gradient/hex effects from 1.4.0 are unchanged - Running an MC 1.21.x server? Stay on the 1.4.x release, which targets Java 21

[1.4.0]

Added

- Full PlaceholderAPI integration (soft-depend) — use any placeholder from any other plugin directly in your scoreboard lines and title - ScoreboardPL now exposes its own values to other plugins via PlaceholderAPI: %scoreboardpl_visible%, %scoreboardpl_toggle_status% - New text effects: RGB hex colors (&#RRGGBB), color gradients (<gradient:#..:#..>text</gradient>), and an animated rainbow (<rainbow>text</rainbow>) - Animated scoreboard titles — set title-frames to a list of lines to cycle through automatically, with configurable speed

Changed

- config.yml updated with documentation for the new placeholders and effects (fully backwards-compatible — existing configs keep working unchanged)

Notes

- All new features are opt-in. If you don't touch the new config options, your scoreboard behaves exactly as before.

Platform Support

- ScoreboardPL is now also available for Minecraft 1.21 – 1.21.11 (Paper, Spigot, Bukkit, Purpur, Folia), built against Java 21. - Same jar, same features as the 26.x release — nothing was removed or changed functionally.

Placeholders (unchanged from 1.3.1)

Includes all 8 placeholders added in this version: Player - %player_armor%, %player_direction%, %player_item_in_hand%, %player_biome%, %player_ping_color% Server - %server_uptime%, %server_ram_used%, %server_ram_max% All new placeholders are documented in config.yml but not added to the default layout — add them to scoreboard.lines yourself if you want to use them.

Notes

- No config migration needed, just drop in the new jar. - Requires Java 21 on this build (the 26.x build requires Java 25).

The plugin has been updated to versions 26.1 and 26.2.

Now the scoreboard doesn't flicker anymore when you use it with in-game money

There was just a small fix for the time zones and a few minor bug fixes.

Two small bugs were fixed in the new version 1.1.0 of the plugin.

v1.0.0 — Initial Release

Features

- Fully customizable scoreboard via config.yml - 25+ built-in placeholders across 5 categories - Live TPS display pulled directly from the server - Vault integration — balance (with/without decimals) and permission group - LuckPerms integration — group, prefix and suffix support - Real-time clock, date and day-of-week display with configurable timezone - Player stats — kills, deaths, blocks walked, playtime in hours - Player coordinates — X, Y, Z updated every tick cycle - Health and food level display - XP level and progress percentage - Current world and gamemode display - Player ping in milliseconds - Server online count and max slots - Minecraft server version display

Commands

- /scoreboard toggle — Toggle scoreboard on/off per player - /scoreboard reload — Live config reload without server restart - Aliases: /sb, /sboard

Config

- Fully commented config.yml explaining every placeholder - Instructions for adding, removing and reordering lines - Configurable update interval (in ticks) - Configurable timezone for time/date placeholders - Custom scoreboard title with color code support - Customizable plugin messages and prefix - Auto-creates config on first launch

Compatibility

- Compatible with Paper, Spigot, Purpur, Folia and CraftBukkit 1.21+ - Vault and LuckPerms as soft-dependencies (plugin works without them) - Built with Java 21 and Paper API 1.21