一个轻量级的 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 进行优化,并在真实负载下进行了测试。
A lightweight Minecraft (Paper) plugin that displays the names of items placed on shelves (*_SHELF) as a hologram above the block when a player looks at it.
The plugin is designed with a focus on performance, no unnecessary allocations, and minimal impact on the server thread.

Polish version of the description on GitHub
Features
- Shows item names from a shelf as a hologram
- Supports every wooden shelf variant (
Tag.WOODEN_SHELVES) - Preserves item name colors and formatting
- Updates the hologram only when the contents actually change
- Automatically removes the hologram once the player looks away
- No flickering and no redundant updates
- Fully compatible with Adventure / MiniMessage
How it works
- Every configured number of ticks the plugin checks which block the player is looking at
- If it's a shelf:
- its position is compared with the previous one (cache)
- a snapshot of the contents is taken only when the looked-at shelf changes
- The hologram is updated only after the looked-at shelf changes
- Expensive operations (
BlockState) are performed only when actually needed
Commands & permissions
| Command | Permission | Description |
|---|---|---|
/shelfnames (or /shelfnames info) |
(none) | Plugin info: name, version, GitHub link |
/shelfnames clear |
shelfnames.admin |
Removes every hologram created by the plugin |
/shelfnames reload |
shelfnames.admin |
Full restart: destroys holograms, reloads config.yml, restarts components |
Players without shelfnames.admin can only run the bare /shelfnames (info) command. shelfnames.admin defaults to OP.
Requirements & dependencies
Requirements: Paper 1.21+, FancyHolograms 2.8.0+, Java 21.
Dependencies: (soft) FancyHolograms, Paper API, Adventure (bundled with Paper).
Unsupported integrations
DecentHolograms — DecentHolograms is not supported, as its public API exposes no hologram pinning (billboard FIXED), scaling, or background, so the integration cannot be done the way it is for FancyHolograms or the Bukkit API. Dependency-free replacement: the STANDALONE provider (Bukkit TextDisplay), which honors hologram.scale and hologram.position-fixed.
Notes
Configuration: a full example config.yml, with comments for every option, is available on GitHub: config.yml.
Planned features: optional transition smoothing (fade in / fade out).
Technical notes: the plugin does not use NMS, does not send its own packets, and does not interfere with the server tick loop. It was optimized using the Spark Profiler and tested under realistic load.
下载 ShelfNames
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ShelfNames
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ShelfNames
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ShelfNames
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ShelfNames
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ShelfNames
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ShelfNames
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ShelfNames
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ShelfNames
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
更新内容
- bStats 退出选项:
config.yml中新增bStats: true选项(默认启用)。将其设置为false可禁用该插件的匿名使用统计。此设置在对/shelfnames reload命令生效后同样适用。 - 自动配置更新: 启动时,缺失的配置项将自动添加到现有的
config.yml文件中,并附带其默认注释说明。您的自定义值和原有注释永远不会被修改,因此未来版本引入新选项时,您无需手动编辑配置文件。
完整更新日志:
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