Sentinel-TextDisplays
面向 Spigot & Paper 的逐玩家文本显示
真实的 text_display 实体 —— 支持缩放文本、HEX 颜色与渐变、多页面全息投影、
点击交互、逐玩家占位符、内置编辑器以及开发者 API。
一款插件搞定所有需求。
✨ 与众不同之处
这些是真正的 minecraft:text_display 实体(1.19.4 新增)—— 并非盔甲架
全息投影 —— 通过数据包以 逐玩家方式 渲染。同一个显示装置会以自己的名字向每位玩家致意,展示各自的余额、各自的页面。服务器端不存在任何实体:不执行任何 tick,不生成任何实体,只有范围内的玩家才会接收数据。
- 逐玩家占位符 —
%player_name%、余额、延迟……每位玩家获得各自解析后的文本。
- 真正的文本缩放 — 基于真实
text_display 的尺寸调整,支持各轴向独立缩放。从微型标签到广告牌大小的标题。
- 零实体开销 — 全部基于数据包;开销取决于玩家可见范围,而非实体存在与否。
? 精细样式控制
- 无限色彩 — 传统
& 代码、&#RRGGBB HEX 色值以及平滑 <gradient> 渐变。
- 表情符号与字形 — ItemsAdder 和 Nexo 的字形可直接在文本中渲染。
- 广告牌模式与背景 — 四种朝向模式;默认、透明或任意 ARGB 背景。
- 光照与可见性 — 亮度覆盖、透明度、阴影、穿透、对齐方式、行宽。
- 逐显示范围设置 — 显示范围、更新范围、更新间隔以及每个显示的查看权限。
? 页面与点击交互
一个显示装置,多个页面 —— 每位玩家均可 独立浏览。四种点击类型
(LEFT、RIGHT、SHIFT_LEFT、SHIFT_RIGHT)各自运行独立的动作链,包含权限门控和逐玩家冷却时间 —— 无需额外插件。
| Action |
功能 |
MESSAGE · COMMAND · CONSOLE |
聊天 / 以玩家身份运行 / 以控制台身份运行 |
SOUND · TELEPORT · CONNECT |
播放音效 / 传送 / 连接至服务器 |
NEXT_PAGE · PREV_PAGE · PAGE |
页面导航 —— 将显示装置变为菜单 |
PERMISSION |
权限门控 —— 阻止后续动作链执行 |
?️ 指向即点击,完成
简洁的内置 GUI 编辑器 涵盖所有功能 —— 创建、编辑行、页面、点击交互、外观
和设置。在聊天栏输入文本,使用 +/- 按钮调整数值。偏好命令?完整的 /td
命令树与其对应,支持 Tab 补全,底层采用熟悉的 DecentHolograms 风格文件格式
(因此大多数全息投影文件可直接导入)。
命令概览
/td create <name> [text] 在你站立的位置创建一个显示装置
/td edit <name> · /td gui 打开内置编辑器
/td line add|set|remove ... 编辑文本行
/td page add|addaction ... 页面与点击交互
/td scale <name> <x> [y] [z] 真正的文本尺寸调整
/td billboard|background|opacity|alignment|brightness ...
/td displayrange|updaterange|updateinterval|viewpermission ...
/td clone|rename|move|teleport|enable|disable|reload
权限:displays.admin(默认:op)。在游戏中输入 /td help 获取完整分类列表。
⚡ 轻量设计
- 完全基于数据包 — 服务器端不存在任何实体;永不执行 tick。
- 差异更新 — 仅当玩家解析后的文本实际发生变化时才重新发送文本。
- 单一轻量依赖 — 仅需 PacketEvents,无其他捆绑内容。
- 兼容 Spigot / Paper 1.19.4 – 1.21.x,Java 17 – 21。
? 依赖要求
- 必需: PacketEvents(免费,需单独安装)
- 可选(自动检测): PlaceholderAPI · ItemsAdder · Nexo
玩家无需安装任何内容 —— 全部由服务端数据包处理。
?️ 开发者 API
提供文档完善的静态 API 以及 可取消的 Bukkit 事件(点击、页面变更、创建、删除)。
创建 临时、仅内存占用 的显示装置,为每位玩家驱动页面,并在代码中完全处理点击事件。
Display d = TextDisplaysAPI.createTemporaryDisplay("shop", loc, "&b&lShop");
@EventHandler
void onClick(DisplayClickEvent e) {
if (e.getDisplay() == d) { e.setCancelled(true); shop.open(e.getPlayer()); }
}
? 完整 API 文档与 Wiki → github.com/dimazbtw/Sentinel-TextDisplays
? 文档与支持
- 文档 — 完整设置指南、所有命令、文件格式及 API 详见
Wiki。
- 支持 — 有疑问或遇到问题?请在 Discord 上联系我:@notdimaz。请在提交评论前开设工单 —— 几乎所有问题都能快速修复。
Sentinel-TextDisplays · PACKET-NATIVE · SPIGOT / PAPER · 1.19.4 – 1.21.x
Sentinel-TextDisplays
Per-player Text Displays for Spigot & Paper
Real text_display entities — scalable text, HEX colors & gradients, multi-page holograms,
click actions, per-viewer placeholders, an in-game editor and a developer API.
One plugin that does the whole job.
✨ Why it's different
These are genuine minecraft:text_display entities (added in 1.19.4) — not armor-stand
holograms — rendered per player via packets. The same display greets every player by their own
name, shows their own balance, their own page. No entity ever exists server-side: nothing ticks,
nothing spawns, and only players in range receive anything.
- Per-viewer placeholders —
%player_name%, balances, ping… each player gets their own resolved text.
- True text scaling — real
text_display sizing, per axis. Tiny labels to billboard-sized titles.
- Zero entity cost — everything is packets; cost tracks what players can see, not what exists.
? Style every detail
- Colors without limits — legacy
&-codes, &#RRGGBB hex and smooth <gradient> fades.
- Emojis & glyphs — ItemsAdder and Nexo glyphs render right inside the text.
- Billboard & background — four facing modes; default, transparent or any ARGB background.
- Light & visibility — brightness override, opacity, shadow, see-through, alignment, line width.
- Per-display ranges — display-range, update-range, update-interval and a view permission per display.
? Pages & click actions
One display, many pages — and every player browses independently. Four click types
(LEFT, RIGHT, SHIFT_LEFT, SHIFT_RIGHT) each run their own action chain, with permission
gates and a per-player cooldown — no second plugin.
| Action |
Does |
MESSAGE · COMMAND · CONSOLE |
Chat / run as player / run as console |
SOUND · TELEPORT · CONNECT |
Play a sound / teleport / send to a server |
NEXT_PAGE · PREV_PAGE · PAGE |
Page navigation — turn a display into a menu |
PERMISSION |
Gate — stops the rest of the chain |
?️ Point, click, done
A clean in-game GUI editor covers everything — create, lines, pages, click actions, appearance
and settings. Type text in chat, tune numbers with +/- buttons. Prefer commands? The full /td
command tree mirrors it, with tab-completion and a familiar DecentHolograms-style file format
underneath (so most hologram files drop right in).
Command overview
/td create <name> [text] Create a display where you stand
/td edit <name> · /td gui Open the in-game editor
/td line add|set|remove ... Edit text lines
/td page add|addaction ... Pages & click actions
/td scale <name> <x> [y] [z] True text size
/td billboard|background|opacity|alignment|brightness ...
/td displayrange|updaterange|updateinterval|viewpermission ...
/td clone|rename|move|teleport|enable|disable|reload
Permission: displays.admin (default: op). Type /td help in-game for the full, categorized list.
⚡ Light by design
- Fully packet-based — no entities exist server-side; nothing ticks, ever.
- Diff-based updates — text is only re-sent to a player when their resolved text actually changed.
- One light jar — only PacketEvents required, nothing else bundled.
- Spigot / Paper 1.19.4 – 1.21.x, Java 17 – 21.
? Requirements
- Required: PacketEvents (free, installed separately)
- Optional (auto-detected): PlaceholderAPI · ItemsAdder · Nexo
Players need nothing — everything is server-side packets.
?️ Developer API
A documented static API plus cancellable Bukkit events (click, page change, create, delete).
Spawn temporary, memory-only displays, drive pages per player, and handle clicks entirely in code.
Display d = TextDisplaysAPI.createTemporaryDisplay("shop", loc, "&b&lShop");
@EventHandler
void onClick(DisplayClickEvent e) {
if (e.getDisplay() == d) { e.setCancelled(true); shop.open(e.getPlayer()); }
}
? Full API docs & wiki → github.com/dimazbtw/Sentinel-TextDisplays
? Docs & support
- Documentation — full setup, every command, the file format and the API on the
Wiki.
- Support — questions or issues? Reach me on Discord: @notdimaz. Please open a ticket
before a review — almost everything is a quick fix.
Sentinel-TextDisplays · PACKET-NATIVE · SPIGOT / PAPER · 1.19.4 – 1.21.x
评论 0
登录后参与评分
还没有评论,来抢沙发吧