
直接放置在世界中的全息排行榜。玩家点击按钮切换排行榜并滚动浏览排名。无需模组,也无需资源包。
Paper 1.21.4+ Folia Java 21
工作原理
- 站在你希望放置看板的位置,运行
/rvb create spawn loonycube。
- 插件会放置看板并从 ajLeaderboards 拉取排行榜数据。
- 玩家点击按钮即可切换排行榜:余额、游戏时长、击杀数等。
- 玩家注视看板并通过鼠标滚轮滚动。排名可向下滚动至第 100 名。
每一行、每一列和每个按钮都是一个文本显示实体(text display entity),因此你可以为看板的每个部分设置颜色、缩放比例和动画效果。
功能特性
- 直接在世界中显示全息排行榜,无需模组或资源包。
- 一个看板上支持多个排行榜,通过点击即可切换。
- 多种时间周期选项:全部时间、年度、月度、周度、日度、小时。
- 支持鼠标滚轮滚动,每个看板最多展示 100 个排名。
- 包含查看者自身的专属行,显示其当前排名及对应数值。
- 数据来源支持 ajLeaderboards 或任何支持 PlaceholderAPI 占位符的插件。
- 提供 4 种预设样式,并支持在独立文件中自定义样式:包括列宽、颜色、尺寸和文本内容。
- 4 种切换动画效果:
SLIDE_LEFT(左滑)、SLIDE_RIGHT(右滑)、ZOOM(缩放)、CASCADE(级联)。
- 当玩家注视按钮和行时,元素会自动放大。
- 支持游戏内编辑:旋转、调整大小(0.25 到 4 倍)、位移、移动、传送至看板。
- 对看板数量和排行榜数量无限制。
- 支持 MiniMessage 格式和 Folia 多线程服务器。
环境要求
| 服务端 |
Java 版本 |
必需插件 |
数据来源 |
| Paper 1.21.4+ 或 Folia |
21 |
PlaceholderAPI, packetevents |
ajLeaderboards 或任何支持占位符的插件 |
命令与权限
| 命令 |
功能说明 |
/rvb help |
显示命令列表 |
/rvb create <id> <style> |
在你站立的位置创建看板。Style 参数为 tops 文件夹中的样式文件名 |
/rvb movehere <id> |
将指定看板移动到你当前的位置 |
/rvb edit <id> |
显示看板信息 |
/rvb edit <id> rotate <0-360> |
将看板旋转至指定角度 |
/rvb edit <id> face |
使看板面向你 |
/rvb edit <id> scale <0.25-4> |
设置看板的大小缩放比例 |
/rvb edit <id> move <up|down|left|right|front|back> <blocks> |
按方向移动看板(单位:方块) |
/rvb edit <id> tp |
传送你到看板所在位置 |
/rvb edit <id> type <style> |
更改看板的样式 |
/rvb edit <id> default-top <top> |
设置默认打开的第一个排行榜 |
/rvb remove <id> |
删除指定看板 |
/rvb list |
列出所有看板 |
/rvb reload |
重载配置文件和 tops 文件夹中的样式文件 |
别名:/rvisualboards。每条命令都需要 rvisualboards.admin 权限。
config.yml
update-interval-seconds: 10 # 排行榜数据刷新的频率,单位为秒
view-radius: 32.0 # 玩家能看到看板的距离,单位为方块
snap-to-grid: true # true: 看板位于方块中心,并以 90° 步进进行旋转
debug: false # 用于故障排查的详细控制台消息
metrics: true # 匿名 bStats 统计数据
update-check: true # 检查是否有新版本插件
command: # 服务器重启后应用以下配置
name: "rvb" # 主命令名称
aliases: # 额外命令别名
- rvisualboards
clicks:
cooldown-millis: 300 # 按钮点击之间的延迟,单位为毫秒
sound:
key: "minecraft:ui.button.click" # 点击音效 ID
volume: 0.6
pitch: 1.4
# 放大玩家注视的元素。
hover:
buttons: true # 放大按钮
rows: true # 放大表格行
scale: 1.15 # 按钮放大倍数
row-scale: 1.1 # 行放大倍数
distance: 6.0 # 生效距离,单位为方块
duration-ticks: 3 # 放大持续时间,单位为刻
# 通过鼠标滚轮滚动浏览排名。
scroll:
enabled: true
max-places: 100 # 玩家能滚动到的最末排名
step: 1 # 每次滚轮滚动跨越的排名数
distance: 8.0 # 生效距离,单位为方块
# 排行榜或时间周期切换时的动画效果。
animation:
enabled: true
appear: true # 看板出现时的入场动画
types: # SLIDE_LEFT, SLIDE_RIGHT, ZOOM, CASCADE
- CASCADE
duration-ticks: 6 # 动画持续时间,单位为刻
stagger-ticks: 1 # 各行之间的延迟,单位为刻
distance: 0.6 # 偏移量,单位为方块
advanced:
viewer-check-interval-ticks: 20 # 插件检查谁在看板视野内的频率
hover-check-interval-ticks: 2 # 插件检查玩家注视方向的频率
# 数据来源占位符。{board}: 看板名称, {place}: 排名, {type}: 周期类型。
placeholders:
name: "%ajlb_lb_{board}_{place}_{type}_name%" # 该排名玩家的名称
prefix: "%ajlb_lb_{board}_{place}_{type}_prefix%" # 玩家前缀
value: "%ajlb_lb_{board}_{place}_{type}_value%" # 数值
position: "%ajlb_position_{board}_{type}%" # 查看者自身的排名
personal-value: "%ajlb_value_{board}_{type}%" # 查看者自身的数值
empty-name: "---" # 空排名时数据源返回的内容
# 非标字符的宽度(像素值),用于保持列对齐。
char-widths:
"☠": 9
"⛃": 9
"⌚": 9
config-version: 1 # 内部字段,请勿修改
tops/<style>.yml
tops 文件夹中的每个文件代表一种独立的看板样式。你在执行 /rvb create <id> <style> 时传入该文件名即可应用相应样式。
# 此榜单上的排行榜。每个排行榜都会拥有自己的按钮。
tops:
balance: # 排行榜 ID,任意名称
board: vault_eco_balance # ajLeaderboards 的榜单
label: "Balance" # 按钮文本
title: "<gradient:#f59e5b:#f5c05b>Top by coins" # 榜单标题
button-color: "#B3402709" # 选中状态的按钮颜色,格式为 #AARRGGBB
formats: # 此排行榜的文本,将覆盖共享的 formats 部分
header-value: "<#a6a6a6>Balance"
row-place: "<#f9ce5c>{place}"
row-value: "<#ebb857>{value} <#f5a05b>⛃"
empty-place: "<#f9ce5c>{place}"
empty-value: "<#ebb857>--- <#f5a05b>⛃"
# 来自其他插件的排行榜:添加一个 placeholders 部分并填入其占位符。
sellers:
board: cakeauction_sellers
label: "Sellers"
title: "<gradient:#3fd97a:#a5f08c>Top sellers"
button-color: "#B30C3618"
placeholders:
name: "%cakeauction_top_raw_name_{place}%"
prefix: "%cakeauction_top_prefix_{place}%"
value: "%cakeauction_top_value_{place}%"
position: "" # 空字符串:源插件没有此类占位符
personal-value: ""
# 标签页上的时间段:alltime(历史)、yearly(年度)、monthly(月度)、weekly(周度)、daily(日度)、hourly(小时)。
periods:
- alltime
period-names: # 榜单上显示的时间段名称
alltime: "All time"
yearly: "Year"
monthly: "Month"
weekly: "Week"
daily: "Day"
hourly: "Hour"
# 榜单文本,使用 MiniMessage 格式。
formats:
subtitle: "<#8c8c8c>{period}" # 副标题。{period}: 时间段名称
header-place: "<#a6a6a6>#" # 排名列标题
header-name: "<#a6a6a6>Player" # 玩家列标题
header-value: "<#a6a6a6>Value" # 数值列标题
row-place: "<white>{place}" # 行内的排名
row-name: "{prefix}<#f0f0f0>{name}" # 行内的名称。{prefix}: 玩家前缀
row-value: "<white>{value}" # 行内的数值
empty-place: "<white>{place}" # 空行内的排名
empty-name: "<#f0f0f0>---" # 空行内的名称
empty-value: "<white>---" # 空行内的数值
personal-place: "<white>{position}" # 当前查看玩家的排名
personal-place-unranked: "<white>-" # 未上榜玩家的排名
personal-name: "<#f0f0f0>{name}" # 个人行内的名称
personal-value: "<white>{value}" # 个人行内的数值
button: "<white>{label}" # 排行榜按钮
button-selected: "<white>{label}" # 选中的按钮
arrow-left: "<white>◀" # 按钮滚动箭头,向左
arrow-right: "<white>▶" # 按钮滚动箭头,向右
tab: "<gray>{period}" # 时间段标签
tab-selected: "<white>{period}" # 选中的标签
table:
width: 5.5 # 榜单宽度,单位为方块
rows: 15 # 同时可见的排名数量
text-scale: 1.0 # 行内文本大小
title-scale: 1.0 # 标题大小
personal-row: false # true: 显示当前查看玩家的行
shadow: true # 文本阴影
full-bright: true # true: 夜间和阴影处文本保持高亮
buttons: # 排行榜按钮
enabled: true
visible: 3 # 同时可见的按钮数量
arrows: true # 当排行榜数量多于可见数量时显示箭头
height: 0.3 # 按钮高度,单位为方块
text-scale: 1.0 # 按钮文本大小
arrow-width: 0.2 # 箭头宽度,单位为方块
tabs: # 时间段标签
enabled: false
height: 0.24 # 标签高度,单位为方块
text-scale: 0.8 # 标签文本大小
# 列。from 和 to:从榜单中心向左和向右的边缘距离(方块单位)。
# align: LEFT, CENTER, RIGHT。
columns:
place:
from: -2.75
to: -2.21
align: RIGHT
name:
from: -2.16
to: 1.51
align: CENTER
value:
from: 1.62
to: 2.75
align: RIGHT
# 背景颜色,格式为 #AARRGGBB。前两位数字设置透明度。
colors:
title: "#70000000"
header: "#80000000"
column: "#5A000000"
personal-row: "#5A000000"
button: "#66000000"
button-selected: "#B3402709"
arrow: "#66000000"
tab: "#40000000"
tab-selected: "#99000000"
# 高度和间距,单位为方块。
spacing:
padding: 0.1 # 榜单边距
title-height: 0.26 # 标题高度
subtitle-height: 0.0 # 副标题高度,设为 0 则隐藏
header-height: 0.31 # 表格头部高度
gap: 0.03 # 行与行之间的间隙
cell-padding: 0.05 # 文本距离列边缘的偏移量
buttons-margin: 0.24 # 表格与按钮之间的间隙
buttons-gap: 0.13 # 按钮之间的间隙
depth-step: 0.01 # 背景层与文本层之间的层级步长
Credits
该创意部分灵感来源于 ModernLeaderboards。感谢其作者。

