跳到主要内容

常见问题

显示​

看板不显示？​

依序检查：

  1. 看板有载入吗？ /clh list 找得到名称吗？找不到：
    • 文件名只能用英文字母、数字、_、-，副文件名 .yml，否则会被跳过。
    • /clh validate 看有没有格式错误：文件名、location 格式、旗标拼错、动作写错等都会列出来。
    • /clh reload 后看控制台有没有「读取失败」或「location 写成」开头的讯息（会写出是哪个文件、错在哪里；写错的看板会被跳过，其他看板照常载入）。
    • 授权版还没通过验证时，所有看板都不会载入（/clh 会提示「授权尚未验证」），见下方「授权」。
  2. 看板启用了吗？ /clh info <看板> 看「启用」是不是 true，不是就 /clh enable <看板>。
  3. 你在显示范围内吗？ 默认 48 格内、同一个世界才看得到。/clh info 可以看「显示范围」与位置。
  4. 有权限限制吗？ /clh info 有显示「权限」的话，你要有那个权限才看得到。
  5. 世界名称对吗？ 文件里 location 的世界名称写错、或那个世界没有载入，看板会一直等待，不会出现。/clh validate 会在最后列出「所在的世界还没载入」的看板，可以从这里检查世界名称。
  6. 看板是空的吗？ 当前这一页没有任何行时不会显示。

开服后看板过一阵子才出现？​

看板所在的世界如果是由多世界插件稍后载入的，云全息会等那个世界载入完成才显示看板，这是正常的。 世界被卸载时看板会自动停用，重新载入后自动恢复。

MiniMessage 标签原样显示（看到 <gradient:…> 这种文字）？​

  • MiniMessage 需要 Paper / Purpur 1.18.2 以上。Spigot 或更旧的版本请改用 & 颜色代码与 &#RRGGBB。 开服时控制台会写出 支持 MiniMessage 或 使用颜色代码模式（服务器没有 MiniMessage），看一眼就知道。
  • 标签拼错或没有关闭也会原样显示，例如 <gradient:#FF0000>（只有一个颜色）。
  • 写在看板文件里时，以 <、&、# 开头的文字要整段加单引号：- '<gold>金色</gold>'。

写法见 颜色与格式。

中文变成乱码 / 问号？​

看板文件、lang.yml、config.yml 都要存成 UTF-8。Windows 记事本旧版本默认存 ANSI，请改用 VS Code、Notepad++ 等编辑器，「另存为 UTF-8」后 /clh reload。 用指令输入的中文不会有这个问题。

文字到了晚上或洞穴里会变暗吗？​

不会。1.19.4+ 的文字行使用 TextDisplay，固定为最亮，白天晚上、地面洞穴看起来都一样。 另外 TextDisplay 文字不会隔着方块显示。

设了背景颜色 / 阴影，但没有作用？​

  • 背景与阴影只有 1.19.4 以上才有，旧版本的文字行是隐形盔甲架，没有背景可调。
  • config.yml 的 text-display-lines 必须是 true（改完要重启）。
  • 只对文字行有效，物品、头颅、实体行没有背景。
  • background-opacity 是 0 时背景完全透明，看起来就像没设定。

见 背景与阴影。

我有那一行的权限了，还是看不到那一行？​

单行的权限是在看板显示给你的那一刻检查的。拿到权限之后，走出显示范围再走回来、翻一页，或管理员执行 /clh reload，那一行就会出现。 看板本身的权限则是每秒检查，会自动出现。

玩家重新进服后，看板回到第 1 页？​

是的。每个玩家看到第几页只记在内存里，玩家退出或执行 /clh reload 后都会回到第 1 页。

点击​

点击看板没有反应？​

  1. 这一页有设点击动作吗？ 点击是设在页上的，第 1 页有、第 2 页没有，翻到第 2 页就点不了。/clh page actions <看板> <页> <按键> 可以查看。
  2. 看板有 DISABLE_ACTIONS 旗标吗？ 有的话所有点击都不会执行。见 旗标。
  3. 离太远了吗？ 水平距离要在看板位置点 5 格以内。
  4. 点到看板了吗？ 文字本身没有碰撞箱，点击判定靠的是隐藏在看板位置的隐形盔甲架（从看板最底部往上堆）。对准看板中间偏下的地方点比较准。
  5. 动作被中途挡掉了吗？ permission: 动作检查不通过时，后面的动作都不会执行；teleport: 的坐标写错也会让后面的动作停止。
  6. player: 指令没效果？ player: 是让玩家自己执行指令，玩家要有那个指令的权限。需要管理员权限的指令请用 console:。

