rVisualBoards

插件

· 作者 Rulhot

在你的世界中实现全息排行榜,支持可点击按钮、分页标签以及向上滚动查看前 100 名。

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

最新 1.9 · 26.3 · Bukkit / Folia

一键开服(送7天)

照片

直接放置在世界中的全息排行榜。玩家点击按钮切换排行榜并滚动浏览排名。无需模组,也无需资源包。

Paper 1.21.4+ Folia Java 21

工作原理

  1. 站在你希望放置看板的位置,运行 /rvb create spawn loonycube。
  2. 插件会放置看板并从 ajLeaderboards 拉取排行榜数据。
  3. 玩家点击按钮即可切换排行榜:余额、游戏时长、击杀数等。
  4. 玩家注视看板并通过鼠标滚轮滚动。排名可向下滚动至第 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。感谢其作者。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源