Display 指令

这一页列出 /clh display … 底下的全部子指令。还不清楚 Display 是什么，先看 Display 实体。

• 群组名称：displays，别名 display、d。下面一律写最短的 /clh d。
• 只有 1.19.4 以上的服务器才有这组指令；旧版本打 /clh d 会显示「未知的子指令」。
• <> 必填，[] 可省略。Display 名称只能用英文字母、数字、_、-，并且区分大小写。
• 每个参数都有 Tab 补全（Display 名称、类型、方块 / 物品名称、属性名称、属性值提示）。
• 除了 list 之外，指令执行后都会自动保存到 plugins/CloudHologram/displays/<名称>.yml，不用 /clh reload。

权限要两层都有

执行 /clh d create 时，插件会先检查群组权限 dh.command.displays，再检查子指令权限 dh.command.displays.create。两个都要有（或者有 dh.admin）。 dh.command.displays 本身就包含全部子指令权限，详见 权限。

指令一览

指令	用途	权限
/clh d create	建立 Display	dh.command.displays.create
/clh d delete	删除 Display	dh.command.displays.delete
/clh d list	列出全部 Display	dh.command.displays.list
/clh d nearby	列出附近的 Display	dh.command.displays.nearby
/clh d teleport	传送到 Display	dh.command.displays.teleport
/clh d move	移到指定座标	dh.command.displays.move
/clh d movehere	移到你的位置	dh.command.displays.movehere
/clh d center	对齐方块中心	dh.command.displays.center
/clh d set-facing	设定朝向	dh.command.displays.facing
/clh d rename	改名	dh.command.displays.rename
/clh d clone	复制到你的位置	dh.command.displays.clone
/clh d enable	启用	dh.command.displays.enable
/clh d disable	停用（隐藏）	dh.command.displays.disable
/clh d display-range	显示范围	dh.command.displays.displayrange
/clh d update-interval	更新间隔	dh.command.displays.updateinterval
/clh d attribute	查看或设定属性	dh.command.displays.attribute
/clh d reset-attribute	属性恢复默认	dh.command.displays.resetattribute
/clh d list-attributes	列出全部属性	dh.command.displays.listattributes
/clh d set-block	换方块（方块 Display）	dh.command.displays.setblock
/clh d set-item	换物品（物品 Display）	dh.command.displays.setitem
/clh d addline	加一行（文字 Display）	dh.command.displays.text.addline
/clh d insertline	插入一行	dh.command.displays.text.insertline
/clh d removeline	删除一行	dh.command.displays.text.removeline
/clh d setline	改一行	dh.command.displays.text.setline
/clh d swap-lines	交换两行	dh.command.displays.text.swaplines
/clh d help	显示帮助	dh.command.displays.help

---

建立与删除

/clh d create

在你脚下建立一个新的 Display。

项目	内容
用法	/clh d create <类型> <名称> [内容]
权限	dh.command.displays.create
别名	new、c
控制台	不可以（要用玩家的位置）

参数	必填	说明
<类型>	是	TEXT（文字）、ITEM（物品）、BLOCK（方块），大小写都可以
<名称>	是	英文字母、数字、_、-；不能和现有的 Display 重复
[内容]	视类型	TEXT：文字，可省略（省略时用 config.yml 的 defaults.text，默认「空白行」）；ITEM：物品名称，必填；BLOCK：方块名称，必填

• 位置：默认是你的脚下；config.yml 的 displays-eye-level-positioning: true 时改成眼睛高度。你面对的方向（yaw / pitch）也会一起记下来。
• TEXT 的内容可以用 \n 分成多行：第一行\n第二行。
• ITEM / BLOCK 的名称可以写 diamond_sword、DIAMOND_SWORD 或 minecraft:diamond_sword，旧版名称（例如 INK_SACK:4）也会自动换成新名称。物品 Display 要写「物品」，方块 Display 要写「能放置的方块」，否则会提示「无效的物品类型」或「无效的方块类型」。
• 建立时会自动套用 attribute-defaults.yml 里该类型的默认属性（见 Display 实体）。
• 新的 Display 默认显示范围 256 格、更新间隔 20 tick。

例子

/clh d create text welcome &b欢迎来到 &f云海秘境
/clh d create text rules &e服务器规则\n&71. 禁止外挂\n&72. 友善聊天
/clh d create item sword diamond_sword
/clh d create block crystal amethyst_block

/clh d delete

删除 Display，同时删除它的文件。

项目	内容
用法	/clh d delete <名称>
权限	dh.command.displays.delete
别名	del
控制台	可以

参数	必填	说明
<名称>	是	要删除的 Display

删除不能还原

displays/<名称>.yml 会被直接删掉，没有回收站。不确定的话先 /clh d clone 备份一份，或先把文件复制出来。