Holographic leaderboards placed right in your world. Players click buttons, switch leaderboards and scroll through places. No mods, no resource pack.
Paper 1.21.4+ Folia Java 21
How it works
- Stand where you want the board and run
/rvb create spawn loonycube.
- The plugin places the board and pulls leaderboard data from ajLeaderboards.
- A player clicks a button and switches the leaderboard: balance, playtime, kills.
- A player looks at the board and scrolls the mouse wheel. Places scroll down to the 100th.
Each line, column and button is a text display entity, so you color, scale and animate every part of the board.
Features
- Holographic leaderboards right in the world, no mods or resource pack.
- Several leaderboards on one board, switched with a click.
- Period tabs: all time, year, month, week, day, hour.
- Mouse wheel scrolling, up to 100 places per board.
- A personal line with the viewing player's place and value.
- Leaderboards from ajLeaderboards or any plugin with PlaceholderAPI placeholders.
- 4 ready-made styles and your own style in a separate file: columns, colors, sizes, texts.
- 4 switch animations:
SLIDE_LEFT, SLIDE_RIGHT, ZOOM, CASCADE.
- Buttons and lines grow when a player looks at them.
- In-game editing: rotate, resize from 0.25 to 4, shift, move, teleport.
- No limit on the number of boards and leaderboards.
- MiniMessage, Folia support.
Requirements
| Server |
Java |
Required plugins |
Data source |
| Paper 1.21.4+ or Folia |
21 |
PlaceholderAPI, packetevents |
ajLeaderboards or any plugin with placeholders |
Commands and permissions
| Command |
What it does |
/rvb help |
Shows the command list |
/rvb create <id> <style> |
Creates a board where you stand. Style is a file from the tops folder |
/rvb movehere <id> |
Moves a board to your position |
/rvb edit <id> |
Shows board information |
/rvb edit <id> rotate <0-360> |
Rotates the board to an angle |
/rvb edit <id> face |
Turns the board to face you |
/rvb edit <id> scale <0.25-4> |
Sets the board size |
/rvb edit <id> move <up|down|left|right|front|back> <blocks> |
Shifts the board |
/rvb edit <id> tp |
Teleports you to the board |
/rvb edit <id> type <style> |
Changes the board style |
/rvb edit <id> default-top <top> |
Sets the leaderboard that opens first |
/rvb remove <id> |
Deletes a board |
/rvb list |
Shows the board list |
/rvb reload |
Reloads the configs and the tops folder |
Alias: /rvisualboards. Every command requires rvisualboards.admin.
config.yml
update-interval-seconds: 10 # how often leaderboard data refreshes, in seconds
view-radius: 32.0 # distance from which a player sees a board, in blocks
snap-to-grid: true # true: the board sits at the block center and rotates in 90° steps
debug: false # detailed console messages for troubleshooting
metrics: true # anonymous bStats statistics
update-check: true # checks for a new plugin version
command: # applied after a server restart
name: "rvb" # main command name
aliases: # extra command names
- rvisualboards
clicks:
cooldown-millis: 300 # delay between button clicks, in milliseconds
sound:
key: "minecraft:ui.button.click" # click sound ID
volume: 0.6
pitch: 1.4
# Enlarges the element a player looks at.
hover:
buttons: true # enlarge buttons
rows: true # enlarge table lines
scale: 1.15 # button growth factor
row-scale: 1.1 # line growth factor
distance: 6.0 # working distance, in blocks
duration-ticks: 3 # growth duration, in ticks
# Mouse wheel scrolling through places.
scroll:
enabled: true
max-places: 100 # last place a player reaches
step: 1 # places per wheel step
distance: 8.0 # working distance, in blocks
# Animation on leaderboard or period change.
animation:
enabled: true
appear: true # animation when the board appears
types: # SLIDE_LEFT, SLIDE_RIGHT, ZOOM, CASCADE
- CASCADE
duration-ticks: 6 # duration, in ticks
stagger-ticks: 1 # delay between lines, in ticks
distance: 0.6 # offset, in blocks
advanced:
viewer-check-interval-ticks: 20 # how often the plugin checks who sees a board
hover-check-interval-ticks: 2 # how often the plugin checks where a player looks
# Data source placeholders. {board}: board name, {place}: place, {type}: period.
placeholders:
name: "%ajlb_lb_{board}_{place}_{type}_name%" # player name at the place
prefix: "%ajlb_lb_{board}_{place}_{type}_prefix%" # player prefix
value: "%ajlb_lb_{board}_{place}_{type}_value%" # value
position: "%ajlb_position_{board}_{type}%" # the viewing player's place
personal-value: "%ajlb_value_{board}_{type}%" # the viewing player's value
empty-name: "---" # what the source returns for an empty place
# Width of non-standard characters, in pixels. Keeps columns aligned.
char-widths:
"☠": 9
"⛃": 9
"⌚": 9
config-version: 1 # internal field, leave it as is
tops/<style>.yml
Each file in the tops folder is a separate board style. You pass the file name to /rvb create <id> <style>.
# Leaderboards on this board. Each one gets its own button.
tops:
balance: # leaderboard ID, any name
board: vault_eco_balance # ajLeaderboards board
label: "Balance" # button text
title: "<gradient:#f59e5b:#f5c05b>Top by coins" # board title
button-color: "#B3402709" # selected button color, #AARRGGBB
formats: # texts for this leaderboard, override the shared formats section
header-value: "<#a6a6a6>Balance"
row-place: "<#f9ce5c>{place}"
row-value: "<#ebb857>{value} <#f5a05b>⛃"
empty-place: "<#f9ce5c>{place}"
empty-value: "<#ebb857>--- <#f5a05b>⛃"
# A leaderboard from another plugin: add a placeholders section with its placeholders.
sellers:
board: cakeauction_sellers
label: "Sellers"
title: "<gradient:#3fd97a:#a5f08c>Top sellers"
button-color: "#B30C3618"
placeholders:
name: "%cakeauction_top_raw_name_{place}%"
prefix: "%cakeauction_top_prefix_{place}%"
value: "%cakeauction_top_value_{place}%"
position: "" # empty string: the source has no such placeholder
personal-value: ""
# Periods on the tabs: alltime, yearly, monthly, weekly, daily, hourly.
periods:
- alltime
period-names: # period names on the board
alltime: "All time"
yearly: "Year"
monthly: "Month"
weekly: "Week"
daily: "Day"
hourly: "Hour"
# Board texts, MiniMessage format.
formats:
subtitle: "<#8c8c8c>{period}" # subtitle. {period}: period name
header-place: "<#a6a6a6>#" # place column header
header-name: "<#a6a6a6>Player" # name column header
header-value: "<#a6a6a6>Value" # value column header
row-place: "<white>{place}" # place in a line
row-name: "{prefix}<#f0f0f0>{name}" # name in a line. {prefix}: player prefix
row-value: "<white>{value}" # value in a line
empty-place: "<white>{place}" # place in an empty line
empty-name: "<#f0f0f0>---" # name in an empty line
empty-value: "<white>---" # value in an empty line
personal-place: "<white>{position}" # the viewing player's place
personal-place-unranked: "<white>-" # place of a player outside the leaderboard
personal-name: "<#f0f0f0>{name}" # name in the personal line
personal-value: "<white>{value}" # value in the personal line
button: "<white>{label}" # leaderboard button
button-selected: "<white>{label}" # selected button
arrow-left: "<white>◀" # button scroll arrow, left
arrow-right: "<white>▶" # button scroll arrow, right
tab: "<gray>{period}" # period tab
tab-selected: "<white>{period}" # selected tab
table:
width: 5.5 # board width, in blocks
rows: 15 # places visible at once
text-scale: 1.0 # line text size
title-scale: 1.0 # title size
personal-row: false # true: show the viewing player's line
shadow: true # text shadow
full-bright: true # true: text stays bright at night and in shade
buttons: # leaderboard buttons
enabled: true
visible: 3 # buttons visible at once
arrows: true # arrows when there are more leaderboards than visible
height: 0.3 # button height, in blocks
text-scale: 1.0 # button text size
arrow-width: 0.2 # arrow width, in blocks
tabs: # period tabs
enabled: false
height: 0.24 # tab height, in blocks
text-scale: 0.8 # tab text size
# Columns. from and to: left and right edge in blocks from the board center.
# align: LEFT, CENTER, RIGHT.
columns:
place:
from: -2.75
to: -2.21
align: RIGHT
name:
from: -2.16
to: 1.51
align: CENTER
value:
from: 1.62
to: 2.75
align: RIGHT
# Background colors, #AARRGGBB. The first two digits set opacity.
colors:
title: "#70000000"
header: "#80000000"
column: "#5A000000"
personal-row: "#5A000000"
button: "#66000000"
button-selected: "#B3402709"
arrow: "#66000000"
tab: "#40000000"
tab-selected: "#99000000"
# Heights and gaps, in blocks.
spacing:
padding: 0.1 # board margins
title-height: 0.26 # title height
subtitle-height: 0.0 # subtitle height, 0 hides it
header-height: 0.31 # table header height
gap: 0.03 # gap between lines
cell-padding: 0.05 # text offset from the column edge
buttons-margin: 0.24 # gap between the table and the buttons
buttons-gap: 0.13 # gap between buttons
depth-step: 0.01 # step between background and text layers
Credits
The idea was partly inspired by ModernLeaderboards. Thanks to its author.
评论 0
登录后参与评分
还没有评论,来抢沙发吧