看板指令 `/clh hologram …`

这一组指令管理「整个看板」：建立、删除、复制、改名、移动、对齐、显示范围、权限等。要改看板里某一行的内容，请看行指令；要加页或点击动作，请看页指令。

写法：/clh hologram <子指令> …，hologram 可以换成别名 holograms、holo、h，例如 /clh h info welcome。
子指令名称不分大小写；看板名称区分大小写（Welcome 和 welcome 是两个看板）。
<> 必填，[] 选填。页码、行号都从 1 开始。
参数不够时，插件会回一句「用法：…」，显示该指令的完整写法。

权限是一层一层检查的

执行 /clh hologram create 时，插件依序检查：主指令权限（dh.default，默认所有人都有）→ 群组权限 dh.command.holograms → 子指令自己的权限（例如 dh.command.holograms.create）。少任何一层都会提示「你没有权限使用此功能」。拥有 cloudhologram.admin（或 dh.admin）的人会直接通过所有检查。下面的「快捷写法」（例如 /clh create）跳过了群组这一层，只需要子指令自己的权限。完整权限表见权限。

指令一览

指令	作用
`/clh hologram help`	列出本组全部指令
`/clh hologram create`	建立新看板
`/clh hologram delete`	删除看板（连文件一起删）
`/clh hologram clone`	复制一个看板
`/clh hologram rename`	改名
`/clh hologram enable`	启用（重新显示）
`/clh hologram disable`	停用（隐藏，但保留）
`/clh hologram info`	查看看板资料
`/clh hologram lines`	列出某一页的所有行
`/clh hologram teleport`	传送到看板
`/clh hologram near`	列出附近的看板
`/clh hologram move`	移到指定坐标
`/clh hologram movehere`	移到你的位置
`/clh hologram center`	对齐到方块中心
`/clh hologram align`	和另一个看板对齐
`/clh hologram setfacing`	设定朝向
`/clh hologram downorigin`	切换「从下往上排」
`/clh hologram setdisplayrange`	设定显示范围
`/clh hologram setupdaterange`	设定更新范围
`/clh hologram setupdateinterval`	设定更新间隔
`/clh hologram setpermission`	设定观看权限
`/clh hologram addflag`	加旗标
`/clh hologram removeflag`	移除旗标
`/clh hologram update`	重新发送给所有玩家

快捷写法

下面 12 个最常用的子指令，可以省略 hologram，直接写在 /clh 后面。效果完全一样，别名也一样能用：

快捷写法	等同于
`/clh create`（`c`、`new`）	`/clh hologram create`
`/clh delete`（`del`、`remove`、`rem`）	`/clh hologram delete`
`/clh clone`（`copy`）	`/clh hologram clone`
`/clh enable`（`on`） / `/clh disable`（`off`）	`/clh hologram enable` / `disable`
`/clh align`	`/clh hologram align`
`/clh center`	`/clh hologram center`
`/clh info`	`/clh hologram info`
`/clh near`	`/clh hologram near`
`/clh teleport`（`tp`、`tele`）	`/clh hologram teleport`
`/clh move`（`mv`） / `/clh movehere`（`mvhr`）	`/clh hologram move` / `movehere`

rename、lines、setfacing 等其余子指令没有快捷写法，必须写完整的 /clh hologram …（或 /clh h …）。

/clh hologram help

在聊天栏列出本组全部子指令的用法和说明，最后一行列出群组别名。

项目	内容
用法	`/clh hologram help`
权限	`dh.command.holograms.help`
别名	`?`
控制台	可以

/clh help 不会列出看板指令（它只列通用指令），想看看板指令要用这一条。

例子

/clh hologram help
/clh h ?

/clh hologram create

建立一个新看板，并放上第一行。看板会立刻显示，并存成 plugins/CloudHologram/holograms/<名称>.yml。

项目	内容
用法	`/clh hologram create <名称> [-l:世界:x:y:z] [--center] [内容]`
权限	`dh.command.holograms.create`
别名	`c`、`new`（也可以直接打 `/clh create`）
控制台	可以，但必须写 `-l:` 指定位置

