精英全息投影

精英全息影像（Elite Holograms）

Elite Holograms 是一个轻量级的 Minecraft 模组，允许你直接在游戏内通过命令创建、管理和自定义浮动文本（全息影像）。非常适合用于服务器信息、排行榜、路标、商店、实时统计、规则和装饰性文字。

支持单人世界、整合包以及多人服务器。该模组仅在服务端运行，因此服务器上的玩家即使使用原版客户端也能看到所有内容。无需外部占位符 API，无需繁琐配置。只需放入即可开始构建。

灵感来源于 Advanced Holograms。支持 Forge（1.19.2， 1.20.1）和 NeoForge（1.21.1， 26.1）。

完整的设置和命令详情，请参阅 Wiki。

为什么选择 Elite Holograms？

• 随处可用 - 支持单人世界、整合包和多人服务器。
• 仅需服务端 - 在服务器上，玩家可使用原版客户端加入并看到所有内容。
• 整合包友好 - 可直接放入任何 Forge 或 NeoForge 整合包，无需客户端设置。
• 无依赖要求 - 内置占位符系统，无需 PlaceholderAPI。
• 持久化存储 - 全息影像在关闭时进行安全的同步保存，重启后可保留。
• 开箱即美 - 支持 MiniMessage 渐变、十六进制颜色和彩虹效果，适用于每一行。
• 为服务器而生 - 在独立的管理线程上运行，优雅关闭，开销极小。

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 可在标题上方生成一个浮动物品，非常适合商店和展示柜。
• 计分板排行榜 - 显示任意计分项中的顶尖玩家，支持自定义显示行数、刷新间隔和主题。包含在线和离线玩家；时间和数值型计分项会自动格式化。
• 动画行 - 按定时器轮换文本，可用于倒计时、提示和公告。
• 背光 - 夜间照亮全息影像，且不触碰周围建筑方块。
• 位置控制 - 在当前位置创建，传送至任意全息影像，并通过 /eh movevertical 进行垂直微调。
• 内置占位符 - 无需外部 API，即可实时获取服务器和玩家统计信息。
• 高级权限 - 与 LuckPerms 和 FTB Ranks 集成，若无上述模组则回退到 OP 等级 2，支持细粒度权限节点。
• 全面的 Tab 补全 - 为 ID、计分项、主题等提供 Brigadier 建议。
• 附近发现 - /eh near 列出你周围的全息影像。
• 跨平台 - 支持 Forge 1.19.2、Forge 1.20.1、NeoForge 1.21.1 和 NeoForge 26.1，适用于单人游戏、整合包或服务器。

命令参考

命令	描述
/eh create <id> <text...>	在你的位置创建一个全息影像
`/eh createitem <text	line
/eh createscoreboard <id> <objective> [topCount] [interval] [theme]	从计分板计分项创建排行榜
/eh settheme <id> <theme>	为现有的计分板全息影像重新设置样式
/eh addline | setline | insertline | removeline ...	管理单行文本
/eh animateline <id> <line#> <interval> <frame1|frame2|...>	按定时器动画化一行文本
/eh backlight <id> <on|off|toggle> [height 1-10]	切换全息影像后方的光柱
/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。控制台和命令方块始终拥有完整权限。

细粒度的权限节点让你可以精确分配权限，而无需授予玩家管理员（OP）身份：

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， NeoForge 1.21.1 / 26.1）。
2. 将 JAR 文件放入你的 mods 文件夹 - 单人游戏实例、整合包或服务器的操作方式相同。
3. （可选）在服务器上安装 LuckPerms 或 FTB Ranks 以获得细粒度权限。
4. 启动游戏或重启服务器，然后运行 /eh 开始使用。

为 Forge 1.19.2 / 1.20.1 和 NeoForge 1.21.1 / 26.1 构建。