RealScoreboard
轻量高效的计分板管理器。
支持动画、按世界划分的计分板,包含占位符、条件判断和 HEX 颜色。
Discord | 源代码 | 报告错误
RealScoreboard 是什么?
RealScoreboard 会为玩家的侧边栏显示计分板。你在 scoreboards.yml 中编写计分板内容:包括动画标题、带有占位符的行、适用的世界以及可见权限。一个计分板还可以由多个面板组成并循环切换。玩家可以开启或关闭自己的计分板,该选择会被保存。
功能特性
- 无闪烁,基于 FastBoard 构建,行数据异步刷新
- 在 1.20.3+ 版本中,右侧不会出现红色数字
- 动画标题,以及在多个面板间循环切换的计分板
- 按世界划分的计分板,每个世界可设置一个默认计分板,并可指定隐藏该计分板的世界列表
- 权限计分板:为计分板分配权限,拥有该权限的玩家将看到此计分板而非默认计分板
- 内置占位符,同时支持所有 PlaceholderAPI 占位符
- 条件判断:根据某个占位符的值显示不同的文本
- HEX 颜色与渐变
- 公告功能:向所有玩家显示一条持续数秒的公告式计分板消息
- 隐身时隐藏计分板,基于指定的隐身命令列表进行检测
- mcMMO 支持:当 mcMMO 计分板显示时,本模组会暂时退让(需在
config.yml 中启用 mcMMO-Support)
- 游戏内设置菜单;在 1.21.6+ 版本中使用原生对话框
- 使用 SQLite 和 MySQL 存储每个玩家的开关状态
- 集成 RealPermissions 并提供开发者 API
- 完全可配置的 YAML 文件
计分板配置
scoreboards.yml 中的每个计分板都包含以下属性:
| 键名 |
作用 |
Default |
是否为默认计分板:当没有应用任何权限计分板时,玩家在该世界中看到的计分板 |
Default-World, Other-Worlds |
显示范围;在 Other-Worlds 中使用 '*' 表示所有世界 |
Permission |
查看该计分板所需的权限,设为 none 则无需权限 |
Display-Name |
在菜单中显示的名称 |
Refresh |
行数据更新、标题帧切换以及面板轮换的频率(以刻为单位) |
Title, Lines |
标题帧和行内容;或者是一个 Boards 部分,包含多个面板,每个面板拥有各自的标题和行内容 |
Title 列表中的每一行代表一个动画帧。
记分板示例
计分板:
default:
默认: true
默认世界: world
其他世界:
- '*'
显示名称: '&fDefault Board'
权限: none
刷新:
计分板: 5
标题: 10
标题循环延迟: 5
计分板循环延迟: 30
计分板列表:
Board1:
标题:
- '&bRealScoreBoard'
- '&6> &9RealScoreBoard &6<'
行:
- '%blank%'
- ' &7名称: &f%playername% &8| &f%ping%'
- ' &7金钱: &f%money% &8| &7经验值: &f%xp%'
- '%blank%'
Board2:
标题:
- '&b统计 &a面板'
行:
- '%blank%'
- ' &f击杀: %kills% &7| &f击杀死亡比: %kd%'
- '%blank%'
</details>
## 条件
条件会在其为真时显示一段文本,在其为假时显示另一段文本。请在 `config.yml` 中定义它,并在行中使用 `%cond:<名称>%`,例如 `%cond:low_hp%`。
条件由 *值 运算符 值* 组成,各部分之间以空格分隔。占位符会优先被填充,随后这些值会被作为整数、小数、布尔值或文本来进行比较。
| 值类型 | 运算符 |
|---|---|
| 数字 | `==` `!=` `>` `<` `>=` `<=` |
| 文本 | `==` `!=` `contains` `startsWith` `endsWith` |
在 `Met` 或 `Not-Met` 文本中放入 `$skip` 可隐藏整行。
<details>
<summary><b>示例条件</b></summary>
```yaml
Conditions:
xp:
Condition: '%xp% > 3'
Met: '%aXP is bigger than 3!'
Not-Met: '&cYou need to get 3 XP!'
low_hp:
Condition: '%life% <= 5'
Met: '&cWatch out!'
Not-Met: '&aYou are fine!'
HEX 颜色
- 单色:
{#69ffde}
- 渐变:
{#ffffff>}Gradient!{#00aeff<}
你可以在 rgb.birdflop.com 制作渐变色。
截图



快速上手
- 安装插件并加入服务器。你将看到默认记分板。
- 编辑
plugins/RealScoreboard/scoreboards.yml 以更改标题和行内容,或添加更多记分板。
- 将
Default-World 设置为主世界,并为每个世界分配一个默认记分板。
- 对于权限记分板,设置其
Permission(例如 realscoreboard.testboard),并将该权限赋予相应权限组。
- 运行
/rsb reload。
- 运行
/rsb 打开设置菜单,用于配置剩余的 config.yml 选项。
命令
基础命令:/realscoreboard、/rsb、/sb
| 命令 |
描述 |
权限 |
/rsb |
为管理员打开设置菜单;向其他所有人显示插件信息 |
realscoreboard.admin(用于菜单) |
/rsb toggle (t) |
开启或关闭你自己的记分板 |
realscoreboard.toggle |
/rsb on, /rsb off |
开启或关闭你自己的记分板 |
realscoreboard.toggle |
/rsb reload |
重新加载配置和记分板 |
realscoreboard.admin |
/rsb toggleother <player> (toggleo, to) |
开启或关闭其他玩家的记分板 |
realscoreboard.admin |
/rsb setscoreboard <name> <player|@a> (setsb) |
设置玩家的记分板;@a 为所有玩家设置 |
realscoreboard.setscoreboard |
/rsb selectscoreboard <player> (selectsb) |
为该玩家打开一个选择记分板的菜单 |
realscoreboard.selectscoreboard |
/rsb announce <seconds> <message> (broadcast) |
将消息作为记分板向所有玩家显示指定秒数 |
realscoreboard.setscoreboard |
/rsb hooks |
列出通过 RealScoreboard 推送自己记分板的插件 |
realscoreboard.admin |
/rsb debug |
向开发者共享插件、服务器和配置信息 |
realscoreboard.admin |
权限
| 权限 |
描述 |
realscoreboard.admin |
设置菜单、重载、切换他人、挂钩和调试 |
realscoreboard.toggle |
/rsb toggle、on 和 off |
realscoreboard.setscoreboard |
/rsb setscoreboard 和 /rsb announce |
realscoreboard.selectscoreboard |
/rsb selectscoreboard |
每个记分板的 Permission |
查看该记分板 |
占位符
这些占位符可在记分板行中使用。任何 PlaceholderAPI 占位符也可用。仅当 Use-Placeholders-In-Scoreboard-Titles 开启时,标题才使用占位符。
所有占位符
| 占位符 |
值 |
%blank% |
空行 |
%cond:<name>% |
条件结果 |
%rainbow% |
循环彩虹色的颜色代码 |
%playername%, %displayname% |
玩家名称和显示名称 |
%ping% |
延迟(毫秒) |
%life% |
生命值 |
%lifeheart% |
根据生命值着色的心形图标 |
%playerfood% |
饥饿值等级 |
%xp% |
总经验值 |
%money%, %moneylong% |
余额,简短格式(如 1.5k)和完整格式(需要 Vault) |
%group%, %prefix%, %suffix% |
主组及其前缀和后缀(需要 Vault) |
%kills%, %deaths%, %kd%, %mobkills%, %jumps% |
统计数据 |
%playtime% |
游戏时间 |
%x%, %y%, %z%, %loc% |
位置坐标 |
%yaw%, %pitch% |
玩家朝向 |
%world% |
世界名称 |
%worlddays% |
在世界中经过的天数 |
%time%, %day% |
当前时间和日期(格式和偏移量在 config.yml 中配置) |
%online%, %maxplayers% |
在线人数和最大玩家数 |
%ram% |
内存使用情况 |
%serverip%, %port% |
服务器 IP 和端口 |
%version% |
服务器版本 |
要求
安装
- 将 jar 文件放入
plugins 文件夹。
- 重启服务器。
- 编辑
plugins/RealScoreboard/scoreboards.yml 和 config.yml,然后运行 /rsb reload。
- 要使用 MySQL,请在
plugins/RealScoreboard/sql.yml 中设置驱动程序和登录信息,然后重启。
需要帮助或发现了 Bug?
请不要在评论区提交 Bug 报告。请通过以下方式联系:
Discord | GitHub Issues
此插件使用 bStats 收集匿名使用统计信息。你可以在 plugins/bStats/config.yml 中关闭此功能。
RealScoreboard
Lightweight and efficient scoreboard manager.
Animated, per-world scoreboards with placeholders, conditions and HEX colours.
Discord | Source Code | Report a Bug
What is RealScoreboard?
RealScoreboard shows a sidebar scoreboard to your players. You write the scoreboards in scoreboards.yml: an animated title, lines with placeholders, the worlds they appear in and who can see them. A scoreboard can also have several boards that it cycles through. Players can turn their scoreboard on and off, and the choice is saved.
Features
- No flicker, built on FastBoard, with lines refreshed asynchronously
- No red numbers on the right side on 1.20.3+
- Animated titles, and scoreboards that cycle between several boards
- Per-world scoreboards, with a default scoreboard per world and a list of worlds where the scoreboard is hidden
- Permission scoreboards: give a scoreboard a permission and players who have it see that one instead of the default
- Built-in placeholders, plus every PlaceholderAPI placeholder
- Conditions: show one text or another depending on a placeholder's value
- HEX colours and gradients
- Announcements: show a message as a scoreboard to every player for a few seconds
- Hides the scoreboard while vanished, based on a list of vanish commands
- mcMMO support: steps aside while an mcMMO scoreboard is shown (turn on
mcMMO-Support in config.yml)
- Settings menu in game; on 1.21.6+ it uses native dialogs
- SQLite and MySQL storage for each player's on/off choice
- RealPermissions integration and a developer API
- Fully configurable YAML files
Scoreboards
Every scoreboard in scoreboards.yml has:
| Key |
What it does |
Default |
Whether it's the scoreboard players get in its world when no permission scoreboard applies |
Default-World, Other-Worlds |
Where it shows; use '*' in Other-Worlds for every world |
Permission |
The permission needed to see it, or none |
Display-Name |
The name shown in menus |
Refresh |
How often (in ticks) the lines update, the title changes frame, and the boards switch |
Title, Lines |
The title frames and the lines, or a Boards section with several boards, each with its own title and lines |
Each line of the Title list is one animation frame.
Example scoreboard
Scoreboards:
default:
Default: true
Default-World: world
Other-Worlds:
- '*'
Display-Name: '&fDefault Board'
Permission: none
Refresh:
Scoreboard: 5
Title: 10
Title-Loop-Delay: 5
Board-Loop-Delay: 30
Boards:
Board1:
Title:
- '&bRealScoreBoard'
- '&6> &9RealScoreBoard &6<'
Lines:
- '%blank%'
- ' &7Name: &f%playername% &8| &f%ping%'
- ' &7Money: &f%money% &8| &7XP: &f%xp%'
- '%blank%'
Board2:
Title:
- '&bStatistics &aBoard'
Lines:
- '%blank%'
- ' &fKills: %kills% &7| &fKD: %kd%'
- '%blank%'
Conditions
A condition shows one text when it's true and another when it's false. Define it in config.yml and put %cond:<name>% on a line, e.g. %cond:low_hp%.
A condition is value operator value, separated by spaces. Placeholders are filled in first, then the values are compared as whole numbers, decimals, booleans or text.
| Values |
Operators |
| Numbers |
== != > < >= <= |
| Text |
== != contains startsWith endsWith |
Put $skip in the Met or Not-Met text to hide the whole line.
Example conditions
Conditions:
xp:
Condition: '%xp% > 3'
Met: '%aXP is bigger than 3!'
Not-Met: '&cYou need to get 3 XP!'
low_hp:
Condition: '%life% <= 5'
Met: '&cWatch out!'
Not-Met: '&aYou are fine!'
HEX Colours
- Single colour:
{#69ffde}
- Gradient:
{#ffffff>}Gradient!{#00aeff<}
You can make gradients at rgb.birdflop.com.
Photos



Getting Started
- Install the plugin and join. You'll see the default scoreboard.
- Edit
plugins/RealScoreboard/scoreboards.yml to change the title and lines, or add more scoreboards.
- Set
Default-World to your main world, and give each world a default scoreboard.
- For a rank scoreboard, set its
Permission (e.g. realscoreboard.testboard) and give that permission to the rank.
- Run
/rsb reload.
- Run
/rsb to open the settings menu for the rest of config.yml.
Commands
Base commands: /realscoreboard, /rsb, /sb
| Command |
Description |
Permission |
/rsb |
Opens the settings menu for admins; shows the plugin info to everyone else |
realscoreboard.admin for the menu |
/rsb toggle (t) |
Turns your scoreboard on or off |
realscoreboard.toggle |
/rsb on, /rsb off |
Turns your scoreboard on or off |
realscoreboard.toggle |
/rsb reload |
Reloads the config and scoreboards |
realscoreboard.admin |
/rsb toggleother <player> (toggleo, to) |
Turns another player's scoreboard on or off |
realscoreboard.admin |
/rsb setscoreboard <name> <player|@a> (setsb) |
Sets a player's scoreboard; @a sets it for everyone |
realscoreboard.setscoreboard |
/rsb selectscoreboard <player> (selectsb) |
Opens a menu for that player to pick a scoreboard |
realscoreboard.selectscoreboard |
/rsb announce <seconds> <message> (broadcast) |
Shows a message as a scoreboard to every player for that many seconds |
realscoreboard.setscoreboard |
/rsb hooks |
Lists the plugins that push their own boards through RealScoreboard |
realscoreboard.admin |
/rsb debug |
Shows plugin, server and config info to share with the developer |
realscoreboard.admin |
Permissions
| Permission |
Description |
realscoreboard.admin |
Settings menu, reload, toggleother, hooks and debug |
realscoreboard.toggle |
/rsb toggle, on and off |
realscoreboard.setscoreboard |
/rsb setscoreboard and /rsb announce |
realscoreboard.selectscoreboard |
/rsb selectscoreboard |
Each scoreboard's Permission |
Sees that scoreboard |
Placeholders
These work in scoreboard lines. Any PlaceholderAPI placeholder works too. Titles use placeholders only when Use-Placeholders-In-Scoreboard-Titles is on.
All placeholders
| Placeholder |
Value |
%blank% |
An empty line |
%cond:<name>% |
The result of a condition |
%rainbow% |
A colour code that cycles through the rainbow |
%playername%, %displayname% |
The player's name and display name |
%ping% |
Ping in ms |
%life% |
Health |
%lifeheart% |
A heart coloured by health |
%playerfood% |
Food level |
%xp% |
Total experience |
%money%, %moneylong% |
Balance, short (e.g. 1.5k) and in full (needs Vault) |
%group%, %prefix%, %suffix% |
Primary group and its prefix and suffix (needs Vault) |
%kills%, %deaths%, %kd%, %mobkills%, %jumps% |
Statistics |
%playtime% |
Time played |
%x%, %y%, %z%, %loc% |
Location |
%yaw%, %pitch% |
Where the player is facing |
%world% |
World name |
%worlddays% |
Days passed in the world |
%time%, %day% |
Current time and date (format and offset in config.yml) |
%online%, %maxplayers% |
Online and maximum players |
%ram% |
Memory in use |
%serverip%, %port% |
Server IP and port |
%version% |
Server version |
Requirements
Installation
- Put the jar in your
plugins folder.
- Restart the server.
- Edit
plugins/RealScoreboard/scoreboards.yml and config.yml, then run /rsb reload.
- To use MySQL, set the driver and login in
plugins/RealScoreboard/sql.yml and restart.
Need help or found a bug?
Please don't use the comments for bug reports. Get in touch through:
Discord | GitHub Issues
This plugin uses bStats to collect anonymous usage statistics. You can turn this off in plugins/bStats/config.yml.
评论 0
登录后参与评分
还没有评论,来抢沙发吧