例子

/clh d delete welcome

查找与传送

/clh d list

列出服务器上全部 Display，每页 15 个，显示名称、世界与座标。

项目	内容
用法	/clh d list [页码]
权限	dh.command.displays.list
别名	无
控制台	不可以

参数	必填	说明
[页码]	否	列表的第几页，默认第 1 页

例子

/clh d list
/clh d list 2

/clh d nearby

列出你身边一定距离内的 Display（只算你所在的世界），每页 15 个。

项目	内容
用法	/clh d nearby <范围> [页码]
权限	dh.command.displays.nearby
别名	near
控制台	不可以

参数	必填	说明
<范围>	是	半径（格），可以有小数
[页码]	否	列表的第几页

• 其他世界的 Display 不会列出；要看全部 Display 用 /clh d list。

例子

/clh d nearby 20

/clh d teleport

把你传送到 Display 的位置（包含它记录的朝向）。

项目	内容
用法	/clh d teleport <名称>
权限	dh.command.displays.teleport
别名	tp、tele
控制台	不可以

参数	必填	说明
<名称>	是	Display 名称

• Display 所在的世界没有载入时，会提示「Display 所在的世界不存在」。

例子

/clh d tp welcome

位置与朝向

/clh d move

把 Display 移到指定座标（同一个世界）。

项目	内容
用法	/clh d move <名称> <x> <y> <z>
权限	dh.command.displays.move
别名	mv
控制台	可以

参数	必填	说明
<名称>	是	Display 名称
<x> <y> <z>	是	新座标。前面加 ~ 表示相对现在的位置，例如 ~0.5 是往正方向移 0.5 格，单独一个 ~ 表示这个轴不变

• 世界和朝向保持不变。
• 坐标写错（例如打成字母）会提示 坐标必须是数字（可以用 ~ 表示相对位置）：你写的内容，Display 不会移动。

例子

/clh d move welcome 100 65 -20         # 移到绝对座标
/clh d move welcome ~ ~1 ~             # 往上抬 1 格
/clh d move welcome ~-0.5 ~ ~0.5       # 微调

/clh d movehere

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

项目	内容
用法	/clh d movehere <名称>
权限	dh.command.displays.movehere
别名	mvhr
控制台	不可以

参数	必填	说明
<名称>	是	Display 名称

• 高度规则和 create 一样：默认脚下，开了 displays-eye-level-positioning 就是眼睛高度。
• 朝向不会跟着你，保留 Display 原本的朝向。要改朝向用 set-facing。

例子

/clh d movehere welcome

/clh d center

把 Display 的 X、Z 对齐到所在方块的正中央（.5），高度不变。

项目	内容
用法	/clh d center <名称>
权限	dh.command.displays.center
别名	无
控制台	可以

参数	必填	说明
<名称>	是	Display 名称

例子

/clh d center crystal

/clh d set-facing

设定 Display 的朝向。

项目	内容
用法	/clh d set-facing <名称> <yaw> [pitch]
权限	dh.command.displays.facing
别名	setfacing、facing、face
控制台	可以

参数	必填	说明
<名称>	是	Display 名称
<yaw>	是	水平角度，-180～180。0 南、90 西、180 / -180 北、-90 东
[pitch]	否	上下角度，-90～90（负数朝上、正数朝下）。省略时保持原本的值

• 朝向只在 billboard 是 FIXED（或部分固定）时看得出来。文字 Display 默认是 CENTER（永远面向玩家），要先改 billboard，见 Display 实体。
• 如果设了 yaw / pitch 属性，属性会盖过这里的朝向。

例子

/clh d set-facing sword 90
/clh d set-facing sign -45 10

改名、复制、启用

/clh d rename

把 Display 改成新名称。内容、属性、设定、位置全部保留。

项目	内容
用法	/clh d rename <名称> <新名称>
权限	dh.command.displays.rename
别名	无
控制台	可以

参数	必填	说明
<名称>	是	现在的名称
<新名称>	是	英文字母、数字、_、-；不能和现有的重复

• 实际做法是「复制成新名称 → 删除旧的」，文件也会从 旧名称.yml 变成 新名称.yml。

例子

/clh d rename welcome lobby_welcome

/clh d clone

把 Display 复制一份，放在你现在的位置。

项目	内容
用法	/clh d clone <名称> <新名称>
权限	dh.command.displays.clone
别名	无
控制台	不可以

参数	必填	说明
<名称>	是	要复制的 Display
<新名称>	是	新 Display 的名称

• 复制内容、全部属性、启用状态、显示范围、更新间隔与朝向；只有位置换成你脚下（这里不看眼睛高度设定）。

例子

/clh d clone sword sword_2

/clh d enable

启用 Display，让玩家重新看得到。

