vScoreboard

插件

· 作者 Primeli

一个轻量且可配置的 Paper 计分板插件,支持 PlaceholderAPI、MiniMessage,具备多种条件计分板、持久化的 /scoreboardtoggle 命令以及 bStats 集成。

0 本站下载 0 关注 更新于 3 个月前

最新 1.2.0 · 26.2 · Folia / Paper

一键开服(送7天)

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}

支持的动画类型:

  • frames
  • scroll
  • typewriter

示例:

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 将在配置的延迟后继续运行。这有助于防止与小游戏、大厅系统及其他记分板插件发生冲突。

安装

  1. 下载通用的 VScoreboard JAR 文件。
  2. 将其放入服务器的 plugins 文件夹中。
  3. 启动或重启服务器。
  4. 编辑生成的配置文件或使用 /vscoreboard editor。
  5. 通过 /vscoreboard reload 应用手动更改。

可以安装 PlaceholderAPI 和 MiniPlaceholders 以获取额外的占位符,但非必需。

指标

VScoreboard 使用 bStats 收集匿名使用统计数据。

可以在 bStats 配置文件夹中全局禁用指标收集。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源