VScoreboard
适用于 Paper 和 Folia 服务器的现代、轻量且高度可配置的计分板插件。
VScoreboard 提供条件计分板、轮播页面、动画、MiniMessage 格式化、精灵(Sprites)、游戏内编辑器以及可选的占位符集成——全部包含在一个通用 JAR 文件中。
功能特性
- 多个优先级的计分板
- 条件性的计分板、页面和单行
- 计分板页面轮播
- 帧动画、滚动动画和打字机动画
- 平滑的动画 MiniMessage 渐变
- 可复用的进度条
- 原生计分板精灵
- 自定义或隐藏右侧分数值
- 持久化的玩家可见性
- 可选的计分板设计
- 带有实时预览的游戏内编辑器
- 自动配置迁移和备份
- 可选的 PlaceholderAPI 集成
- 可选的 MiniPlaceholders 集成
- 内置服务器和玩家占位符
- 支持 Paper 和 Folia 调度器
- 计分板接管保护
- 智能渲染与组件缓存
- 异步 Modrinth 更新检查器
- 公共 Bukkit 服务 API
- bStats 集成
支持版本
一个通用 JAR 文件支持:
- Minecraft 1.21 至 1.21.11
- Minecraft 26.1、26.1.1、26.1.2 和 26.2
- Paper
- Folia
- 基于 Paper 的分叉版,如 Purpur
Minecraft 1.21.x 需要 Java 21。
Minecraft 26.x 需要 Java 25。
游戏内编辑器
使用以下命令打开编辑器:
/vscoreboard editor
你可以使用它来:
- 创建和删除计分板
- 创建和删除页面
- 编辑计分板标题
- 添加、编辑和移除行
- 配置自定义分数值
- 显示或隐藏右侧数字
- 即时预览计分板和页面
破坏性操作需要确认。
每次更改在保存前都会经过验证。编辑器以原子方式写入文件,并自动保留带时间戳的备份。
整洁的配置布局
VScoreboard 保持其配置井然有序:
config.yml — 全局设置、兼容性和集成
scoreboards.yml — 计分板、页面和行
animations.yml — 动画和进度条
messages.yml — 面向玩家的提示信息
players.yml — 持久的玩家偏好设置
旧版配置会自动迁移。
自定义计分板、提示、动画、未知设置和玩家偏好都会被保留。每次迁移前都会创建带时间戳的备份。
示例计分板
scoreboards:
default:
title:
text: '{animation:title}'
refresh-ticks: 4
display-condition: 'true'
selectable: true
# false 隐藏所有右侧数字。
# true 显示经典的降序数字。
# 省略此设置则仅显示已配置的分数值。
score-numbers: false
pages:
player:
duration-seconds: 10
condition: 'true'
lines:
- '<dark_gray>----------------'
- '<gray>Player <dark_gray>» <white>%player_name%'
- text: '<gray>Health <dark_gray>» <white>%vscoreboard_health%/%vscoreboard_max_health%'
refresh-ticks: 10
- text: '<red>⚠ Your health is low!'
condition: '%vscoreboard_health%<8'
refresh-ticks: 10
- '<gray>World <dark_gray>» <white>%vscoreboard_world%'
- '<dark_gray>----------------'
server:
duration-seconds: 8
condition: 'true'
lines:
- '<dark_gray>----------------'
- text: '<gray>Online'
score: '<green>%vscoreboard_online%'
- text: '<gray>Ping <dark_gray>» %vscoreboard_ping_color%%vscoreboard_ping%ms'
refresh-ticks: 10
- '<gray>Time <dark_gray>» <white>%vscoreboard_time%'
- '<dark_gray>----------------'
简单的行可以保持为纯字符串。仅在需要使用条件、自定义分数值或单独刷新间隔时才需要扩展格式。
动画
使用以下语法在任何位置插入动画:
{animation:name}
支持的动画类型:
示例:
animations:
welcome:
type: scroll
interval-ticks: 2
text: 'Welcome to the server!'
style: '<aqua>'
width: 20
spacer: ' '
loading:
type: typewriter
interval-ticks: 3
text: 'Loading...'
style: '<green>'
pause-ticks: 20
可使用以下语法插入可复用的进度条:
{bar:name}
分数值
可以为每一行配置自定义右侧值:
- text: '<gray>Coins'
score: '<gold>%vault_eco_balance_formatted%'
也可以通过以下方式控制整个计分板的分数数字:
score-numbers: false
这将隐藏所有右侧数字,而不会删除已配置的值。
score-numbers: true
这将显示经典的降序数字。自定义行值将覆盖生成的数字。
省略此设置以仅显示明确配置的 score: 值。
条件
支持的比较运算符:
支持的逻辑运算:
&& 表示 AND(与)
|| 表示 OR(或)
! 表示 NOT(非)
- 括号用于分组
示例:
%vscoreboard_ping%>=160
%vscoreboard_health%<8
%luckperms_in_group_admin%==yes || %luckperms_in_group_mod%==yes
!(%vscoreboard_world%==disabled_world)
占位符
PlaceholderAPI 和 MiniPlaceholders 是可选的。
当未安装这两个插件时,VScoreboard 将继续使用其内置占位符正常工作。
内置占位符包括:
%vscoreboard_ping%
%vscoreboard_ping_color%
%vscoreboard_ping_bar%
%vscoreboard_tps%
%vscoreboard_tps_color%
%vscoreboard_tps_bar%
%vscoreboard_mspt%
%vscoreboard_health%
%vscoreboard_max_health%
%vscoreboard_online%
%vscoreboard_max_players%
%vscoreboard_time%
%vscoreboard_date%
%vscoreboard_world%
%vscoreboard_board%
%vscoreboard_page%
当安装了 MiniPlaceholders 时,MiniPlaceholders 标签会被解析为原生的 Adventure 组件。
计分板精灵
Sprites 使用 Adventure 的 MiniMessage 语法:
<sprite:blocks:block/diamond_block>
<sprite:"minecraft:gui":"heart/full">
Minecraft 1.21.9 及更高版本支持原生 Sprites。
旧版本会自动显示配置的备用(fallback)内容,使同一配置能在所有支持的版本中正常工作。
命令
| 命令 |
描述 |
权限 |
/vscoreboard toggle [player] |
切换记分板可见性 |
vortex.scoreboard.toggle |
/vscoreboard select <auto|board> |
选择已授权的记分板 |
vortex.scoreboard.use |
/vscoreboard list |
列出可用的记分板 |
vortex.scoreboard.use |
/vscoreboard editor [board] |
打开游戏内编辑器 |
vortex.scoreboard.editor |
/vscoreboard preview <board> [page] [player] |
预览记分板 |
vortex.scoreboard.admin |
/vscoreboard debug [player] |
检查选择条件和环境 |
vortex.scoreboard.admin |
/vscoreboard timings [reset] |
显示性能统计信息 |
vortex.scoreboard.admin |
/vscoreboard validate |
验证所有配置文件 |
vortex.scoreboard.admin |
/vscoreboard reload |
验证并重新加载插件 |
vortex.scoreboard.reload |
/vscoreboard update |
在 Modrinth 上检查更新 |
vortex.scoreboard.update |
/scoreboardtoggle |
旧版可见性命令 |
vortex.scoreboard.toggle |
/scoreboardreload |
旧版重载命令 |
vortex.scoreboard.reload |
别名包括 /vsb、/scoreboard、/sbtoggle 和 /togglescoreboard。
性能
VScoreboard 旨在避免不必要的记分板操作:
- 按玩家智能更新调度
- 缓存 Adventure 组件
- 缓存文本和条件结果
- 独立的刷新率
- 基于差异的数据包更新
- 跳过的未更改渲染周期
- 数据包失败后的限流恢复
- Folia 实体调度器支持
- 异步更新检查
可通过以下方式查看实时性能统计信息:
/vscoreboard timings
兼容性保护
当其他插件替换玩家的 Bukkit 记分板时,VScoreboard 会自动暂停其侧边栏。
一旦原始记分板恢复,VScoreboard 将在配置的延迟后继续运行。这有助于防止与小游戏、大厅系统及其他记分板插件发生冲突。
安装
- 下载通用的 VScoreboard JAR 文件。
- 将其放入服务器的
plugins 文件夹中。
- 启动或重启服务器。
- 编辑生成的配置文件或使用
/vscoreboard editor。
- 通过
/vscoreboard reload 应用手动更改。
可以安装 PlaceholderAPI 和 MiniPlaceholders 以获取额外的占位符,但非必需。
指标
VScoreboard 使用 bStats 收集匿名使用统计数据。
可以在 bStats 配置文件夹中全局禁用指标收集。
VScoreboard
A modern, lightweight and highly configurable scoreboard plugin for Paper and Folia servers.
VScoreboard provides conditional scoreboards, rotating pages, animations, MiniMessage formatting, sprites, an in-game editor and optional placeholder integrations — all inside one universal JAR.
Features
- Multiple prioritized scoreboards
- Conditional boards, pages and individual lines
- Rotating scoreboard pages
- Frame, scrolling and typewriter animations
- Smooth animated MiniMessage gradients
- Reusable progress bars
- Native scoreboard sprites
- Custom or hidden right-side score values
- Persistent per-player visibility
- Selectable scoreboard designs
- In-game editor with live previews
- Automatic configuration migration and backups
- Optional PlaceholderAPI integration
- Optional MiniPlaceholders integration
- Built-in server and player placeholders
- Paper and Folia scheduler support
- Scoreboard takeover protection
- Smart rendering and component caching
- Asynchronous Modrinth update checker
- Public Bukkit service API
- bStats integration
Supported Versions
One universal JAR supports:
- Minecraft 1.21 through 1.21.11
- Minecraft 26.1, 26.1.1, 26.1.2 and 26.2
- Paper
- Folia
- Paper-based forks such as Purpur
Java 21 is required for Minecraft 1.21.x.
Minecraft 26.x requires Java 25.
In-Game Editor
Open the editor with:
/vscoreboard editor
You can use it to:
- Create and delete scoreboards
- Create and delete pages
- Edit scoreboard titles
- Add, edit and remove lines
- Configure custom score values
- Show or hide right-side numbers
- Preview boards and pages instantly
Destructive actions require confirmation.
Every change is validated before saving. The editor writes files atomically and automatically retains timestamped backups.
Clean Configuration Layout
VScoreboard keeps its configuration organized:
config.yml — global settings, compatibility and integrations
scoreboards.yml — scoreboards, pages and lines
animations.yml — animations and progress bars
messages.yml — player-facing messages
players.yml — persistent player preferences
Older configurations are migrated automatically.
Custom boards, messages, animations, unknown settings and player preferences are preserved. A timestamped backup is created before every migration.
Example Scoreboard
scoreboards:
default:
title:
text: '{animation:title}'
refresh-ticks: 4
display-condition: 'true'
selectable: true
# false hides every right-side number.
# true shows classic descending numbers.
# Omit this setting to show only configured score values.
score-numbers: false
pages:
player:
duration-seconds: 10
condition: 'true'
lines:
- '<dark_gray>----------------'
- '<gray>Player <dark_gray>» <white>%player_name%'
- text: '<gray>Health <dark_gray>» <white>%vscoreboard_health%/%vscoreboard_max_health%'
refresh-ticks: 10
- text: '<red>⚠ Your health is low!'
condition: '%vscoreboard_health%<8'
refresh-ticks: 10
- '<gray>World <dark_gray>» <white>%vscoreboard_world%'
- '<dark_gray>----------------'
server:
duration-seconds: 8
condition: 'true'
lines:
- '<dark_gray>----------------'
- text: '<gray>Online'
score: '<green>%vscoreboard_online%'
- text: '<gray>Ping <dark_gray>» %vscoreboard_ping_color%%vscoreboard_ping%ms'
refresh-ticks: 10
- '<gray>Time <dark_gray>» <white>%vscoreboard_time%'
- '<dark_gray>----------------'
Simple lines can remain plain strings. The expanded format is only required when using conditions, custom score values or individual refresh intervals.
Animations
Insert animations anywhere using:
{animation:name}
Supported animation types:
Example:
animations:
welcome:
type: scroll
interval-ticks: 2
text: 'Welcome to the server!'
style: '<aqua>'
width: 20
spacer: ' '
loading:
type: typewriter
interval-ticks: 3
text: 'Loading...'
style: '<green>'
pause-ticks: 20
Reusable progress bars can be inserted with:
{bar:name}
Score Values
Custom right-side values can be configured per line:
- text: '<gray>Coins'
score: '<gold>%vault_eco_balance_formatted%'
Score numbers can also be controlled for an entire scoreboard:
score-numbers: false
This hides every right-side number without deleting configured values.
score-numbers: true
This shows classic descending numbers. Custom line values override generated numbers.
Omit the setting to display only explicitly configured score: values.
Conditions
Supported comparison operators:
Supported logic:
&& for AND
|| for OR
! for NOT
- Parentheses for grouping
Examples:
%vscoreboard_ping%>=160
%vscoreboard_health%<8
%luckperms_in_group_admin%==yes || %luckperms_in_group_mod%==yes
!(%vscoreboard_world%==disabled_world)
Placeholders
PlaceholderAPI and MiniPlaceholders are optional.
VScoreboard continues working with its built-in placeholders when neither plugin is installed.
Built-in placeholders include:
%vscoreboard_ping%
%vscoreboard_ping_color%
%vscoreboard_ping_bar%
%vscoreboard_tps%
%vscoreboard_tps_color%
%vscoreboard_tps_bar%
%vscoreboard_mspt%
%vscoreboard_health%
%vscoreboard_max_health%
%vscoreboard_online%
%vscoreboard_max_players%
%vscoreboard_time%
%vscoreboard_date%
%vscoreboard_world%
%vscoreboard_board%
%vscoreboard_page%
MiniPlaceholders tags are resolved as native Adventure components when MiniPlaceholders is installed.
Scoreboard Sprites
Sprites use Adventure's MiniMessage syntax:
<sprite:blocks:block/diamond_block>
<sprite:"minecraft:gui":"heart/full">
Native sprites are supported on Minecraft 1.21.9 and newer.
Older versions automatically display the configured fallback, allowing the same configuration to work across every supported version.
Commands
| Command |
Description |
Permission |
/vscoreboard toggle [player] |
Toggle scoreboard visibility |
vortex.scoreboard.toggle |
/vscoreboard select <auto|board> |
Select a permitted scoreboard |
vortex.scoreboard.use |
/vscoreboard list |
List available scoreboards |
vortex.scoreboard.use |
/vscoreboard editor [board] |
Open the in-game editor |
vortex.scoreboard.editor |
/vscoreboard preview <board> [page] [player] |
Preview a scoreboard |
vortex.scoreboard.admin |
/vscoreboard debug [player] |
Inspect selection and conditions |
vortex.scoreboard.admin |
/vscoreboard timings [reset] |
Display performance statistics |
vortex.scoreboard.admin |
/vscoreboard validate |
Validate all configuration files |
vortex.scoreboard.admin |
/vscoreboard reload |
Validate and reload the plugin |
vortex.scoreboard.reload |
/vscoreboard update |
Check Modrinth for updates |
vortex.scoreboard.update |
/scoreboardtoggle |
Legacy visibility command |
vortex.scoreboard.toggle |
/scoreboardreload |
Legacy reload command |
vortex.scoreboard.reload |
Aliases include /vsb, /scoreboard, /sbtoggle and /togglescoreboard.
Performance
VScoreboard is designed to avoid unnecessary scoreboard work:
- Per-player smart update scheduling
- Cached Adventure components
- Cached text and condition results
- Independent refresh rates
- Diff-based packet updates
- Unchanged render cycles are skipped
- Rate-limited recovery after packet failures
- Folia entity scheduler support
- Asynchronous update checks
Live performance statistics are available through:
/vscoreboard timings
Compatibility Protection
VScoreboard automatically pauses its sidebar when another plugin replaces a player's Bukkit scoreboard.
Once the original scoreboard returns, VScoreboard resumes after the configured delay. This helps prevent conflicts with minigames, lobby systems and other scoreboard plugins.
Installation
- Download the universal VScoreboard JAR.
- Place it inside your server's
plugins folder.
- Start or restart the server.
- Edit the generated configuration files or use
/vscoreboard editor.
- Apply manual changes with
/vscoreboard reload.
PlaceholderAPI and MiniPlaceholders may be installed for additional placeholders but are not required.
Metrics
VScoreboard uses bStats to collect anonymous usage statistics.
Metrics can be disabled globally inside the bStats configuration folder.
评论 0
登录后参与评分
还没有评论,来抢沙发吧