行指令 `/clh line …`

看板由「页」组成，每一页由很多「行」组成。这一组指令用来编辑某一页里的某一行：加一行、改内容、删掉、调高度和位置等。管理整个看板请看看板指令，加页或点击动作请看页指令。

写法：/clh line <子指令> …，line 可以换成 lines 或 l，例如 /clh l set welcome 1 2 你好。
几乎每条指令都要依序写：看板名称 → 页码 → 行号。页码、行号都从 1 开始，最上面一行是第 1 行。
页码超出范围会提示 该页不存在。；行号超出范围会提示 行序号超出该看板页的范围。（个别指令例外，见各节说明）。
按 Tab 会依序补全看板名称、页码、行号。

更简单的写法

只想改一行文字，可以用快捷指令 /clh setline <看板> <页> <行> <文字>，效果和 /clh line set 一样。

权限

需要主指令权限（dh.default，默认所有人都有）+ 群组权限 dh.command.lines + 各子指令自己的权限（见下表）。cloudhologram.admin（或 dh.admin）直接通过所有检查。完整列表见权限。

指令一览

指令	作用
`/clh line help`	列出本组全部指令
`/clh line add`	在页的最下面加一行
`/clh line insert`	在某一行前面插入一行
`/clh line set`	修改某一行的内容
`/clh line edit`	把某一行的原内容放进聊天栏，方便修改
`/clh line remove`	删除某一行
`/clh line swap`	交换两行的位置
`/clh line info`	查看某一行的资料
`/clh line height`	设定行高（这一行占多高）
`/clh line offsetx`	设定 X 方向偏移
`/clh line offsetz`	设定 Z 方向偏移
`/clh line align`	让一行的偏移或朝向和另一行一样
`/clh line setfacing`	设定这一行的朝向
`/clh line setpermission`	设定这一行的观看权限
`/clh line addflag`	给这一行加旗标
`/clh line removeflag`	移除这一行的旗标

行内容怎么写

add、insert、set 的「内容」就是这一行要显示的东西，可以有空格。常见几种：

写法	显示
`&a欢迎 &f%player_name%`	一般文字，可用颜色代码、MiniMessage、变量，见颜色与格式、变量
`#ICON: DIAMOND_SWORD`	一个会转动的物品；后面加 `!ENCHANTED` 会发光
`#HEAD: PLAYER_HEAD (Notch)`	大头颅（括号里写玩家名或材质）
`#SMALLHEAD: PLAYER_HEAD (Notch)`	小头颅
`#ENTITY: ZOMBIE`	一个实体

各种行的完整写法见行类型。

手持物品 <HAND>：玩家执行 add、insert、set 时，内容里的 <HAND> 会被换成你主手拿着的物品（空手时换成 STONE）。例如手拿钻石剑执行 /clh l add shop 1 #ICON: <HAND>，就会加一行钻石剑。控制台执行时不会替换。

Tab 补全：

