页指令 `/clh page …`

一个看板可以有很多「页」，玩家同一时间只看到其中一页，点击看板就能翻页。多页的概念和用法见多页。这一组指令用来增删页面，以及管理每一页的点击动作（点了看板会发生什么）。

写法：/clh page <子指令> …，page 可以换成 pages 或 p，例如 /clh p add welcome。
页码从 1 开始。按 Tab 会补全看板名称、页码、点击类型。
新看板一开始只有第 1 页。

更简单的写法

设定点击动作推荐用快捷指令 /clh click：按键写 left、right、shift-left、shift-right，动作写 next、page: 2 这种好记的格式。
加一页也可以用 /clh addpage <看板> <文字>。

权限

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

指令一览

指令	作用
`/clh page help`	列出本组全部指令
`/clh page add`	在最后面加一页
`/clh page insert`	在指定位置插入一页
`/clh page remove`	删除一页
`/clh page swap`	交换两页
`/clh page switch`	让自己（或某个玩家）看到指定页
`/clh page addaction`	给某一页加一个点击动作
`/clh page removeaction`	移除某一个点击动作
`/clh page actions`	列出某一页某个按键的所有动作
`/clh page clearactions`	清空某一页某个按键的所有动作

点击类型与动作格式

addaction、removeaction、actions、clearactions 都要写一个点击类型，代表玩家用什么方式点看板：

点击类型	玩家操作
`LEFT`	左键
`RIGHT`	右键
`SHIFT_LEFT`	蹲下 + 左键
`SHIFT_RIGHT`	蹲下 + 右键

点击类型不分大小写（left 也可以），但要用下划线 SHIFT_LEFT；/clh click 用的 shift-left 写法在这里不能用。

动作用原始格式 类型:内容 来写，同一个按键可以加很多个，点击时从上到下依序执行：

动作	写法	说明
发讯息	`MESSAGE:&a你好 {player}`	对点击的玩家发一句话，支持颜色和变量
玩家执行指令	`COMMAND:/spawn`	以玩家身份执行，要带 `/`（不带会变成在聊天栏说这句话）
控制台执行指令	`CONSOLE:give {player} diamond 1`	以控制台身份执行，不带 `/`
跨服传送	`CONNECT:lobby`	送到 BungeeCord / Velocity 的某个分流
传送	`TELEPORT:world:0:100:0`	也可以写 `x:y:z`（同一个世界），或多加 `:yaw:pitch`
播放音效	`SOUND:ENTITY_EXPERIENCE_ORB_PICKUP:1:1`	音效名称，后面可选 `:音量:音高`
检查权限	`PERMISSION:group.vip`	没有这个权限就停止，后面的动作都不执行
下一页	`NEXT_PAGE`	翻到本看板下一页；写 `NEXT_PAGE:看板` 可以翻别的看板。已经是最后一页就不动
上一页	`PREV_PAGE`	同上，往前翻
跳到某页	`PAGE:2`	跳到本看板第 2 页；`PAGE:看板:2` 跳别的看板
什么都不做	`NONE`	占位用

动作类型不分大小写；冒号后面不要加空格，空格会被当成内容的一部分（例如 COMMAND: /spawn 会变成在聊天栏说话而不是执行指令）。
{player} 会换成点击者的名字；装了 PlaceholderAPI 时 %变量% 也会替换。
插件只检查「类型」存不存在，不会检查内容写得对不对。写错的传送坐标、音效名称，点击时只会没反应。
每种动作的详细说明和更多例子见点击动作。

/clh page help

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

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

例子

/clh page help
/clh p ?

/clh page add

在看板最后面加一页，新页会带一行内容。

项目	内容
用法	`/clh page add <看板> [内容]`
权限	`dh.command.pages.add`
别名	`append`（快捷指令 `/clh addpage` 效果相近）
控制台	可以

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

玩家执行时，内容里的 <HAND> 会换成手上的物品。
新页加好后，再用 /clh line add 往这一页加更多行（页码写新页的号码）。
光有多页还不会翻页，要再给页面加 NEXT_PAGE 之类的点击动作。

例子

/clh p add welcome &e第二页：服务器规则
/clh p add welcome                       # 加一页默认文字，之后再 set
/clh p add shop #ICON: <HAND>            # 新页第一行是手上的物品

/clh page insert

在指定页码的位置插入一页：新页占用这个页码，原本这一页和后面的页都往后挪。

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

参数	必填	说明
`<页>`	是	插在第几页。可以写 1 到「总页数 + 1」，写总页数 + 1 就等于加在最后面
`[内容]`	否	新页第一行的内容；不写就用默认文字

页码超出范围会提示：插入页失败。
和 add 不同，这里内容里的 <HAND> 不会被替换。
插入后立刻生效：各页的页码、{page} 变量、正在看这个看板的玩家所在的页都会马上更新（正在看第 3 页的玩家，插入第 1 页后仍然看着原本那一页，它现在是第 4 页），不用 /clh reload。
插入后，其他页的页码都会改变；写死页码的点击动作（例如 PAGE:3）要记得一起调整。

例子

/clh p insert welcome 1 &6&l封面            # 插到最前面
/clh p insert rules 3 &7补充规则

/clh page remove

删除一页（连同这一页的所有行和点击动作）。

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