参数	必填	说明
`<名称>`	是	只能用英文字母、数字、`_`、`-`（规则是 `[a-zA-Z0-9_-]+`），不能有中文和空格；已存在的名称不能再用
`-l:世界:x:y:z`	否	指定位置。不写就放在你的位置；也可以多写两段 `:yaw:pitch`
`--center`	否	把 X、Z 移到所在方块的正中心（Y 不变）
`[内容]`	否	第一行的内容，可以有空格；不写就用 `config.yml` 的 `defaults.text`（默认「空白行」）。格式见行类型

不写 -l: 时，默认放在你脚下；config.yml 里 holograms-eye-level-positioning: true 会改成放在眼睛高度。
-l: 和 --center 可以写在内容前后任何位置，插件会把它们挑出来，剩下的才当作内容。
-l: 的世界名写错或坐标不是数字时，这段文字不会被当成位置，而是变成第一行内容的一部分（控制台会有解析警告）。看到看板上出现 -l:… 字样就是这个原因。
名称不合法：名称 'xxx' 无效，只能使用英文字母、数字、下划线和短横线。；名称重复：该名称的看板已存在。
内容里的 <HAND>（手持物品）在 create 里不会被替换，只有 line add/insert/set 和 page add 支持。
内容的 Tab 补全：输入 #ICON:、#HEAD:、#SMALLHEAD: 后按空格，下一个参数会补全物品名称；#ENTITY: 后会补全实体类型。

例子

/clh create welcome                                   # 在脚下建立，第一行是默认文字
/clh create welcome &b欢迎来到 &f云海服务器              # 指定第一行内容
/clh create spawn_board --center -l:world:0:101.5:0 &e出生点  # 控制台也能用，并对齐方块中心
/clh create shop_icon #ICON: DIAMOND_SWORD            # 第一行是会转动的物品

/clh hologram delete

删除看板：立刻从所有玩家眼前消失，并删掉 holograms/ 里的文件。不能复原。

项目	内容
用法	`/clh hologram delete <看板>`
权限	`dh.command.holograms.delete`
别名	`del`、`remove`、`rem`（也可以直接打 `/clh delete`）
控制台	可以

参数	必填	说明
`<看板>`	是	要删除的看板名称（Tab 可补全）

只想暂时隐藏，请用 disable，资料会保留。

例子

/clh delete old_notice
/clh h del test_board

/clh hologram clone

把一个看板（含所有页、行、点击动作、旗标、权限、朝向、范围等设定）复制成新看板。

项目	内容
用法	`/clh hologram clone <看板> <新名称> [temp] [-l:世界:x:y:z]`
权限	`dh.command.holograms.clone`
别名	`copy`（也可以直接打 `/clh clone`）
控制台	可以，但必须写 `-l:` 指定位置

参数	必填	说明
`<看板>`	是	来源看板
`<新名称>`	是	新看板名称，规则同 `create`，不能和已有看板重名
`[temp]`	否	`true` = 临时副本，不存文件；`false` 或不写 = 正常存档
`-l:世界:x:y:z`	否	副本的位置；不写就放在你的位置（脚下或眼睛高度，同 `create`）

临时副本（temp 写 true）只存在于内存：/clh reload 或重启服务器后就消失。适合做短暂活动或测试。
temp 必须紧接在新名称后面（第 3 个参数）。如果先写 -l: 再写 true，插件找到位置后就不再往后读，true 会被忽略，副本仍会存档。
temp 只有写 true（不分大小写）才算开启，写其他任何字都当作 false。

例子

/clh clone welcome welcome_2                            # 复制到你的位置并存档
/clh clone welcome event_tmp true                       # 临时副本，重载后消失
/clh clone welcome lobby_copy false -l:lobby:10:65:-3   # 复制到另一个世界的指定坐标

/clh hologram rename

把看板改成新名称。内容、位置、设定全部保留，旧文件会被删除，换成新名称的文件。

项目	内容
用法	`/clh hologram rename <看板> <新名称>`
权限	`dh.command.holograms.rename`
别名	无（没有快捷写法）
控制台	可以

参数	必填	说明
`<看板>`	是	现在的名称
`<新名称>`	是	规则同 `create`；不能和已有看板重名

成功时显示 看板已重命名！（旧名 -> 新名）。
其他插件或点击动作里如果写死了旧名称（例如 PAGE:旧名:2、NEXT_PAGE:旧名），要自己改过来。

例子

/clh hologram rename welcome lobby_welcome
/clh h rename test1 shop_board

/clh hologram enable

重新启用一个被停用的看板，让它再次显示给所有玩家，并把「启用」状态写进文件。

