JHolograms
基于 Minecraft 现代显示实体构建的高级全息图,无需 ProtocolLib、无需盔甲架、无需客户端模组。JHolograms 使用 1.19.4 引入的原生 TextDisplay、ItemDisplay 和 BlockDisplay 实体,为你带来清晰、轻量且完全可控的全息图,支持对文本、物品、方块、颜色、动画和可见性的全面控制。
专为 Paper 1.19.4 至 26.x 打造,可选集成 PlaceholderAPI。
功能特性
- 三种行类型 - 在单个全息图中自由堆叠文本、悬浮物品和悬浮方块。
- MiniMessage 格式支持 - 完整支持
<gradient>、<rainbow> 以及 <#RRGGBB> 十六进制颜色,同时兼容经典的 & 和 &#RRGGBB 旧版代码。你可以随意选择喜欢的格式;两者均可使用。
- 玩家专属文本 - 将全息图标记为“玩家专属”后,每位查看者都会看到属于自己的副本,并为每个玩家实时解析 PlaceholderAPI 占位符。
- 条件可见性 - 通过权限检查、占位符比较(例如
%player_level% >= 10)以及 && 链式逻辑,按玩家设置全息图的显示或隐藏。
- 动画效果 - 以可配置的刻间隔循环播放文本帧,并在所有查看者之间保持完美同步。
- 完整的变换控制 - 可对任意行设置缩放、旋转和位置。
- 发光效果 - 可为任意类型的行切换实体轮廓发光,并自定义发光颜色。
- 文本样式 - 支持对齐方式、背景颜色与不透明度、文本阴影以及半透明渲染。
- ** billboard 模式** - 提供
fixed(固定)、center(居中)、vertical(垂直)和 horizontal(水平)四种朝向模式。
- 持久化与安全 - 所有数据均存储在 SQLite 中,实体永远不会保存到你的世界文件中;崩溃遗留的孤立全息图会在服务器启动时自动清理。
格式示例
/jh addline spawn <gradient:#3fe0d0:#ffb454>Welcome to Spawn</gradient>
/jh addline spawn <bold><#ffaa00>Limited Offer
/jh addline spawn &7Balance: &a$%vault_eco_balance%
渐变和十六进制颜色经过优化渲染,可在整个 1.19.4–1.21.x 版本范围内正确显示,无需任何资源包。
命令
所有命令均在 /jholo 下运行(别名 /jh, /holo)。行通过从零开始的索引进行引用。
| 命令 |
描述 |
/jh create <name> |
在你所在位置创建全息图 |
/jh addline <name> <text> |
添加文本行 |
/jh additem <name> <material> |
添加悬浮物品 |
/jh addblock <name> <material> |
添加悬浮方块 |
/jh animate <name> <i> <interval> <f1|f2|...> |
为文本行设置动画 |
/jh scale <name> <i> <x> <y> <z> |
缩放某一行 |
/jh rotate <name> <i> <x> <y> <z> |
旋转某一行(角度制) |
/jh glow <name> <i> <true|false> |
切换发光效果 |
/jh perplayer <name> <true|false> |
启用/禁用玩家专属渲染 |
/jh condition <name> <expression> |
设置可见性条件 |
……还有更多用于背景、不透明度、对齐方式、billboard、视距、行间距及编辑的命令。在游戏中输入 /jh help 可查看完整列表。
要求
- Paper 1.19.4 – 1.21.x(需要显示实体,因此最低版本为 1.19.4)
- Java 17+
- PlaceholderAPI (可选) - 仅在使用占位符支持时需要
权限
jholograms.admin - 完全访问所有全息图管理命令(默认:OP)
JHolograms
Advanced holograms built on Minecraft's modern Display entities no ProtocolLib, no armor stands, no client mods. JHolograms uses the native TextDisplay, ItemDisplay, and BlockDisplay entities introduced in 1.19.4, giving you crisp, lightweight holograms with full control over text, items, blocks, color, animation, and visibility.
Built for Paper 1.19.4 through 26.x, with optional PlaceholderAPI integration.
Features
- Three line types - stack text, floating items, and floating blocks freely within a single hologram.
- MiniMessage formatting - full
<gradient>, <rainbow>, and <#RRGGBB> hex support, plus classic & and &#RRGGBB legacy codes. Use whichever you prefer; both work.
- Per-player text - flag a hologram as per-player and every viewer sees their own copy, with PlaceholderAPI placeholders resolved live for them individually.
- Conditional visibility - show or hide a hologram per player using permission checks, placeholder comparisons (
%player_level% >= 10), and && chaining.
- Animation - cycle text through frames on a configurable tick interval, kept perfectly in sync across all viewers.
- Full transform control - set scale, rotation, and position on any line.
- Glow - toggle an entity outline glow with a custom glow color on any line type.
- Text styling - alignment, background color and opacity, text shadow, and see-through rendering.
- Billboard modes -
fixed, center, vertical, and horizontal facing.
- Persistent and safe - everything is stored in SQLite, entities never save into your world files, and orphaned holograms left behind by a crash are cleaned up automatically on startup.
Formatting examples
/jh addline spawn <gradient:#3fe0d0:#ffb454>Welcome to Spawn</gradient>
/jh addline spawn <bold><#ffaa00>Limited Offer
/jh addline spawn &7Balance: &a$%vault_eco_balance%
Gradients and hex colors are rendered so they display correctly across the entire 1.19.4–1.21.x range, with no resource pack required.
Commands
All commands run under /jholo (aliases /jh, /holo). Lines are referenced by a zero-based index.
| Command |
Description |
/jh create <name> |
Create a hologram at your location |
/jh addline <name> <text> |
Add a text line |
/jh additem <name> <material> |
Add a floating item |
/jh addblock <name> <material> |
Add a floating block |
/jh animate <name> <i> <interval> <f1|f2|...> |
Animate a text line |
/jh scale <name> <i> <x> <y> <z> |
Scale a line |
/jh rotate <name> <i> <x> <y> <z> |
Rotate a line (degrees) |
/jh glow <name> <i> <true|false> |
Toggle glow |
/jh perplayer <name> <true|false> |
Per-player rendering |
/jh condition <name> <expression> |
Set visibility condition |
...and many more for backgrounds, opacity, alignment, billboard, view range, line spacing, and editing. Type /jh help in game for the full list.
Requirements
- Paper 1.19.4 – 1.21.x (Display entities are required, so 1.19.4 is the minimum)
- Java 17+
- PlaceholderAPI (optional) - only needed if you want placeholder support
Permissions
jholograms.admin - full access to all hologram management commands (default: op)
评论 0
登录后参与评分
还没有评论,来抢沙发吧