THolograms

插件

· 作者 sstoppergaming

下一代轻量级 3D 全息投影与展示实体引擎,具备 Motion DNA、Folia 多线程支持、零刻钟开销以及交互式碰撞箱。

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

最新 1.0.1 · 1.21.11 · Folia / Paper

一键开服(送7天)

? THOLOGRAMS

全息图。为现代 Minecraft 服务器重新设计。

极小占用。无限可能。100% 原生显示实体。

[平台: Paper 26.3 • Purpur • Folia] • [Java: 21 — 25+] • [许可证: MIT] • [版本: v1.0.0]

   ⚡ 3D 微型组合  •  零刻钟开销  •  Folia 区域感知 ⚡

⚡ 架构范式的转变

大多数传统的全息图插件编写于多年前,围绕过时的 Minecraft 变通方案:

  • ❌ 隐形盔甲架: 数百个隐形盔甲架加载区块并给服务器刻钟循环施加压力。
  • ❌ 全局 O(Holograms × Players) 循环: 每刻钟不断检查距离、重新计算行并发送数据包。
  • ❌ 数据包泛滥与不同步: 服务器崩溃后残留的幽灵盔甲架或在区块边界处不同步。
  • ❌ 臃肿的 JAR 文件: 塞满着色数据包库的 3MB 到 5MB 胖 JAR。

? THolograms 如何彻底改变游戏规则:

传统引擎:                         THolograms 引擎:
┌──────────────────────────────────────┐     ┌──────────────────────────────────────┐
│ [!] 全局刻钟循环 (全息图 × 观看者)    │    │ [✓] 事件驱动的视锥裁剪             │
│ [!] 隐形盔甲架黑客手段               │     │ [✓] 100% 原生显示实体              │
│ [!] 高堆分配与垃圾回收               │     │ [✓] 零分配的数学 DNA               │
│ [!] 服务器端物理开销                 │     │ [✓] 客户端 GPU 插值                │
│ [!] Folia 竞态条件                   │     │ [✓] 严格多线程 Folia 就绪          │
│ [!] 3MB+ 胖 JAR 膨胀                 │     │ [✓] ~181 KB 纯高性能 JAR           │
└──────────────────────────────────────┘     └──────────────────────────────────────┘

零刻钟规则: 静态全息图和附近没有观看者的全息图每刻钟执行 0.000 ms CPU。静态全息图产生 零重复服务器开销。


? 标志性核心创新

1. ? 运动 DNA — 过程化客户端插值

告别每刻钟在服务器端进行滞后的坐标计算。运动 DNA 计算确定性的谐波曲线,利用 Minecraft 原生的客户端 GPU 插值:

  • ELEGANT(优雅) — 柔和的正弦垂直呼吸效果,带有平滑的环境偏航旋转。
  • FLOATING(漂浮) — 自然的浮力起伏,带有微妙的俯仰和翻滚摆动。
  • ENERGETIC(活力) — 弹跳的动态脉冲,带有连续的快速旋转。
  • FUTURISTIC(未来) — 量化阶梯式升高,带有清晰的机器人过渡。
  • MAGICAL(魔法) — 谐波 3D 利萨如(Lissajous)8 字形轨道曲线。
  • MECHANICAL(机械) — 线性缓动,带有机器人的咔哒声。
  • ORGANIC(有机) — 多谐波流体振荡。
  • NONE(无) — 静态固定锁定。

2. ⚡ 3D 微型组合与自动布局

全息图不必只是平面文本。构建 完整的 3D 视觉场景,将 MiniMessage 渐变排版、悬浮 3D 物品和体素块组合在一个场景中:

  • TextDisplay(文本显示) — MiniMessage 渐变、阴影、自定义背景透明度、防墙透视模式以及广告牌旋转。
  • ItemDisplay(物品显示) — 带有自动间距的悬浮 3D 物品模型。
  • BlockDisplay(方块显示) — 完整的体素方块状态(箱子、紫水晶簇、信标、矿石)。
  • AutoLayout Engine(自动布局引擎) — 自动计算精确的垂直净空距离(Text: 0.28m, Item: 0.60m, Block: 1.00m),让你无需手动猜测 Y 坐标!

3. ? 原生响应式交互碰撞盒

使用原生 Minecraft Interaction(交互) 实体放置在组合的精确包围几何结构周围。

  • 真正的客户端射线追踪,无需乘客黑客手段。
  • 点击时绑定 控制台命令、玩家命令、直接聊天消息 或 音效。

4. ? 每玩家智能上下文与占位符智能

