安装与获取
下载与授权（免费）
- 打开 资源中心，注册并登录。
- 在 CloudHologram 云全息 点「免费领取」，永久授权码会加入你的会员中心。
- 打开详情，下载最新的
CloudHologram-<版本>-簡體授權版.jar。
运行环境
| 项目 | 要求 |
|---|---|
| 服务端 | Spigot / Paper / Purpur 1.8.8 – 26.x（26.x 需要 Java 25） |
| 前置插件 | 无 |
| 可选 | PlaceholderAPI（变量）、HeadDatabase（#HEAD: PLAYER_HEAD (HEADDATABASE_<编号>) 头颅，见 行类型） |
| 文字背景与阴影 | 需要 1.19.4+；更旧的版本自动使用盔甲架文字，其余功能相同。见 背景与阴影 与 基本概念 |
| MiniMessage | 需要 Paper / Purpur 1.18.2+；Spigot 或更旧的版本使用 & 颜色代码与 &#RRGGBB，见 颜色与格式 |
| Display 实体 | 需要 1.19.4+，见 Display 实体 |
| 不支持 | Folia |
实机测试过的版本：1.8.8、1.12.2、1.16.5、1.20.4、1.20.6、1.21.4、1.21.11、26.3。
全新安装
- 把插件放进
plugins/，启动服务器。 - 打开
plugins/CloudHologram/token.yml，填入授权码，重启（首次启动自动绑定本机）。 - 输入
/clh help，看到指令列表就成功了。接着照 建立第一个看板 动手做一个；想先弄懂看板 、页、行是什么，看 基本概念。
还没填授权码时
插件会正常启动，但不会载入看板，/clh 指令只会提示领取方式。填好授权码后重启即可；
如果是开服时连不上授权服务器，插件会每 60 秒自动重试，连上就立刻载入看板，不需要重启。
控制台显示「无法连接授权服务器」
第一次启动必须连上 license.plugins.wiki 验证一次，之后断网也能离线运行 72 小时。控制台会写出原因：
| 原因 | 处理 |
|---|---|
| DNS 解析不到 | 换 DNS（例如 223.5.5.5 / 119.29.29.29）后重启 |
| 连线被拒绝或无法建立 | 主机商 / 面板的防火墙放行对外 HTTPS； 本机电脑检查杀毒软件是否拦截 java.exe |
| 连线超时 | 网络太慢或被拦截；稍后会自动重试 |
| HTTPS 握手失败 | 关闭会拦截 HTTPS 的代理或网络设备；插件也会自动改用 HTTP 验证（回应带数字签名，安全性不受影响） |
本机电脑如果是靠加速器 / 代理（例如 Clash）才打得开网站：浏览器会走代理，但 Java 不会。请开启加速器的「TUN / 虚拟网卡」模式，
或在启动参数加 -Djava.net.useSystemProxies=true。
从 DecentHolograms 换过来
云全息内置完整的 DecentHolograms 核心，看板文件格式完全相同，而且声明了 provides: DecentHolograms，
依赖 DecentHolograms 的插件（例如用它显示文字的商店、排行榜插件）不需要改任何东西。
- 关服，备份
plugins/DecentHolograms/（好习惯）。 - 放入 CloudHologram，移除 DecentHolograms 的 JAR（两个不能同时安装）。
- 开服。第一次启动时（
plugins/CloudHologram/还不存在），云全息会自动复制旧文件夹里的看板：
[CloudHologram] 已从 plugins/DecentHolograms 复制看板、动画与 Display（原文件夹保留不动）。确认没问题后可以删除旧的全息插件 jar。
/clh list确认看板都在，/clh validate检查格式。
| 会复制 | 说明 |
|---|---|
holograms/ | 全部看板 |
animations/ | 自定义动画 |
displays/ | Display 实体（2.10 新功能） |
config.yml | 另存为 config-old.yml 供对照；新的 config.yml 使用中文注释的默认值，需要的设定请自己搬过去 |
lang.yml 不会复制，新的提示文字全部是中文。指令 /dh 仍然可以用，习惯的写法不用改。
用的是别的全息插件？
/clh convert <插件> 可以从 CMI、HolographicDisplays、FutureHolograms、GHolo、Holograms 转换看板（CMI、FutureHolograms、Holograms 只支持部分功能）。步骤见 从其他插件转换。
文件说明
| 路径 | 用途 |
|---|---|
config.yml | 默认值、点击冷却、伤害 / 治疗显示、自定义文字替换，见 设定 |
lang.yml | 所有提示文字，可以自己修改，见 lang.yml |
holograms/*.yml | 一个看板一个文件，见 看板文件 |
animations/*.yml | 自定义文字动画，见 动画 |
displays/ | Display 实体（/clh d）的资料 |
examples/ | 范例看板，不会自动载入；复制到 holograms/ 才会显示 |
token.yml | 授权码 |
升级
- 关服，备份
plugins/CloudHologram/（好习惯）。 - 删掉旧的 JAR，放入新的
CloudHologram-<版本>-簡體授權版.jar。 - 开服。看板、动画、Display 与授权码都会保留。
升级时设定文件的处理方式：
| 文件 | 新版本新增的项目 |
|---|---|
config.yml | 不会写进你现有的 config.yml。没写的项目直接使用默认值，功能照常；想调整 就自己把键加进去（键名与默认值见 config.yml），或把文件改名后 /clh reload 产生一份带注释的新文件，再把旧设定搬回去。 |
lang.yml | 缺少的提示文字会自动补进 lang.yml，你改过的文字保持不变。 |
每个版本改了什么见 更新记录。