Elite Holograms

精英全息显示

Elite Holograms是一款轻量级 Minecraft 模组，可直接通过游戏内命令创建、管理和自定义悬浮文字（全息显示）。非常适合展示服务器信息、排行榜、路径点、商店、实时统计、规则和装饰性文字。

可用于单人世界、整合包和多人服务器。它仅在服务端运行，因此在服务器上，玩家使用原版客户端加入也能看到所有内容。无需外部占位符 API，省心省事。安装后即可开始搭建。

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

完整的安装说明和命令详情，请参阅Wiki。

为什么选择 Elite Holograms？

• 随处可用：支持单人世界、整合包和多人服务器。
• 仅在服务端运行：玩家使用原版客户端加入服务器，也能看到所有内容。
• 适合整合包：可直接放入任何 Forge、Fabric 或 NeoForge 整合包，无需在客户端进行设置。
• 几乎没有依赖：内置占位符系统，无需 PlaceholderAPI。只有 Fabric 版本需要额外组件，而且只需要 Fabric API。
• 持久保存：关闭服务器时会安全、同步地保存，全息显示在重启后依然保留。
• 开箱即用，效果出众：每行都支持 MiniMessage 渐变、十六进制颜色和霓虹彩虹效果。
• 专为服务器打造：使用独立的管理线程运行，支持平稳关闭，资源开销极低。

1.3.0 版本新增内容

• 可点击全息投影： /eh click <id> set <command...>可让全息投影在玩家右键点击时运行命令，console <command...>则会以提升权限运行命令，适用于玩家无法自行使用的传送和套装。%player%会替换为点击者的名称。以前需要告示牌和压力板实现的功能，现在都可以用全息投影完成。它适用于固定的和面向玩家的全息投影，无需客户端模组；console则受管理员权限限制，无法用来发放管理员命令。Forge 1.19.2 暂不支持。
• /eh display <id> scale <0.1-10>：

  调整固定全息投影的文字大小。行距会随缩放比例增大，因此放大的全息投影不会出现行间重叠。

• /eh display <id> brightness <0-15|auto>：让文字不受周围光照影响，始终保持明亮。15让全息投影在夜间也清晰可读，无需在世界中放置任何方块——对大多数人来说，这正是背光功能的用途。
• /eh display <id> billboard <fixed|vertical|horizontal|center>：控制固定全息投影的转向方式。vertical尤其值得一提：文字会随玩家水平转动，但不会倾斜，因此从任何方向看都清晰可读；即使有人从上方飞过，文字也不会平躺下来。
• 已修复：记分板全息投影重启后样式丢失：排行榜单独保存在一个文件中，而 Forge 1.20.1 和 Fabric 版本此前不会将背景设置写入该文件，因此重新设置样式的排行榜在重启后会恢复默认。现在，排行榜会像其他全息投影一样保留背景、缩放比例、亮度、朝向和点击命令。
• 防崩溃保存：每次保存都会写入完整文件，并以原子方式替换旧文件，同时保留旧版本作为备份。崩溃或断电不再会导致全息投影文件丢失或只写入一部分；如果文件损坏，系统会自动从备份恢复

• 不会擅自删除任何内容：

• /eh reload位于未加载维度中的全息投影或记分板（例如移除了添加该维度的模组后）会原封不动地保存在文件中，并在维度重新出现时恢复。以前，它们会在下次保存时被删除。

  加载手动编辑的内容：

• 以前会先保存内存中的内容，覆盖掉原本要加载的手动编辑内容。

  现在删除最后一个记分板后，删除结果会保留：

• 以前它会在下次重启时重新出现。

  /eh addline控制台和命令方块：setline、insertline、removeline、delete和info现在都能在 Forge 和 Fabric 的控制台及命令方块中使用，符合文档说明。

1.2.1 版本更新内容

• /eh background <id> ...：

  重新设置固定全息投影文字背板的样式。原版会将其绘制为不透明度 25% 的黑色；现在，colour <name or #RRGGBB>可更改背板颜色，opacity <0-100>可设置不透明程度，none可完全移除背板，让文字不带方框地悬浮显示，reset则可恢复原版外观。

• Forge 1.19.2 命令一致性修复： /eh backlight、/eh settheme、/eh list和/eh movevertical在该版本中被重复注册，最终生效的是最后一次注册，因此尽管这些命令已包含在模组中，其中一些仍会提示“未知命令”。现在，全部 23 个子命令都能通过同一个注册表正确解析。
• 已修复：fixed和facing被并入全息投影文字： /eh create shop fixed Welcome会生成文字为“fixed Welcome”的全息投影。现在，所有创建命令都能正确识别这两个关键词。

1.2.0 版本更新内容