完全可选的软依赖集成,支持 PlaceholderAPI (%player_name%, %vault_eco_balance% 等)。

  • 智能刷新: 仅当玩家在活跃观看范围内时才评估占位符。
  • 零堆开销: 未更改的占位符行不会触发元数据包更新。
  • 没有 PAPI?没问题: THolograms 完全独立运行,无需外部依赖。

5. ?️ 一行场景 DSL

直接在聊天或控制台中,用 一秒时间 创建多行 3D 全息场景:

/tholo quick hub <rainbow><bold>WELCOME TO SKYBLOCK</bold></rainbow> | item:NETHER_STAR | <yellow>Welcome, %player_name%! | <gray>Click to open menu

6. ?️ 交互式 GUI 编辑器与可点击聊天 UI

  • 箱形库存编辑器 (/tholo edit <id>): 实时点击编辑行文本,切换阴影,调整防墙透视,切换背景预设,并实时微调位置。
  • 可点击聊天控件 (/tholo list, /tholo lines <id>): 聊天中的交互式 [TP]、[EDIT]、[LINES]、[▲]、[▼] 和 [✖] 按钮。

7. ⏪ 20 步撤销/重做与快照备份

  • 误删或放错位置?一条命令回滚:/tholo undo <id> 或 /tholo redo <id>。
  • 创建命名的配置检查点:/tholo snapshot <id> <name> 及 /tholo restore <name> <id>。

8. ?️ 原生 Folia 多线程与自适应调节器

  • Folia 原生: 使用 RegionScheduler 处理基于位置的地图操作,EntityScheduler 处理显示实体,并使用异步 I/O 进行保存。
  • 自适应负载调节器: 持续跟踪服务器 MSPT 和 TPS。在服务器压力过大时,它会自动降低动画间隔以保护游戏性能。

?️ 完整控制与命令参考

基础别名:/thologram, /tholo, /tholograms
权限:tholograms.admin (默认: OP)

1. 创建与场景 DSL

命令 描述 示例
/tholo create <id> [text] 在玩家视线高度创建全息图 /tholo create hub <gold>Welcome!
/tholo quick <id> <l1> | <l2> | <l3> 单行场景 DSL(文本、物品、方块) /tholo quick crate item:CHEST | <gold>Mystery Crate
/tholo edit <id> 打开交互式箱子 GUI 编辑器 /tholo edit hub
/tholo list 带有 [TP] [EDIT] [DEL] 按钮的交互式聊天列表 /tholo list
/tholo info <id> 全息图的详细运行时诊断信息 /tholo info hub
/tholo delete <id> 安全地消失并删除全息图 /tholo delete hub
/tholo clone <src> <newId> 克隆现有全息图 /tholo clone hub hub_copy

2. 行操作

命令 描述 示例
/tholo lines <id> 带有 [↑] [↓] [✎] [✕] 按钮的交互式行管理器 /tholo lines hub
/tholo addline <id> <content> 添加文本、item:<MAT> 或 block:<MAT> /tholo addline hub item:DIAMOND
/tholo setline <id> <index> <text> 替换特定行的内容 /tholo setline hub 1 <green>Updated line
/tholo insertline <id> <index> <text> 在指定位置插入一行 /tholo insertline hub 2 <yellow>Inserted
/tholo swaplines <id> <idx1> <idx2> 交换两行的位置 /tholo swaplines hub 1 2
/tholo removeline <id> <index> 删除一行 /tholo removeline hub 3
/tholo clearlines <id> 清除全息图的所有行 /tholo clearlines hub

3. 定位与微调

命令 描述 示例
/tholo movehere <id> 将全息图传送至玩家视线高度 /tholo movehere hub
/tholo tp <id> 将玩家传送至全息图位置 /tholo tp hub
/tholo nudge <id> <dir> [amount] 微调位置(up/down/north/south/east/west) /tholo nudge hub up 0.2
/tholo rotate <id> <yaw> [pitch] 设置朝向角度 /tholo rotate hub 90

4. 视觉效果与显示实体属性