动作写法见 点击动作。

点一下，动作执行了两次 / 玩家一直狂点？​

把 config.yml 的 click-cooldown 调大（单位 tick，10 = 半秒），所有看板共用这个冷却。

变量与更新​

PlaceholderAPI 变量没有被替换（原样显示 %xxx%）？​

  • 安装 PlaceholderAPI，并下载那个变量需要的 expansion，例如 %player_name% 需要 /papi ecloud download Player，然后 /papi reload。
  • 看板或那一行有 DISABLE_PLACEHOLDERS 旗标的话不会解析。
  • 变量写在 动画 帧里时，需要开启 config.yml 的 allow-placeholders-inside-animations。

变量有显示，但不会更新？​

  • update-interval 决定多久刷新一次（20 tick = 1 秒），太大就会很久才变。
  • 你离看板超过 update-range 时，内容会停在旧的值。
  • 看板有 DISABLE_UPDATING 旗标时完全不会刷新。

这三个设定的关系见 基本概念。

看板很多，会不会卡？​

看板本身只用封包显示，不会在世界里生成真的实体。如果数量很多又有很多变量：

  • 静态看板（内容不会变）加上 DISABLE_UPDATING 旗标。
  • 不需要即时的变量，把 update-interval 调大（例如 100 = 5 秒）。
  • 把 update-range 调小，只有靠近的玩家才更新。
  • 不需要的话，保持 allow-placeholders-inside-animations: false。

文件​

改了看板文件，没有生效？​

直接改文件后要执行 /clh reload。建议先 /clh validate 检查格式，有错会列出文件与原因。见 看板文件。

我手动改的内容不见了？​

手动改了文件、还没 /clh reload，就用指令修改了同一个看板，插件存档时会用内存里的旧内容覆盖文件。 以后请先 /clh reload，再用指令。另外，存档会把文件改写成固定格式，部分注释可能会消失。

看板名称可以用中文吗？​

不行。看板名称（也就是文件名）只能用英文字母、数字、_、-。看板内容可以用任何中文。

安装与搬迁​

可以和 DecentHolograms 同时安装吗？​

不行。云全息内置了完整的 DecentHolograms 核心，两个同时安装会互相冲突。请只保留云全息，移除 DecentHolograms 的 jar。 换过来的步骤见 从其他插件转换。

依赖 DecentHolograms 的插件还能用吗？​

可以。云全息声明了 provides: [DecentHolograms]，而且保留了 DecentHolograms 原本的 API，需要 DecentHolograms 前置的插件（商店、排行榜、任务插件等）不用改就能用。 开发者见 开发者 API。

之前用的是旧全息插件，换成云全息后看板会不见吗？​

不会。第一次安装云全息（plugins/CloudHologram/ 还不存在）时，会自动从旧插件的文件夹复制 holograms、animations、displays，旧文件夹保持不动。 详细规则见 从其他插件转换。

授权码填在哪？控制台说无法连接授权服务器？​

授权码填在 plugins/CloudHologram/token.yml，填好后重启。没有通过验证前插件会正常启动，但不会载入看板。 连不上授权服务器时插件每 60 秒自动重试，连上后直接载入看板。连线问题的排查表见 安装与获取。

怎么备份？怎么搬到另一台服务器？​

需要的东西都在 plugins/CloudHologram/：

复制内容
holograms/所有看板（最重要）
animations/自定义动画
displays/Display 实体
config.yml、lang.yml设定与提示文字

搬到新服务器时：

  • 先关服再复制，避免复制到写到一半的文件。
  • 看板用世界名称记录位置，新服务器的世界名称不同时，要把看板文件里 location 的世界名称改掉，否则看板不会出现。
  • token.yml 的授权会绑定机器。换了机器后如果验证失败，控制台会写出原因与本机机器码，照提示到会员中心处理。
最后于 更新