项目	内容
用法	`/clh hologram enable <看板>`
权限	`dh.command.holograms.enable`
别名	`on`（也可以直接打 `/clh enable`）
控制台	可以

看板本来就是启用的会提示：看板已经是启用状态！

例子

/clh enable event_board
/clh on event_board

/clh hologram disable

停用看板：所有玩家都看不到它，但文件和内容都保留，之后可以再 enable。停用状态会写进文件，重启后仍然是停用。

项目	内容
用法	`/clh hologram disable <看板>`
权限	`dh.command.holograms.disable`
别名	`off`（也可以直接打 `/clh disable`）
控制台	可以

已经停用会提示：看板已经是停用状态！
在 /clh list 里，停用的看板名称会显示成红色。

例子

/clh disable event_board
/clh off christmas_tree

/clh hologram info

显示看板的详细资料。

项目	内容
用法	`/clh hologram info <看板>`
权限	`dh.command.holograms.info`
别名	无（也可以直接打 `/clh info`）
控制台	可以

会显示：名称、位置（世界与坐标）、是否启用、观看权限（有设才显示）、页数、朝向（度）、是否向下排列、更新间隔（tick）、更新范围、显示范围、旗标（有设才显示）。

例子

/clh info welcome
/clh h info shop_board

/clh hologram lines

列出某一页的全部行，每页显示 15 行，行数多时底下有可点击的翻页按钮。

项目	内容
用法	`/clh hologram lines <看板> <页> [列表页]`
权限	`dh.command.holograms.lines`
别名	`line`、`l`（没有快捷写法，注意 `/clh l` 是行指令）
控制台	可以（看不到点击效果）

参数	必填	说明
`<看板>`	是	看板名称
`<页>`	是	看板的第几页，超出范围会提示 `页序号超出该看板的范围。`
`[列表页]`	否	行数超过 15 行时，要看第几页列表；超过最大值会显示最后一页

玩家执行时，把鼠标移到某一行上会显示一段指令，点击会把 /clh l set <看板> <页> <行> <原内容> 放进聊天栏，改完直接送出就能修改这一行（需要 dh.command.lines.set 权限）。
控制台执行且行数超过 15 行时，显示翻页按钮这一步会出错（只有玩家能用翻页）。

例子

/clh hologram lines welcome 1
/clh h l shop_board 2
/clh h lines rules 1 2        # 第 1 页的行，列表翻到第 2 页（第 16~30 行）

/clh hologram teleport

把你传送到看板的位置。

项目	内容
用法	`/clh hologram teleport <看板>`
权限	`dh.command.holograms.teleport`
别名	`tp`、`tele`（也可以直接打 `/clh tp`）
控制台	不行，只能玩家

传送点就是看板的原点（第一行的位置附近），面向的方向是看板的朝向。

例子

/clh tp welcome
/clh teleport shop_board

/clh hologram near

列出你附近一定范围内的看板（只算同一个世界），显示名称和坐标。

项目	内容
用法	`/clh hologram near <范围>`
权限	`dh.command.holograms.near`
别名	无（也可以直接打 `/clh near`）
控制台	不行，只能玩家

参数	必填	说明
`<范围>`	是	半径（格），整数 1~1000

范围内没有看板会提示：你附近没有任何看板。
找不到某个看板叫什么名字时，先站过去用这条查。

例子

/clh near 10
/clh near 100

/clh hologram move

把看板移到指定坐标（同一个世界）。支持 ~ 相对坐标。

项目	内容
用法	`/clh hologram move <看板> <x> <y> <z>`
权限	`dh.command.holograms.move`
别名	`mv`（也可以直接打 `/clh move`）
控制台	可以

参数	必填	说明
`<x>` `<y>` `<z>`	是	目标坐标，可写小数。单独一个 `~` = 这个坐标不变，`~1.5` = 在原坐标上加 1.5，`~-2` = 减 2

「相对」是相对看板目前的位置，不是你的位置。
世界不会改变；要换世界请用 movehere。
坐标写错（不是数字，例如 abc、~x）会提示 坐标必须是数字（可以用 ~ 表示相对位置）：你写的内容，看板不会移动。
玩家按 Tab 时会补全看板目前的坐标和 ~。

例子