• 全新 Fabric 1.20.1 版本：Elite Holograms 现已支持 Fabric，功能与 Forge 1.20.1 版本相同：全息投影、固定全息投影、物品全息投影、动态文本行、计分板排行榜、主题、背光、占位符以及所有命令。此版本需要 Fabric API，仅需安装在服务器端，并使用相同的全息投影配置格式，因此世界可在 Forge 与 Fabric 版本之间切换，无需转换任何内容。权限通过 LuckPerms 或 FTB Ranks 管理；若未配置，则使用 OP 等级 2。
• 全新 NeoForge 26.2 版本：在 Minecraft 26.2 上提供完整功能，基于 NeoForge 26.2.0.57 和 Java 25 构建。
• 固定全息投影：现在可将全息投影固定为特定朝向，不再始终转向观看者。固定全息投影看起来就像挂在墙上的告示牌，所有人看到的效果都相同，适合用于贴合建筑表面安装的内容。在任意创建命令中加入 fixed（/eh create fixed <id> <text>），使用 /eh setrotation <id> <yaw> [pitch] 调整朝向，或使用 /eh convert <id> fixed 将现有全息投影切换为固定模式。默认仍为朝向玩家，已有建筑不会受到影响。需要 Minecraft 1.20.1 或更新版本，因此 Forge 1.19.2 版本不支持此功能。
• 居中背光：全息投影靠近方块边缘时，过去的照明会明显偏向一侧，因为光照方块只能放置在完整的方块格中。现在，必要时光照区域会延伸至相邻方块格，让文字周围的光效保持居中。
• 已修复：全息投影文本可能相互串行：不同类型的全息投影实体会分配到重叠的网络 ID，导致客户端将一行的文本显示到另一行上。

1.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 自动补全。
• 更智能的 Tab 自动补全：<objective> 参数现在会列出服务器上注册的所有目标，[theme] 则会列出可用主题名称。
• 实时重载：/eh reload 可从磁盘重新加载计分板主题，无需重启服务器。
• NeoForge 26.1 版本：在 Minecraft 26.1 上提供完整功能，基于 Java 25 构建。

主要功能

• MiniMessage 与渐变：全面支持 Kyori MiniMessage 渐变、十六进制颜色、彩虹效果和丰富格式，每一行都适用（旧版 & 代码也可使用）。
• 持久全息文字：重启后仍会保留，并在关闭时同步保存。
• 多行管理：可添加、插入、设置和删除单独的行。
• 物品全息展示： /eh createitem在说明文字上方生成悬浮物品，非常适合商店和展示区。
• 计分板排行榜：显示任意计分板目标中的顶尖玩家，并可自定义行数、刷新间隔和主题。包含在线和离线玩家；时间和数值目标会自动格式化。
• 动态行：按计时轮换文本，适用于倒计时、提示和公告。
• 背光：夜间照亮全息文字，不影响周围建筑。
• 固定全息文字：将全息文字固定在特定旋转角度，使其像墙上的告示牌一样显示（1.20.1+）。
• 可点击全息文字：玩家右键点击全息文字时执行命令，可由玩家执行，也可由拥有更高权限的控制台执行（1.20.1+）。
• 显示控制：缩放固定全息文字、调整亮度（无需放置方块）、更改文字背板颜色，并选择其朝向观看者的方式。
• 位置控制：在当前位置创建、传送到任意全息文字，并使用 /eh movevertical 垂直微调位置。
• 内置占位符：无需外部 API，即可显示实时服务器和玩家统计数据。
• 高级权限：集成 LuckPerms 和 FTB Ranks，并支持 OP 等级 2 回退方案和细粒度权限节点。
• 全命令补全：通过 Brigadier 提供 ID、目标、主题等内容的建议。
• 附近发现： /eh near列出你附近的全息文字。
• 跨平台：支持 Forge 1.19.2、Forge 1.20.1、Fabric 1.20.1（需要 Fabric API）、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 background <id> <colour|opacity|none|reset>：重新设置固定全息文字文本背板的样式
• /eh display <id> <scale|brightness|billboard|reset>：调整固定全息文字的大小、亮度或转向方式

交互

• /eh click <id> set <command...>：以点击玩家的身份运行命令
• /eh click <id> console <command...>：以管理员权限运行（需要管理员权限）
• /eh click <id> none：禁止点击全息图

位置

• /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%

权限

Elite Holograms 会自动检测 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 版本对应的构建版本（Forge 1.19.2 / 1.20.1、Fabric 1.20.1、NeoForge 1.21.1 / 26.1 / 26.2）。
2. 将 JAR 文件放入你的mods文件夹。单人游戏实例、整合包或服务器的安装方式都相同。
3. 仅限 Fabric：还需安装Fabric API。没有它，Fabric 版将无法加载。Forge 和 NeoForge 版无需安装其他内容。
4. （可选）在服务器上安装 LuckPerms 或 FTB Ranks，以使用细粒度权限。
5. 启动游戏或重启服务器，然后运行/eh create即可开始使用。

适用于 Forge 1.19.2 / 1.20.1、Fabric 1.20.1，以及 NeoForge 1.21.1 / 26.1 / 26.2。