
ScoreboardPL
ScoreboardPL 是一款轻量级、完全可自定义的计分板插件,适用于 Paper、Folia、Purpur 和 Spigot。直接放入服务器,编辑一份文档完善的 config.yml,即可搞定。无需数据库,无需复杂设置。
为大厅、生存、PVP 和小游戏构建不同的计分板,让 ScoreboardPL 自动为每位玩家选择正确的计分板,并使用 35+ 个占位符、PlaceholderAPI、十六进制颜色、渐变、彩虹文字和动画标题进行样式设计。
✅ 亮点
- ? 多个计分板:支持按世界、游戏模式、排名、权限或任意占位符自动切换
- ? 优先级与回退机制:如果多个计分板匹配,优先级最高的获胜;如果没有匹配的,则显示默认计分板
- ? 逐行条件判断:仅在有意义时显示某一行(例如,仅在有经济插件时显示)
- ? 平滑切换:玩家的计分板就地更新,不会被销毁重建
- ⚡ 低性能开销:条件仅在配置加载时编译一次,并在事件触发时重新检查,而非每 tick 都检查
- ? 特效支持:RGB 十六进制颜色、渐变、动态彩虹效果和动画标题
- ? 35+ 个内置占位符以及任意 PlaceholderAPI 占位符
- ? 兼容 Folia:支持区域线程安全调度
- ? 广泛的版本支持:Minecraft 1.20.x、1.21.x 以及 26.1 – 26.3
- ? 所有内容均位于一个带注释的
config.yml 中,支持实时 /sb reload
? 多计分板
定义任意数量的计分板(称为 profile / 配置文件)。每个玩家会自动看到适合其当前情况的计分板,并在情况变化时自动切换:进入另一个世界、切换游戏模式或获得新排名。
scoreboards:
default-profile: default # 当没有其他匹配项时显示
lobby:
priority: 10 # 数字越大优先级越高
conditions:
world: [lobby, hub]
title: "&b&lMY SERVER"
lines:
- " &7欢迎, &f%player_name%&7!"
- " &7排名&8: &6%luckperms_group%"
- " &7在线&8: &a%server_online%"
survival:
priority: 10
conditions:
world: [world, world_nether, world_the_end]
title: "&a&lSURVIVAL"
lines:
- " &7你的统计数据"
- text: " &7金钱&8: &a$%vault_balance_int%"
condition: "%vault_balance_int% != N/A" # 仅当有值时才显示该行
- " &7击杀&8: &f%player_kills%"
pvp:
priority: 20 # 如果同时匹配大厅/生存,此选项优先级更高
conditions:
world: [pvp]
gamemode: [SURVIVAL]
title: "&c&lPVP"
lines:
- " &7击杀&8: &c%player_kills%"
- " &7延迟&8: %player_ping_color%"
如何选择计分板
- 手动覆盖(通过
/sb set 命令或其他插件的 API)
- 否则,选择满足所有条件的最高优先级配置文件(若优先级相同,则配置文件中排在前面的获胜)
- 否则使用
default-profile(默认配置文件)
没有 conditions(条件)的配置文件永远不会被自动选择。它仅用作默认值或手动覆盖。
条件判断
| 条件 |
含义 |
world: [lobby, bedwars_*] |
匹配这些世界中的任意一个(* 是通配符,非常适合动态小游戏世界) |
gamemode: [SURVIVAL] |
匹配这些游戏模式中的任意一个 |
group: [admin, mod] |
匹配这些群组中的任意一个(LuckPerms 或 Vault) |
permission: [my.node] |
匹配这些权限中的任意一个 |
placeholder: "%player_level% >= 10" |
比较任意占位符,支持 == != >= <= > < |
any: |
OR:列出的条目中至少有一个匹配即可 |
not: |
否定嵌套的条件 |
conditions: 内的所有条目都必须为真。行条件使用简写形式,如 "world:survival"、"permission:my.node" 或 "%player_level% >= 10",前导 ! 表示否定。
专为性能打造
- 条件在配置加载时解析一次,每次更新时不再重复解析
- 世界、游戏模式和 LuckPerms 排名的变化通过事件即时捕获,无需轮询
- 仅基于占位符的条件会定期重新检查,且间隔时间可配置(
condition-check-interval-ticks)
- 仅当所选配置文件实际发生变化时,才会重绘计分板
⌨️ 命令与权限
| 命令 |
别名 |
权限 |
描述 |
/scoreboard toggle |
/sb toggle |
scoreboardpl.toggle (所有人) |
开启或关闭你的计分板 |
/scoreboard reload |
/sb reload |
scoreboardpl.reload (OP) |
实时重载配置 |
/scoreboard info |
/sb info |
scoreboardpl.info (OP) |
显示你当前的活动配置文件、选择原因及匹配的条件 |
/scoreboard set <profile|clear> [player] |
/sb set |
scoreboardpl.set (OP) |
强制为玩家设置某个配置文件,或清除覆盖 |
? 占位符 (35+)
?️ 服务器
| 占位符 |
描述 |
%server_name% |
你的服务器名称(在配置文件中设置) |
%server_online% |
当前在线玩家数量 |
%server_max_players% |
最大玩家槽位数 |
%server_tps% |
实时服务器 TPS(最高 20.0) |
%server_version% |
服务器 Minecraft 版本 |
%server_uptime% |
自上次启动以来的服务器运行时间(例如:“2h 14m”) |
%server_ram_used% |
当前使用的 RAM,单位为 MB |
%server_ram_max% |
分配的最大 RAM,单位为 MB |
? 玩家
| 占位符 |
描述 |
%player_name% |
玩家的用户名 |
%player_displayname% |
玩家的显示名称 |
%player_health% |
当前生命值(例如 18.0) |
%player_max_health% |
最大生命值(例如 20.0) |
%player_food% |
饥饿值(0–20) |
%player_level% |
经验等级 |
%player_exp% |
经验进度百分比 |
%player_ping% |
连接延迟,单位为毫秒 |
%player_ping_color% |
延迟颜色,自动根据情况着色为绿色/黄色/红色 |
%player_world% |
当前世界名称 |
%player_gamemode% |
当前游戏模式 |
%player_x% %player_y% %player_z% |
坐标 |
%player_deaths% |
总死亡次数 |
%player_kills% |
总击杀数 |
%player_blocks_walked% |
行走过的总方块数,单位为米 |
%player_playtime_hours% |
总游戏时长,单位为小时 |
%player_armor% |
护甲点数(0–20) |
%player_direction% |
玩家面朝的罗盘方向 |
%player_item_in_hand% |
主手当前持有的物品 |
%player_biome% |
玩家当前所在的生物群系 |
? 日期与时间
| 占位符 |
描述 |
%time% |
当前服务器时间(HH:mm:ss) |
%date% |
当前日期(dd.MM.yyyy) |
%day% |
当前星期几 |
? Vault (需要安装 Vault 和经济类插件)
| 占位符 |
描述 |
%vault_balance% |
玩家余额,包含小数位(1,234.50) |
%vault_balance_int% |
玩家余额,不包含小数位(1,234) |
%vault_rank% |
通过 Vault 获取的主要权限组 |
? LuckPerms (需要安装 LuckPerms)
| 占位符 |
描述 |
%luckperms_group% |
玩家的主要 LuckPerms 组 |
%luckperms_prefix% |
玩家的 LuckPerms 前缀 |
%luckperms_suffix% |
玩家的 LuckPerms 后缀 |
? ScoreboardPL
| 占位符 |
描述 |
%scoreboardpl_profile% |
玩家当前查看的面板配置文件 ID |
? PlaceholderAPI 支持
PlaceholderAPI 完全是可选的,且无需任何额外配置:
- 在你的行、标题和条件中,可以使用 来自任何其他插件的任意占位符(Essentials、Jobs、mcMMO 等),紧邻 ScoreboardPL 自带的占位符使用。
- 未安装 PlaceholderAPI?一切照常运行,只是无法使用额外的占位符。
- ScoreboardPL 还会向其他插件发布其自身的数值(聊天、Tab 列表、加入消息等):
| 占位符 |
值 |
%scoreboardpl_visible% |
yes / no |
%scoreboardpl_toggle_status% |
enabled / disabled |
%scoreboardpl_profile% |
活动配置文件 ID |
✨ 特效
为你的计分板增添风采,无需资源包或额外插件:
| 标签 |
效果 |
&#RRGGBB |
单个真实的 RGB 十六进制颜色 |
<gradient:#00c6ff:#0072ff>Text</gradient> |
文本上的平滑颜色渐变 |
<rainbow>Text</rainbow> |
动态移动的彩虹效果 |
你还可以对 标题 本身进行动画处理:为 title-frames 提供一个行列表,ScoreboardPL 会自动循环播放,速度可配置。每个配置文件都可以拥有自己的动画标题。所有功能均为可选,旧的纯 & 颜色代码依然完全正常运作。
⚙️ 配置功能
- 每个计分板拥有独立的 标题和布局,支持颜色代码和特效
- 自由添加、移除和重排行(最多 15 行),并使用
"" 创建 空间隔行
- 更新间隔,以刻为单位(默认:每秒一次)
- 时区,用于准确显示时间
- 可自定义的 插件消息,包括前缀
- 内联注释,解释每个选项
- 旧配置文件保持兼容:如果你没有
scoreboards: 部分,现有的 scoreboard: 部分将自动用作默认配置文件
? 安装
- 下载与你的 Minecraft 版本匹配的文件(见下方的 兼容性),并将其放入
plugins 文件夹。
- 重启服务器。
- 编辑
plugins/ScoreboardPL/config.yml 并运行 /sb reload。
Vault、LuckPerms 和 PlaceholderAPI 均为 可选。ScoreboardPL 会自动检测它们。
?️ 兼容性
ScoreboardPL 为每个 Minecraft 世代提供单独的构建。请下载与你的服务器版本匹配的文件(见 Versions 选项卡):
| Minecraft |
插件版本 |
Java |
| 1.20.x |
1.7.4 |
17 或更高 |
| 1.21.x |
1.7.0 |
21 |
| 26.1.x |
1.7.3 |
25 |
| 26.2 |
1.7.2 |
25 |
| 26.3 |
1.7.1 |
25 |
| 服务器软件 |
支持 |
| Paper |
✅ |
| Folia |
✅ |
| Purpur |
✅ |
| Spigot |
✅ |
| CraftBukkit |
✅ |
? 支持
有问题、发现 Bug 或有功能建议?请加入 Discord。如果你喜欢 ScoreboardPL,你可以在 Ko-fi 或 PayPal 上支持其开发。谢谢!❤️

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
- Manual override (
/sb set or the API from another plugin)
- Otherwise the highest priority profile whose conditions are all met (on a tie, the one listed first in the config wins)
- Otherwise the
default-profile
A profile without conditions is never picked automatically. It is only used as the default or as an override.
Conditions
| Condition |
Meaning |
world: [lobby, bedwars_*] |
any of these worlds (* is a wildcard, great for dynamic minigame worlds) |
gamemode: [SURVIVAL] |
any of these gamemodes |
group: [admin, mod] |
any of these groups (LuckPerms or Vault) |
permission: [my.node] |
any of these permissions |
placeholder: "%player_level% >= 10" |
compare any placeholder, with == != >= <= > < |
any: |
OR: at least one of the listed entries must match |
not: |
negates the nested condition |
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
| Command |
Alias |
Permission |
Description |
/scoreboard toggle |
/sb toggle |
scoreboardpl.toggle (everyone) |
Toggle your scoreboard on or off |
/scoreboard reload |
/sb reload |
scoreboardpl.reload (OP) |
Reload the config live |
/scoreboard info |
/sb info |
scoreboardpl.info (OP) |
Show your active profile, why it was chosen and which conditions match |
/scoreboard set <profile|clear> [player] |
/sb set |
scoreboardpl.set (OP) |
Force a profile for a player, or clear the override |
? Placeholders (35+)
?️ Server
| Placeholder |
Description |
%server_name% |
Your server name (set in config) |
%server_online% |
Number of currently online players |
%server_max_players% |
Maximum player slots |
%server_tps% |
Live server TPS (max 20.0) |
%server_version% |
Server Minecraft version |
%server_uptime% |
Server uptime since last start (e.g. "2h 14m") |
%server_ram_used% |
RAM currently in use, in MB |
%server_ram_max% |
Maximum RAM allocated, in MB |
? Player
| Placeholder |
Description |
%player_name% |
Player's username |
%player_displayname% |
Player's display name |
%player_health% |
Current health (e.g. 18.0) |
%player_max_health% |
Maximum health (e.g. 20.0) |
%player_food% |
Food level (0–20) |
%player_level% |
XP level |
%player_exp% |
XP progress percentage |
%player_ping% |
Connection ping in ms |
%player_ping_color% |
Ping, automatically colored green/yellow/red |
%player_world% |
Current world name |
%player_gamemode% |
Current gamemode |
%player_x% %player_y% %player_z% |
Coordinates |
%player_deaths% |
Total death count |
%player_kills% |
Total player kills |
%player_blocks_walked% |
Total blocks walked in meters |
%player_playtime_hours% |
Total playtime in hours |
%player_armor% |
Armor points (0–20) |
%player_direction% |
Compass direction the player is facing |
%player_item_in_hand% |
Item currently held in the main hand |
%player_biome% |
Biome the player is currently standing in |
? Date & Time
| Placeholder |
Description |
%time% |
Current server time (HH:mm:ss) |
%date% |
Current date (dd.MM.yyyy) |
%day% |
Current day of the week |
? Vault (requires Vault + an economy plugin)
| Placeholder |
Description |
%vault_balance% |
Player balance with decimals (1,234.50) |
%vault_balance_int% |
Player balance without decimals (1,234) |
%vault_rank% |
Primary permission group via Vault |
? LuckPerms (requires LuckPerms)
| Placeholder |
Description |
%luckperms_group% |
Player's primary LuckPerms group |
%luckperms_prefix% |
Player's LuckPerms prefix |
%luckperms_suffix% |
Player's LuckPerms suffix |
? ScoreboardPL
| Placeholder |
Description |
%scoreboardpl_profile% |
ID of the scoreboard the player currently sees |
? 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, ...):
| Placeholder |
Value |
%scoreboardpl_visible% |
yes / no |
%scoreboardpl_toggle_status% |
enabled / disabled |
%scoreboardpl_profile% |
active profile ID |
✨ Effects
Give your scoreboard some flair, without a resource pack or an extra plugin:
| Tag |
Effect |
&#RRGGBB |
A single true RGB hex color |
<gradient:#00c6ff:#0072ff>Text</gradient> |
A smooth color gradient across the text |
<rainbow>Text</rainbow> |
An animated, moving rainbow |
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
- Download the file that matches your Minecraft version (see Compatibility below) and drop it into your
plugins folder.
- Restart the server.
- 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):
| Minecraft |
Plugin version |
Java |
| 1.20.x |
1.7.4 |
17 or newer |
| 1.21.x |
1.7.0 |
21 |
| 26.1.x |
1.7.3 |
25 |
| 26.2 |
1.7.2 |
25 |
| 26.3 |
1.7.1 |
25 |
| Server Software |
Supported |
| Paper |
✅ |
| Folia |
✅ |
| Purpur |
✅ |
| Spigot |
✅ |
| CraftBukkit |
✅ |
? 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! ❤️
评论 0
登录后参与评分
还没有评论,来抢沙发吧