内容的第一个字输入 # 再按 Tab，会出现 #ICON:、#HEAD:、#SMALLHEAD:、#ENTITY:。
选了 #ICON: / #HEAD: / #SMALLHEAD: 后空一格，下一个参数会补全物品名称；选 #ENTITY: 则补全实体类型。
头颅行在物品名称后输入 ( 再按 Tab，会补全在线玩家名称，装了 PlaceholderAPI 会多出 (%player_name%)，装了 HeadDatabase 会多出 (HEADDATABASE_<id>)。
#ICON: 行后面输入 ! 再按 Tab 会补全 !ENCHANTED。

/clh line help

列出本组全部子指令的用法和说明。

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

例子

/clh line help
/clh l ?

/clh line add

在指定页的最下面加一行。

项目	内容
用法	`/clh line add <看板> <页> [内容]`
权限	`dh.command.lines.add`
别名	`append`
控制台	可以

参数	必填	说明
`<看板>`	是	看板名称
`<页>`	是	加在第几页
`[内容]`	否	这一行的内容；不写就用 `config.yml` 的 `defaults.text`（默认「空白行」）

开启「向下排列」的看板（downorigin 为 true），新行会让整个看板往上长。

例子

/clh l add welcome 1 &7输入 &e/spawn &7回到出生点
/clh l add welcome 1                         # 加一行默认文字，之后再 set
/clh l add shop 1 #ICON: DIAMOND !ENCHANTED  # 发光的钻石
/clh l add shop 2 #ICON: <HAND>              # 用手上的物品

/clh line insert

在指定行的前面插入一行：新行占用这个行号，原本这一行和下面的行都往下挪一行。

项目	内容
用法	`/clh line insert <看板> <页> <行> [内容]`
权限	`dh.command.lines.insert`
别名	无
控制台	可以

参数	必填	说明
`<行>`	是	插在第几行的位置，必须是现有的行号
`[内容]`	否	不写就用默认文字

行号只能写现有的行（1 到最后一行）。想加在最后面，请用 add。

例子

/clh l insert welcome 1 1 &6&l云海服务器     # 插到最上面，当标题
/clh l insert rules 1 3 &7（第 3 条规则已更新）
/clh l insert welcome 1 2                   # 在第 2 行前插一行空白

/clh line set

把某一行换成新内容。行的类型可以换，例如把文字行改成物品行，插件会自动重新生成这一行。

项目	内容
用法	`/clh line set <看板> <页> <行> <内容>`
权限	`dh.command.lines.set`
别名	无（快捷指令 `/clh setline` 效果相同）
控制台	可以

参数	必填	说明
`<行>`	是	第几行
`<内容>`	是	新内容，可以有空格

行号不存在会提示：该行不存在。
想在原内容上小改，先用 edit 把原内容带出来。

例子

/clh l set welcome 1 1 &b&l欢迎回来，&f%player_name%
/clh l set shop 1 2 #ICON: <HAND>
/clh l set top 1 3 #SMALLHEAD: PLAYER_HEAD (%player_name%)

/clh line edit

在聊天栏显示一句可点击的「点击编辑此行！」。把鼠标移上去会显示完整指令，点一下就把 /clh l set <看板> <页> <行> <原内容> 放进聊天栏，改完直接送出。适合内容很长、只想改几个字的时候。

项目	内容
用法	`/clh line edit <看板> <页> <行>`
权限	`dh.command.lines.edit`
别名	`e`
控制台	不行，只能玩家

这条指令本身不会改任何东西，真正修改的是你之后送出的 set，所以还需要 dh.command.lines.set 权限。

例子

/clh l edit welcome 1 2
/clh l e rules 1 5

/clh line remove

删除某一行，下面的行会往上补。

项目	内容
用法	`/clh line remove <看板> <页> <行>`
权限	`dh.command.lines.remove`
别名	`rm`、`rem`、`del`、`delete`
控制台	可以

参数	必填	说明
`<页>`	是	第几页，超出范围会提示 `该页不存在。`
`<行>`	是	要删的行号，超出范围会提示 `该行不存在。`，什么都不会删

不确定行号时，先用 /clh hologram lines 查看。
删掉某一页的最后一行时，这一页也会一起被删除并保存，多显示一句「页已删除！」。
如果那是看板唯一的一页，整个看板（包括文件）也会被删除，再多显示一句「看板已删除！」。

提示

要删整页可以直接用 /clh page remove，要删整个看板用 /clh delete，不用一行一行删。

例子

/clh l remove welcome 1 3
/clh l rm rules 2 1

/clh line swap

交换同一页里两行的位置。

项目	内容
用法	`/clh line swap <看板> <页> <行1> <行2>`
权限	`dh.command.lines.swap`
别名	无
控制台	可以

两个行号一样：无法将行与自身交换！；任一行号不存在：交换行失败。
只能在同一页内交换，不能跨页。

例子

/clh l swap welcome 1 1 2      # 第 1、2 行对调
/clh l swap rules 1 2 5

/clh line info

显示某一行的资料：所属看板、行号、位置、内容、行高、X/Y/Z 偏移。

项目	内容
用法	`/clh line info <看板> <页> <行>`
权限	`dh.command.lines.info`
别名	无
控制台	可以

Y 偏移由行的类型决定，没有指令可以改；X、Z 偏移可用 offsetx、offsetz 设定。

例子

/clh l info welcome 1 1
/clh l info shop 2 3

/clh line height

设定这一行的高度，也就是这一行和下一行之间的距离。数字越大，下一行离得越远。

项目	内容
用法	`/clh line height <看板> <页> <行> <高度>`
权限	`dh.command.lines.height`
别名	`setheight`
控制台	可以

参数	必填	说明
`<高度>`	是	0~2.5 的数字（格），可以有小数

默认高度来自 config.yml 的 defaults.height：文字 0.3、物品 0.6、大头颅 0.75、小头颅 0.6。
想在两段文字间空出一段距离，可以把上面那行的高度调大，比插空白行更整齐。

例子

/clh l height welcome 1 1 0.5     # 标题下面多空一点
/clh l height shop 1 2 0.8
/clh l setheight rules 1 4 0

/clh line offsetx

让这一行在 X 方向（东西方向）偏移一段距离，其他行不受影响。

项目	内容
用法	`/clh line offsetx <看板> <页> <行> <偏移>`
权限	`dh.command.lines.offsetx`
别名	`xoffset`、`offx`、`xoff`（写成 `offsetX` 也可以）
控制台	可以

参数	必填	说明
`<偏移>`	是	-2.5~2.5 的数字（格），正数往东（X 增加），负数往西

偏移按世界坐标算，不会跟着看板朝向旋转。

例子

/clh l offsetx shop 1 2 0.5
/clh l offx shop 1 3 -0.5

/clh line offsetz

让这一行在 Z 方向（南北方向）偏移一段距离。

项目	内容
用法	`/clh line offsetz <看板> <页> <行> <偏移>`
权限	`dh.command.lines.offsetz`
别名	`zoffset`、`offz`、`zoff`（写成 `offsetZ` 也可以）
控制台	可以

参数	必填	说明
`<偏移>`	是	-2.5~2.5 的数字（格），正数往南（Z 增加），负数往北

例子

/clh l offsetz shop 1 2 1
/clh l zoff shop 1 2 0

/clh line align

把「行2」的偏移或朝向复制给「行1」，让两行对齐。行2 本身不会动。

项目	内容
用法	`/clh line align <看板> <页> <行1> <行2> <X\|Z\|XZ\|FACE>`
权限	`dh.command.lines.align`
别名	无
控制台	可以

参数	必填	说明
`<行1>`	是	要调整的行
`<行2>`	是	参考的行
`<方向>`	是	`X`：复制 X 偏移；`Z`：复制 Z 偏移；`XZ`（或 `ZX`）：两个都复制；`FACE`（或 `FACING`）：复制朝向。不分大小写，`x`、`X` 都可以

方向写错会提示 该坐标轴不存在！。Tab 只会补全 X、Z、XZ，FACE 要自己打。
两个行号一样：无法将行与自身对齐！

例子

/clh l align shop 1 3 2 XZ      # 第 3 行的偏移和第 2 行一样
/clh l align shop 1 4 2 FACE    # 第 4 行的朝向和第 2 行一样

/clh line setfacing

单独设定这一行的朝向，主要用在头颅、物品、实体行，让它面向某个方向。

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

参数	必填	说明
`<朝向>`	是	`SOUTH` = 0、`WEST` = 90、`NORTH` = 180、`EAST` = -90，或 -180~180 的角度

单独设过朝向的行，之后用 /clh hologram setfacing 改整个看板时不会跟着转。想让它重新跟随，把它设回和看板一样的角度即可。

例子

/clh l setfacing statue 1 1 NORTH
/clh l face statue 1 2 45

/clh line setpermission

设定观看权限：只有拥有这个权限的玩家看得到这一行。不写权限 = 移除限制。

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

适合「同一个看板，VIP 多看到一行」这类用法。整个看板都要限制请用 /clh hologram setpermission。

例子

/clh l setperm welcome 1 4 group.vip     # 第 4 行只有 VIP 看得到
/clh l setperm welcome 1 4               # 移除限制

/clh line addflag

给某一行加旗标，只影响这一行。旗标说明见旗标。

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

参数	必填	说明
`<旗标>`	是	`DISABLE_PLACEHOLDERS`、`DISABLE_UPDATING`、`DISABLE_ANIMATIONS`、`DISABLE_ACTIONS`，必须全大写

旗标写错（或没有全大写）会提示 找不到旗标 "你写的旗标"。，例如 找不到旗标 "disable_actions"。

例子

/clh l addflag welcome 1 2 DISABLE_PLACEHOLDERS   # 这一行原样显示 %变量%
/clh l addflag clock 1 1 DISABLE_ANIMATIONS

/clh line removeflag

移除某一行的旗标。

项目	内容
用法	`/clh line removeflag <看板> <页> <行> <旗标>`
权限	`dh.command.lines.removeflag`
别名	无
控制台	可以

旗标名称规则和 addflag 一样。

例子

/clh l removeflag welcome 1 2 DISABLE_PLACEHOLDERS
/clh l removeflag clock 1 1 DISABLE_ANIMATIONS

指令一览​

行内容怎么写​

/clh line help​

/clh line add​

/clh line insert​

/clh line set​

/clh line edit​

/clh line remove​

/clh line swap​

/clh line info​

/clh line height​

/clh line offsetx​

/clh line offsetz​

/clh line align​

/clh line setfacing​

/clh line setpermission​

/clh line addflag​

/clh line removeflag​