/clh move welcome 100.5 70 -20.5     # 移到绝对坐标
/clh move welcome ~ ~0.5 ~           # 只往上抬 0.5 格
/clh mv shop_board ~-1 ~ ~2          # X 减 1、Z 加 2

/clh hologram movehere

把看板移到你现在的位置（可以跨世界）。

项目	内容
用法	`/clh hologram movehere <看板>`
权限	`dh.command.holograms.movehere`
别名	`mvhr`（也可以直接打 `/clh movehere`）
控制台	不行，只能玩家

默认移到你脚下；holograms-eye-level-positioning: true 时移到眼睛高度。
看板的朝向不会跟着你的视角改变；要改朝向用 setfacing。

例子

/clh movehere welcome
/clh mvhr shop_board

/clh hologram center

把看板的 X、Z 移到所在方块的正中心（例如 10.27 → 10.5），Y 不变。放在方块上方的看板用这个对得最整齐。

项目	内容
用法	`/clh hologram center <看板>`
权限	`dh.command.holograms.center`
别名	无（也可以直接打 `/clh center`）
控制台	可以

例子

/clh center welcome
/clh h center shop_board

/clh hologram align

让一个看板在某个方向上和另一个看板对齐（把另一个看板的坐标或朝向复制过来）。

项目	内容
用法	`/clh hologram align <看板> <X\|Y\|Z\|XZ\|FACE> <另一个看板>`
权限	`dh.command.holograms.align`
别名	无（也可以直接打 `/clh align`）
控制台	可以

参数	必填	说明
`<看板>`	是	要移动的看板
`<方向>`	是	`X`、`Y`、`Z`：只复制该坐标；`XZ`（或 `ZX`）：复制 X 和 Z；`FACE`（或 `FACING`）：复制朝向。不分大小写
`<另一个看板>`	是	参考的看板，它本身不会动

两个名称一样：无法将看板与自身对齐！；方向写错：该坐标轴不存在！
只复制坐标数值，不会换世界。

例子

/clh align board_b X board_a        # 两个看板排在同一条南北线上
/clh align board_b Y board_a        # 两个看板一样高
/clh align board_b face board_a     # 朝向和 board_a 一样

/clh hologram setfacing

设定看板的朝向，主要影响头颅、物品、实体这类行面向哪边。行的 X/Z 偏移是按世界坐标算的，不会跟着朝向旋转。

项目	内容
用法	`/clh hologram setfacing <看板> <朝向>`
权限	`dh.command.holograms.setfacing`
别名	`facing`、`setface`、`face`
控制台	可以

参数	必填	说明
`<朝向>`	是	方向名或角度。`SOUTH` = 0、`WEST` = 90、`NORTH` = 180、`EAST` = -90；也可以直接写 -180~180 的角度（可以有小数）

只有「朝向和看板原本一样」的行会跟着转；你用 /clh line setfacing 单独设过朝向的行保持不变。

例子

/clh h setfacing welcome NORTH
/clh h facing shop_board 45
/clh h face statue -90

/clh hologram downorigin

切换「向下排列（down origin）」。

false（默认）：看板的位置是最上面一行，加新行会往下长。
true：看板的位置是最下面一行的底部，加新行会往上长。适合放在地面、不想让文字钻进地里的看板。

项目	内容
用法	`/clh hologram downorigin <看板> <true\|false>`
权限	`dh.command.holograms.downorigin`
别名	`setdownorigin`
控制台	可以

只有写 true 才会开启，写其他任何字都当作 false。
默认值可以在 config.yml 的 defaults.down-origin 改。

例子

/clh h downorigin floor_sign true
/clh h downorigin floor_sign false

/clh hologram setdisplayrange

设定显示范围：玩家距离看板多少格以内才看得到。

项目	内容
用法	`/clh hologram setdisplayrange <看板> <范围>`
权限	`dh.command.holograms.setdisplayrange`
别名	`displayrange`
控制台	可以

参数	必填	说明
`<范围>`	是	整数 1~64（格）

新看板默认用 config.yml 的 defaults.display-range（默认 48）。
范围越大，同时看到看板的玩家越多，发送的封包也越多。

例子

/clh h setdisplayrange spawn_title 64
/clh h displayrange small_tip 8

/clh hologram setupdaterange

设定更新范围：玩家距离多少格以内，看板的变量、动画才会持续刷新。范围外的玩家仍然看得到看板，只是内容不再更新。

