ShelfNames

插件

· 作者 mizpablito

一个适用于 Minecraft(Paper)的轻量级插件,当玩家注视带有货架的方块(*_SHELF)时,会在其上方以全息图形式显示物品名称。

0 本站下载 0 关注 更新于 4 周前

最新 1.3.2 · 26.3 · Folia / Paper

一键开服(送7天)

一个轻量级的 Minecraft (Paper) 插件,当玩家注视放置于架子(*_SHELF)上的物品时,会在方块上方以全息图形式显示这些物品的名称。

该插件注重性能优化,避免不必要的内存分配,对服务器主线程的影响降至最低。

仅显示自定义物品名称

GitHub 上的波兰语版本描述 GitHub

功能特性

  • 将架子上的物品名称以全息图形式展示
  • 支持所有木质架子变体(Tag.WOODEN_SHELVES)
  • 保留物品名称的颜色和格式
  • 仅在内容实际发生变化时更新全息图
  • 当玩家移开视线后自动移除全息图
  • 无闪烁且无冗余更新
  • 完全兼容 Adventure / MiniMessage

工作原理

  • 每隔配置的 tick 数,插件会检查玩家正在注视的方块
  • 如果是架子:
    • 将其位置与缓存中的上一个位置进行比较
    • 仅在被注视的架子发生变化时才获取其内容快照
  • 仅在被注视的架子发生变化后更新全息图
  • 昂贵的操作(如 BlockState)仅在真正需要时执行

命令与权限

命令 权限 描述
/shelfnames (或 /shelfnames info) (无) 插件信息:名称、版本、GitHub 链接
/shelfnames clear shelfnames.admin 移除由插件创建的所有全息图
/shelfnames reload shelfnames.admin 完全重启:销毁全息图,重新加载 config.yml,重启组件

没有 shelfnames.admin 权限的玩家只能运行基础的 /shelfnames (info) 命令。shelfnames.admin 默认授予 OP 玩家。

要求与依赖

要求: Paper 1.21+、FancyHolograms 2.8.0+、Java 21。

依赖项: (软依赖) FancyHolograms、Paper API、Adventure(随 Paper 捆绑提供)。

不支持的集成

DecentHolograms — 不支持 DecentHolograms,因为其公共 API 未暴露全息图固定(billboard FIXED)、缩放或背景等功能,因此无法像针对 FancyHolograms 或 Bukkit API 那样进行集成。无需依赖的替代方案是 STANDALONE 提供者(使用 Bukkit TextDisplay),它支持 hologram.scale 和 hologram.position-fixed。

备注

配置: GitHub 上提供了完整的示例 config.yml,其中包含每个选项的注释:config.yml。

计划中的功能: 可选的过渡平滑效果(淡入 / 淡出)。

技术说明: 该插件不使用 NMS,不发送自定义数据包,也不干扰服务器 tick 循环。它已通过 Spark Profiler 进行优化,并在真实负载下进行了测试。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源