项目	内容
用法	/clh d enable <名称>
权限	dh.command.displays.enable
别名	无
控制台	可以

参数	必填	说明
<名称>	是	Display 名称

• 已经是启用状态时什么都不改，一样显示「Display 已启用」。

例子

/clh d enable event_banner

/clh d disable

停用 Display：对所有玩家隐藏，但保留文件与全部设定。

项目	内容
用法	/clh d disable <名称>
权限	dh.command.displays.disable
别名	无
控制台	可以

参数	必填	说明
<名称>	是	Display 名称

• 停用状态会存进文件（settings.enabled: false），重启后仍然是停用。

例子

/clh d disable event_banner

显示与更新

/clh d display-range

设定玩家要离多近才看得到这个 Display。

项目	内容
用法	/clh d display-range <名称> <范围>
权限	dh.command.displays.displayrange
别名	displayrange
控制台	可以

参数	必填	说明
<名称>	是	Display 名称
<范围>	是	1～256 格，可以有小数。新建的 Display 默认 256

• 玩家是否在范围内大约每秒检查一次。
• 客户端本身也有实体显示距离，范围设很大时，远处的玩家仍可能因为客户端设定而看不到。

例子

/clh d display-range welcome 32

/clh d update-interval

设定 Display 多久重新计算一次内容（变量、玩家名称等）。

项目	内容
用法	/clh d update-interval <名称> <间隔>
权限	dh.command.displays.updateinterval
别名	updateinterval
控制台	可以

参数	必填	说明
<名称>	是	Display 名称
<间隔>	是	1～1200 tick（20 tick = 1 秒）。新建的 Display 默认 20

• 只影响变量（{player}、%变量%）的刷新速度。动画与 CHROMA 彩虹色是另外每 50 毫秒处理的，不受这个设定影响。
• 内容没有变量时，设多少都差不多；有很多变量又不需要即时，可以调大来省效能。

例子

/clh d update-interval scoreboard 10     # 每 0.5 秒刷新变量
/clh d update-interval welcome 200       # 每 10 秒

属性

属性控制 Display 的外观：大小、偏移、面向方式、亮度、背景色、发光颜色…… 全部属性的名称、格式、范围与默认值，见 Display 实体 → 属性一览。

/clh d attribute

查看或设定一个属性。

项目	内容
用法	/clh d attribute <名称> <属性> [值]
权限	dh.command.displays.attribute
别名	无
控制台	可以

参数	必填	说明
<名称>	是	Display 名称
<属性>	是	属性名称，全部小写，例如 scale、background-color。只能用这种 Display 类型支持的属性
[值]	否	不写 = 查看目前的值；写了 = 设定。有些属性要好几个值，用空格分开

• 查看时显示「属性 'scale' 的当前值：'…'」，没设过就显示「尚未设置」。
• 设定成功显示「已将属性 'scale' 设为 '…'」，Display 会马上更新。
• 属性名称打错或这种类型不能用，会提示「该 Display 没有属性 'xxx'」。
• 值格式不对会提示「属性 'xxx' 的值无效：原因」（原因是英文，例如 Scale must be greater than 0 and not exceed 100.）。

例子

/clh d attribute sword scale                          # 查看目前大小
/clh d attribute sword scale 2                        # 放大 2 倍
/clh d attribute sword scale 1 3 1                    # 只拉高
/clh d attribute sword translation 0 0.5 0            # 往上偏移 0.5 格
/clh d attribute welcome billboard VERTICAL           # 只左右转向玩家
/clh d attribute welcome background-color HEX 1E1E2E  # 深色背景（不透明）
/clh d attribute welcome background-color RGBA 0 0 0 0 # 透明背景
/clh d attribute sword glow-color CHROMA              # 彩虹发光
/clh d attribute crystal brightness 15 15             # 固定全亮

/clh d reset-attribute

把一个属性恢复成默认值。

项目	内容
用法	/clh d reset-attribute <名称> <属性>
权限	dh.command.displays.resetattribute
别名	resetattribute
控制台	可以

参数	必填	说明
<名称>	是	Display 名称
<属性>	是	属性名称

• 「默认值」先看 attribute-defaults.yml 里该类型、该属性是否 enabled: true，是就用那里的值；否则用插件内建的默认值。
• 内建默认值是「不设定」的属性（yaw、pitch、brightness、glow-color、leather-color、skull-texture），重置后就变成未设置，例如重置 glow-color 等于关掉发光。

例子

/clh d reset-attribute sword glow-color
/clh d reset-attribute welcome background-color

/clh d list-attributes

列出这个 Display 所有可用的属性和目前的值。没设定的显示 -。

项目	内容
用法	/clh d list-attributes <名称>
权限	dh.command.displays.listattributes
别名	listattributes
控制台	可以