项目	内容
用法	`/clh hologram setupdaterange <看板> <范围>`
权限	`dh.command.holograms.setupdaterange`
别名	`updaterange`
控制台	可以

参数	必填	说明
`<范围>`	是	整数 1~64（格）

新看板默认用 defaults.update-range（默认 48）。
通常设得和显示范围一样或小一点；有很多变量看板时，调小可以省性能。

例子

/clh h setupdaterange top_kills 20
/clh h updaterange clock 48

/clh hologram setupdateinterval

设定更新间隔：每隔多少 tick 刷新一次变量（20 tick = 1 秒）。

项目	内容
用法	`/clh hologram setupdateinterval <看板> <间隔>`
权限	`dh.command.holograms.setupdateinterval`
别名	`updateinterval`
控制台	可以

参数	必填	说明
`<间隔>`	是	整数 1~1200（tick）

新看板默认用 defaults.update-interval（默认 20，也就是每秒一次）。
排行榜这类不需要即时的看板，可以设成 100（5 秒）甚至 1200（1 分钟）来省性能。
想让看板完全不刷新，可以加旗标 DISABLE_UPDATING。

例子

/clh h setupdateinterval clock 20
/clh h updateinterval top_money 200

/clh hologram setpermission

设定观看权限：只有拥有这个权限的玩家才看得到这个看板。不写权限 = 移除限制，所有人都看得到。

项目	内容
用法	`/clh hologram setpermission <看板> [权限]`
权限	`dh.command.holograms.setpermission`
别名	`permission`、`setperm`、`perm`
控制台	可以

参数	必填	说明
`[权限]`	否	任意权限节点，例如 `group.vip`；省略就是移除

权限名称可以自己取，不用事先在别的插件登记，用权限插件给玩家即可。
只想限制某一行，请用 /clh line setpermission。

例子

/clh h setperm vip_board group.vip     # 只有 VIP 看得到
/clh h setperm staff_note server.staff
/clh h setperm vip_board               # 移除限制

/clh hologram addflag

给看板加一个旗标，用来关掉某些功能（变量、更新、动画、点击）。完整说明见旗标。

项目	内容
用法	`/clh hologram addflag <看板> <旗标>`
权限	`dh.command.holograms.addflag`
别名	无
控制台	可以

参数	必填	说明
`<旗标>`	是	`DISABLE_PLACEHOLDERS`、`DISABLE_UPDATING`、`DISABLE_ANIMATIONS`、`DISABLE_ACTIONS` 其中之一。必须全大写（按 Tab 补全最保险）

写错会提示：找不到旗标 "xxx"。

例子

/clh h addflag static_rules DISABLE_UPDATING
/clh h addflag deco DISABLE_ACTIONS

/clh hologram removeflag

移除看板上的某个旗标。

项目	内容
用法	`/clh hologram removeflag <看板> <旗标>`
权限	`dh.command.holograms.removeflag`
别名	`remflag`
控制台	可以

旗标名称同 addflag，必须全大写。看板本来就没有这个旗标也会显示「已移除」。

例子

/clh h removeflag static_rules DISABLE_UPDATING
/clh h remflag deco DISABLE_ACTIONS

/clh hologram update

把看板对所有玩家「先隐藏再显示」一次，相当于强制重新发送。看板显示怪怪的（例如卡住、少一行）时可以试试。

项目	内容
用法	`/clh hologram update <看板>`
权限	`dh.command.holograms.update`
别名	无
控制台	可以

停用中的看板不会被显示出来，但仍会提示 看板已更新！。
这条不会重新读取文件。直接改了 holograms/ 里的 yml 之后，请用 /clh reload。

例子

/clh h update welcome
/clh holograms update top_kills

指令一览​

快捷写法​

/clh hologram help​

/clh hologram create​

/clh hologram delete​

/clh hologram clone​

/clh hologram rename​

/clh hologram enable​

/clh hologram disable​

/clh hologram info​

/clh hologram lines​

/clh hologram teleport​

/clh hologram near​

/clh hologram move​

/clh hologram movehere​

/clh hologram center​

/clh hologram align​

/clh hologram setfacing​

/clh hologram downorigin​

/clh hologram setdisplayrange​

/clh hologram setupdaterange​

/clh hologram setupdateinterval​

/clh hologram setpermission​

/clh hologram addflag​

/clh hologram removeflag​

/clh hologram update​