命令 描述 示例
/tholo scale <id> <scale> 缩放整个全息图(1.0, 1.5, 0.8) /tholo scale hub 1.2
/tholo linescale <id> <line> <scale> 缩放单行 /tholo linescale hub 1 2.0
/tholo spacing <id> <meters> 调整垂直行间距(米) /tholo spacing hub 0.35
/tholo background <id> <color> 设置背景(transparent, none, #80000000) /tholo background hub transparent
/tholo shadow <id> <true|false> 切换文字阴影 /tholo shadow hub true
/tholo seethrough <id> <true|false> 透视穿墙模式 /tholo seethrough hub true
/tholo billboard <id> <mode> 广告牌模式(CENTER, VERTICAL, FIXED) /tholo billboard hub CENTER
/tholo align <id> <alignment> 文本对齐方式(CENTER, LEFT, RIGHT) /tholo align hub CENTER
/tholo opacity <id> <0-255> 文本透明度等级 /tholo opacity hub 200
/tholo viewdistance <id> <dist> 空间剔除距离(方块单位) /tholo viewdistance hub 48

5. 动态 DNA 与主题

命令 描述 示例
/tholo animation <id> <style> 应用程序化动态 DNA /tholo animation hub ELEGANT
/tholo theme apply <theme> <id> 应用预配置的视觉主题 /tholo theme apply cyberpunk hub
/tholo theme list 列出可用主题(cyberpunk, fire, ice, etc.) /tholo theme list
/tholo template apply <tpl> <id> 实例化预设模板 /tholo template apply discord my_discord
/tholo template list 列出模板(discord, rules, vip, stats, shop) /tholo template list

6. 交互动作

命令 描述 示例
/tholo action add <id> <type> <val> 添加点击动作(command, console, sound, msg) /tholo action add hub command spawn
/tholo action list <id> 列出全息图上配置的所有点击动作 /tholo action list hub
/tholo action clear <id> 移除所有点击动作 /tholo action clear hub

7. 安全、快照与管理

命令 描述 示例
/tholo undo <id> 回滚最后一次修改 /tholo undo hub
/tholo redo <id> 重新应用已撤销的修改 /tholo redo hub
/tholo snapshot <id> <name> 保存命名检查点 /tholo snapshot hub v1
/tholo restore <name> <id> 从快照恢复 /tholo restore v1 hub
/tholo stats 实时诊断(内存、观看者数量、FPS/TPS) /tholo stats
/tholo debug 调试引擎信息(PAPI 钩子、调度器) /tholo debug
/tholo profile <start|stop> 微基准测试执行分析器 /tholo profile start
/tholo reload 重载配置和磁盘存储 /tholo reload

? 开发者 API

THolograms 具备企业级、完全解耦的公共 API。

Gradle (Kotlin DSL)

repositories {
    maven("https://repo.papermc.io/repository/maven-public/")
}

dependencies {
    compileOnly("net.tholograms:tholograms:1.0.0")
}

Maven (pom.xml)

<dependency>
    <groupId>net.tholograms</groupId>
    <artifactId>tholograms</artifactId>
    <version>1.0.0</version>
    <scope>provided</scope>
</dependency>

Java 用法

import net.tholograms.api.THolograms;
import net.tholograms.api.Hologram;
import net.tholograms.animation.MotionStyle;
import org.bukkit.Material;
import org.bukkit.Location;

```java
// 以编程方式创建 3D 复合全息图
Hologram hologram = THolograms.getAPI().builder("hub-welcome")
    .location(player.getLocation().add(0, 1.2, 0))
    .text("<gradient:#FFD700:#FFF3A0><bold>WELCOME TO SKYBLOCK</bold></gradient>")
    .text("<gray>Welcome, <gold>%player_name%</gold>!")
    .item(Material.NETHER_STAR)
    .lineSpacing(0.32f)
    .motion(MotionStyle.ELEGANT)
    .viewDistance(48.0)
    .build();

? 技术规格与基准测试

指标 传统全息图插件 THolograms 引擎
实体技术 盔甲架(大量元数据) 显示实体(文本显示、物品显示、方块显示)
Tick 循环策略 所有实体的重复 Tick 任务 零 Tick 基线(空间网格事件驱动)
Folia 兼容性 ❌ 竞态条件 / 损坏 ✅ 原生 RegionScheduler 与 EntityScheduler
动画开销 服务器每 Tick 进行 CPU 数学计算 客户端插值运动 DNA
点击碰撞箱处理 不可见盔甲架乘客黑客手段 原生 Minecraft 交互实体
JAR 文件大小 2.5 MB – 5.0 MB ~181 KB 纯性能优化
依赖项 需要 ProtocolLib 或 PacketEvents 零必需依赖项

? 权限

  • tholograms.admin — 对 THolograms 所有命令拥有完全管理控制权 (默认:OP)。
  • tholograms.use — 允许玩家与点击碰撞箱交互 (默认:所有玩家为 True)。

THolograms 自豪地作为开源软件,遵循 MIT 许可证。
专为现代服务器社区精确打造。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源