Sentinel - TextDisplays

Minecraft 版本： 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper spigot

标签： decoration library utility

---

✨ 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 ```text /td create [text] Create a display where you stand /td edit · /td gui Open the in-game editor /td line add|set|remove ... Edit text lines /td page add|addaction ... Pages & click actions /td scale [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.

---