正在看这一页的玩家会被切回第 1 页。
删掉最后剩下的一页时，整个看板（包括文件）会被删除，并显示「页已删除！」「看板已删除！」。
页码超出范围（例如看板只有 3 页却写 5）时什么都不会删，提示 该页不存在。。不确定总页数可以先用 /clh info 查看。

例子

/clh p remove welcome 3
/clh p rm shop 2

/clh page swap

交换两页的位置（包括各自的行和点击动作）。正在看这两页的玩家会跟着换到对应的页。

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

两个页码一样：无法将页与自身交换！；任一页码不存在：交换页失败。

例子

/clh p swap welcome 1 2
/clh p swap rules 2 4

/clh page switch

让自己看到看板的某一页。拥有管理员权限时，可以指定一个在线玩家，让他看到那一页。适合测试多页看板，或配合其他插件用控制台帮玩家翻页。

项目	内容
用法	`/clh page switch <看板> <页> [玩家]`
权限	`dh.command.pages.switch`；指定 `[玩家]` 还需要 `dh.admin`（`cloudhologram.admin` 已包含）
别名	`go`、`view`
控制台	可以，但必须写 `[玩家]`

参数	必填	说明
`<页>`	是	要显示第几页，不存在会提示 `该页不存在。`
`[玩家]`	否	要切换的在线玩家，名称要写完整（不能只写前几个字）

只影响那一个玩家看到的页面，其他人不受影响；切换结果不会写进文件。
写了 [玩家] 但没有 dh.admin：提示 你没有权限使用此功能。，不会切换任何人的页面。
[玩家] 不在线或名称写错：提示 找不到在线玩家：名称。
控制台执行却没写 [玩家]：提示 此操作只能由玩家执行。
成功时没有提示讯息，看板直接换页。

例子

/clh p switch welcome 2                # 自己看第 2 页
/clh p go tutorial 1 Steve             # 让 Steve 看第 1 页（需要管理员）

/clh page addaction

给某一页的某个点击类型追加一个动作（原本的动作保留，新的排在最后）。

项目	内容
用法	`/clh page addaction <看板> <页> <点击类型> <动作>`
权限	`dh.command.pages.addaction`（与 `/clh click`、`/clh clickadd` 相同）
别名	无
控制台	可以

参数	必填	说明
`<页>`	是	第几页的动作
`<点击类型>`	是	`LEFT`、`RIGHT`、`SHIFT_LEFT`、`SHIFT_RIGHT`
`<动作>`	是	`类型:内容`，内容可以有空格，见动作格式

点击类型写错：该点击类型不存在。；动作类型写错：该动作不存在。
按 Tab 会依序补全看板名称、页码、点击类型和动作类型（例如打 MES 补成 MESSAGE），补完类型后自己接上 :内容。
动作是「每一页各自一套」：第 1 页设的动作，翻到第 2 页就不生效了。多页看板通常每一页都要设翻页动作。

例子

/clh p addaction welcome 1 RIGHT NEXT_PAGE
/clh p addaction welcome 2 LEFT PREV_PAGE
/clh p addaction warp 1 right SOUND:ENTITY_ENDERMAN_TELEPORT
/clh p addaction warp 1 right CONSOLE:warp pvp {player}

/clh page removeaction

移除某一页某个点击类型的第几个动作。

项目	内容
用法	`/clh page removeaction <看板> <页> <点击类型> <序号>`
权限	`dh.command.pages.removeaction`
别名	`remaction`
控制台	可以

参数	必填	说明
`<序号>`	是	第几个动作，从 1 开始，按 `actions` 列出的顺序由上往下数（Tab 可补全）

序号超出范围，或这个按键根本没有动作：该动作不存在。
移除后，后面的动作序号会往前补。

例子

/clh p removeaction welcome 1 RIGHT 1
/clh p remaction warp 1 RIGHT 2

/clh page actions

列出某一页某个点击类型的所有动作，每页显示 15 个。

项目	内容
用法	`/clh page actions <看板> <页> <点击类型> [列表页]`
权限	`dh.command.pages.actions`
别名	无
控制台	不行，只能玩家

没有任何动作：该点击类型尚未设置任何动作。
列表不显示序号，由上往下数第 1、2、3… 个，就是 removeaction 要写的序号。
动作超过 15 个时，列表底下会出现翻页按钮，点一下就翻到上一页 / 下一页的列表；也可以直接在指令最后写列表页码，例如 /clh p actions welcome 1 RIGHT 2。

例子

/clh p actions welcome 1 RIGHT
/clh p actions warp 1 LEFT 2

/clh page clearactions

一次清空某一页某个点击类型的全部动作。其他点击类型、其他页不受影响。

项目	内容
用法	`/clh page clearactions <看板> <页> <点击类型>`
权限	`dh.command.pages.clearactions`
别名	无（快捷指令 `/clh clickclear` 效果相近）
控制台	可以

这个按键本来就没有动作：该点击类型尚未设置任何动作。

例子

/clh p clearactions welcome 1 RIGHT
/clh p clearactions warp 2 SHIFT_LEFT

指令一览​

点击类型与动作格式​

/clh page help​

/clh page add​

/clh page insert​

/clh page remove​

/clh page swap​

/clh page switch​

/clh page addaction​

/clh page removeaction​

/clh page actions​

/clh page clearactions​