精英全息图

精英全息图

Elite Holograms是一个轻量级的服务器端或单人Minecraft模组，用于创建、管理和自定义浮动文本（全息图）。非常适合服务器信息、排行榜、路径点、动态统计数据、说明和装饰性文本。

装饰

精英全息图预览查看大图

Elite Holograms

Elite Holograms 是一个轻量级的服务端或单人 Minecraft 模组，用于创建、管理和自定义浮动文本（全息投影）。非常适合用于服务器信息、排行榜、路径点、动态统计数据、说明和装饰性文本。

灵感来自 Advanced Holograms。支持 Forge（1.19.2、1.20.1）、Fabric（1.20.1）和 NeoForge（1.21.1、26.1、26.2）。

Fabric 版本需要 Fabric API。Forge 和 NeoForge 版本无需额外依赖。

完整详情请参阅 Wiki。

1.2.0 新增内容

  • Fabric 1.20.1 版本 —— Elite Holograms 现已在 Fabric 上运行，功能集与 Forge 1.20.1 版本相同：全息投影、固定全息投影、物品全息投影、动画行、记分板排行榜、主题、背光、占位符以及所有命令。它需要 Fabric API，仅限服务端，并读取相同的全息投影配置格式，因此世界可以在 Forge 和 Fabric 版本之间迁移而无需任何转换。

  • NeoForge 26.2 版本 —— 在 Minecraft 26.2 上提供完整功能，基于 NeoForge 26.2.0.57 和 Java 25 构建。

  • 固定全息投影 —— 全息投影可以固定到某个朝向，而不是始终转向面对观察者。固定全息投影读起来就像挂在墙上的告示牌，对每个人来说看起来都一样，这正是平贴在建筑上的任何东西所需要的。在任何创建命令中添加 fixed，用 /eh setrotation <id> <yaw> [pitch] 瞄准它，或用 /eh convert <id> fixed 将现有的切换过来。面向玩家仍是默认设置，你已构建的任何内容都不会改变。需要 Minecraft 1.20.1 或更新版本，因此在 Forge 1.19.2 版本上不可用。

  • 居中背光 —— 靠近方块边缘的全息投影过去照明会明显偏向一侧，因为光源方块只能占据整个方块单元。现在光照柱会在需要时扩展到相邻单元，使光晕保持在文本居中位置。

  • 修复：全息投影行可能显示彼此的文本 —— 不同的全息投影实体类型分配了重叠的网络 ID，导致客户端将一行的文本应用到另一行上。

自 1.0 以来的其他新增内容

  • 背光 —— /eh backlight <id> <on|off|toggle> [height 1-10] 在全息投影后方升起一列全亮度的 minecraft:light 方块，使其在夜间保持可读。背光会随全息投影移动，在重启后持续存在，并且从不覆盖玩家的建筑（只有空气和水单元会被点亮）。

  • 记分板主题 —— 使用命名主题重新设计排行榜样式。内置 default、ocean、blood、mono、gold 和 rainbow，均可在 config/eliteholograms/scoreboard_themes.json 中编辑。添加你自己的主题以匹配你的服务器品牌。

  • /eh settheme <id> <theme> —— 立即重新设计现有记分板的样式，无需重新创建。两个参数都支持 Tab 补全。

  • 实时重载 —— /eh reload 从磁盘刷新记分板主题，无需重启服务器。

  • 更智能的 Tab 补全 —— <objective> 参数会建议服务器上注册的每个目标，[theme] 会建议可用的主题名称。

主要功能

  • MiniMessage 与渐变 —— 完整的 Kyori MiniMessage 支持，可在每一行上使用渐变、十六进制颜色、彩虹和丰富格式。旧版 & 代码也可用。

  • 持久化全息投影 —— 在关服时同步保存，重启后依然存在。

  • 简易命令 + Tab 补全 —— 直观的语法，带有针对 ID、目标、主题和显示类型的 Brigadier 建议。

  • 多行管理 —— 添加、插入、删除和设置单独文本行。

  • 物品全息投影 —— /eh createitem <id> <item> <text|line|line> 在标题上方生成一个浮动物品，非常适合商店和展示。

  • 记分板排行榜 —— 显示任意目标的前几名玩家，可自定义行数、刷新间隔和主题。在线和离线玩家都会包含在内，时间和数字目标会自动格式化。

  • 动画行 —— /eh animateline <id> <line#> <interval> <frame1|frame2|...> 按计时器轮换文本，用于倒计时、提示和公告。

  • 背光 —— 在夜间为全息投影提供照明，而不影响周围建筑。

  • 固定全息投影 —— 将全息投影固定到某个朝向，使其读起来像墙上的告示牌（1.20.1 及更新版本）。

  • 位置控制 —— 在你所在位置或指定坐标创建，传送到任意全息投影，并用 /eh movevertical 垂直微调。

  • 高级权限 —— 支持 LuckPerms 和 FTB Ranks，带有 OP 等级 2 回退和细粒度节点。

  • 内置占位符系统 —— 实时服务器和玩家统计数据，无需外部 API。

  • 附近发现 —— /eh near 显示你周围的全息投影。

  • 性能优化 —— 独立的管理线程、优雅关闭、极低开销。

  • 跨平台且仅限服务端 —— Forge 1.19.2、Forge 1.20.1、Fabric 1.20.1、NeoForge 1.21.1、NeoForge 26.1 和 NeoForge 26.2。玩家使用原版客户端加入，该模组也可在单人游戏中独立运行。