参数	必填	说明
<名称>	是	Display 名称

例子

/clh d list-attributes welcome

刚建立、没改过的文字 Display，输出大致如下（顺序固定）：

DISPLAY 属性
Display 'welcome' 的全部属性。
 • yaw: -
 • pitch: -
 • translation: (0.0, 0.0, 0.0)
 • scale: (1.0, 1.0, 1.0)
 • billboard: CENTER
 • brightness: -
 • shadow-radius: 0.0
 • shadow-strength: 1.0
 • background-color: #000000RGBA: 0, 0, 0, 64
 • text-opacity: 255
 • text-shadow: false
 • see-through: false
 • alignment: CENTER
 • line-width: 300

颜色会同时显示十六进制与 RGBA 数值（两段之间没有空格，是原本的显示格式）。

方块与物品

/clh d set-block

换掉方块 Display 显示的方块。

项目	内容
用法	/clh d set-block <名称> <方块>
权限	dh.command.displays.setblock
别名	setblock、block
控制台	可以

参数	必填	说明
<名称>	是	方块 Display 的名称
<方块>	是	能放置的方块名称，例如 diamond_block、minecraft:glass

• 对文字或物品 Display 使用会提示「该 Display 不是 'BLOCK' 类型」。

例子

/clh d set-block crystal amethyst_block

/clh d set-item

换掉物品 Display 显示的物品。

项目	内容
用法	/clh d set-item <名称> <物品>
权限	dh.command.displays.setitem
别名	setitem、item
控制台	可以

参数	必填	说明
<名称>	是	物品 Display 的名称
<物品>	是	物品名称，例如 netherite_sword、player_head

• 对文字或方块 Display 使用会提示「该 Display 不是 'ITEM' 类型」。
• 附魔光效、皮革颜色、头颅皮肤是属性，不在这里设定，见 enchanted、leather-color、skull-texture。

例子

/clh d set-item sword netherite_sword
/clh d set-item head player_head
/clh d attribute head skull-texture {player}

文字行（文字 Display）

下面 5 个指令只能用在文字 Display（TEXT），对物品、方块 Display 使用会提示类型不符。 文字可以有空格，颜色、MiniMessage、变量、动画的写法和一般看板相同，见 颜色与格式、变量、动画。

/clh d addline

在最后面加一行。

项目	内容
用法	/clh d addline <名称> <文字>
权限	dh.command.displays.text.addline
别名	appendline
控制台	可以

参数	必填	说明
<名称>	是	文字 Display 的名称
<文字>	是	新的一行

• 这里的 \n 不会分行，会原样显示。要多行就多打几次 addline。

例子

/clh d addline welcome &7在线：&f%server_online%

/clh d insertline

在第 N 行的前面插入一行，原本的第 N 行往下移。

项目	内容
用法	/clh d insertline <名称> <行号> <文字>
权限	dh.command.displays.text.insertline
别名	无
控制台	可以

参数	必填	说明
<名称>	是	文字 Display 的名称
<行号>	是	1～目前行数。插在最后面请用 addline
<文字>	是	新的一行

例子

/clh d insertline welcome 1 &6&l公告

/clh d removeline

删除第 N 行。

项目	内容
用法	/clh d removeline <名称> <行号>
权限	dh.command.displays.text.removeline
别名	remline
控制台	可以

参数	必填	说明
<名称>	是	文字 Display 的名称
<行号>	是	1～目前行数

• 唯一的一行也可以删掉，删光之后 Display 没有文字。想暂时隐藏请改用 disable。

例子

/clh d removeline welcome 3

/clh d setline

把第 N 行换成新文字。

项目	内容
用法	/clh d setline <名称> <行号> <文字>
权限	dh.command.displays.text.setline
别名	无
控制台	可以

参数	必填	说明
<名称>	是	文字 Display 的名称
<行号>	是	1～目前行数
<文字>	是	新内容

• 和 /clh setline（改一般看板的行）不同，不要混用，见 快捷指令。

例子

/clh d setline welcome 1 <gradient:#78EFFF:#CB9CFF>欢迎来到云海</gradient>

/clh d swap-lines

交换两行的位置。

项目	内容
用法	/clh d swap-lines <名称> <行号1> <行号2>
权限	dh.command.displays.text.swaplines
别名	swaplines
控制台	可以

参数	必填	说明
<名称>	是	文字 Display 的名称
<行号1>、<行号2>	是	两个不同的行号，1～目前行数

• 两个行号一样会提示「无法将行与自身交换」。

例子

/clh d swap-lines welcome 1 2

帮助

/clh d help

列出全部 Display 子指令的用法与说明。

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

只打 /clh d 不加子指令时，会提示你使用帮助指令。

例子

/clh d help
/clh d ?