Sentinel - 文本显示

插件

原名 Sentinel - TextDisplays · 作者 dimazbtw

基于数据包的 Spigot / Paper 文本显示系统

0 本站下载 0 关注 更新于 5 个月前

需要前置:PacketEvents

最新 1.0.0 · 1.21.11 · Paper / Spigot

一键开服(送7天)

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

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源