快速命令参考

每个创建命令都会在子命令后立即接受一个可选的 fixed 或 facing 关键字。省略它，你就会得到一个面向玩家的全息投影，这是默认设置。

创建

  • /eh create <id> <text...> —— 在你所在位置创建全息投影

  • /eh createat <id> <x> <y> <z> [text...] —— 在指定坐标创建一个

  • /eh createitem <id> <item> <text|line|line> —— 创建一个顶部带有浮动物品的全息投影

  • /eh createscoreboard <id> <objective> [topCount] [interval] [theme] —— 从记分板目标创建排行榜

行

  • /eh addline、/eh setline、/eh insertline、/eh removeline —— 管理单独的行

  • /eh animateline <id> <line#> <interval> <frame1|frame2|...> —— 按计时器为一行添加动画

外观

  • /eh settheme <id> <theme> —— 重新设计现有记分板全息投影的样式

  • /eh backlight <id> <on|off|toggle> [height 1-10] —— 切换全息投影后方的光照柱

  • /eh convert <id> fixed|face —— 在全息投影的固定和面向玩家之间切换

  • /eh setrotation <id> <yaw> [pitch] —— 瞄准固定全息投影（yaw 0 南、90 西、180 北、270 东）

位置

  • /eh movehere <id> —— 将全息投影移动到你的位置

  • /eh movevertical <id> <up|down> <amount> —— 将其向上或向下微调，例如 up 1.5

  • /eh teleport <id> —— 传送到全息投影

浏览和管理

  • /eh list、/eh near [page]、/eh info <id> —— 浏览和检查全息投影

  • /eh delete <id> —— 删除全息投影

  • /eh reload —— 从存储中重载全息投影和主题

占位符亮点

无需外部 API。占位符实时更新，包括按观察者区分的玩家值。

服务器范围

  • %players%、%maxplayers%、%tps%、%uptime%、%memory%、%server_time%

玩家专属

  • %player%、%player_rank%、%player_health%、%player_level%、%player_world%、%player_coords%、%player_gamemode%

示例：

/eh create welcome <gradient:#00FFA3:#00B7FF>Welcome %player%!</gradient>
/eh addline welcome &7Your rank: &e%player_rank%
/eh addline welcome &7Online: &a%players%&7/&a%maxplayers%  TPS: &a%tps%

权限概览

  • 与 LuckPerms 和 FTB Ranks 集成，当两者均不存在时回退到 OP 等级 2。控制台和命令方块始终拥有完全访问权限。

  • 关键节点：eliteholograms.create、eliteholograms.delete、eliteholograms.edit、eliteholograms.list、eliteholograms.info、eliteholograms.near、eliteholograms.teleport、eliteholograms.backlight、eliteholograms.admin。

  • 有关分组设置和示例，请参阅 权限指南。

安装

  1. 下载与你的加载器和 Minecraft 版本匹配的构建。

  2. 将 JAR 放入你的 mods 文件夹。你的单人游戏实例、整合包或服务器都以相同方式运行。

  3. 仅限 Fabric： 还需安装 Fabric API。没有它，Fabric 构建将无法加载。

  4. （可选） 在服务器上安装 LuckPerms 或 FTB Ranks 以获得细粒度权限。

  5. 启动游戏或重启服务器，然后运行 /eh create 开始使用。

截图：

Elite Holograms

Elite Holograms in action

专为 Forge 1.19.2 / 1.20.1、Fabric 1.20.1 和 NeoForge 1.21.1 / 26.1 / 26.2 设计。