跳到主要内容

建立第一个看板

这一页带你从零做出下面这个「服务器规则」看板：两页、渐变标题、半透明背景、左键下一页、右键上一页。 全程只用指令，大约五分钟。做完后再看一次它存成的 YAML 文件，以后就能直接改文件。

做完的样子：第 1 页与第 2 页

开始前确认：

  • 你是 OP，或有 cloudhologram.admin 权限。
  • 输入 /clh version 看得到版本，表示插件已正常启动（授权版要先填好授权码，见 安装与获取）。

第 1 步：建立看板​

走到想放看板的位置，输入：

/clh create rules <gradient:#78EFFF:#CB9CFF><bold>服务器规则</bold></gradient>
  • rules 是看板名称，之后所有指令都靠它找到这个看板。只能用英文字母、数字、_、-。
  • 后面的文字就是第一行。<gradient:颜色1:颜色2> 是渐变，<bold> 是粗体，写法见 颜色与格式。
  • 看板会出现在你脚下，第一行在最上面，之后加的行往下排。

聊天栏出现「看板已创建！」就成功了。

位置不对？

走到新的位置输入 /clh movehere rules。想让看板放在眼睛高度，把 config.yml 的 holograms-eye-level-positioning 改成 true。

第 2 步：加几行文字​

/clh line add rules 1 <white>1. 不可以使用外挂</white>
/clh line add rules 1 <white>2. 不可以恶意破坏</white>
/clh line add rules 1 <gray>第 {page} / {pages} 页 · <yellow>左键</yellow> 下一页</gray>
  • 这里的 1 是「第 1 页」。
  • {page}、{pages} 会自动换成玩家目前在第几页、总共几页，其他变量见 变量。
  • 打错字不用删掉重来：/clh setline rules 1 2 <white>新的文字</white> 直接改第 1 页第 2 行。

第 3 步：背景与阴影​

/clh style rules background-opacity 120
/clh style rules text-shadow true

background-opacity 是背景的不透明度：0 完全透明，64 是默认的淡淡一层，255 完全不透明。 text-shadow 让文字带阴影，背景很淡时比较好读。各种值的实际样子见 背景与阴影。

1.19.3 以下没有这个效果

背景与阴影需要 1.19.4 以上的服务器。更旧的版本看板照样能用，只是背景固定、没有阴影。

第 4 步：做第二页​

/clh addpage rules <gradient:#FFD37A:#FF8A9C><bold>新手指南</bold></gradient>
/clh line add rules 2 <white>输入 /spawn 回到主城</white>
/clh line add rules 2 <white>输入 /menu 打开菜单</white>
/clh line add rules 2 <gray>第 {page} / {pages} 页 · <aqua>右键</aqua> 上一页</gray>

addpage 会在最后面加一页，第一行就是后面的文字。注意第二页的行要写 2。

现在看板还停在第 1 页——每位玩家各自记得自己看到第几页，要靠点击切换。

第 5 步：点击翻页​

/clh click rules 1 left next
/clh click rules 2 right previous
  • left 是左键，right 是右键，还有 shift-left、shift-right。
  • next 下一页，previous 上一页。

对着看板左键，就会翻到「新手指南」；在第二页右键回到第一页。 每位玩家翻页互不影响。

还想让 Shift＋左键带玩家回主城？

/clh click rules 1 shift-left player: spawn
/clh clickadd rules 1 shift-left sound: UI_BUTTON_CLICK:1:1

click 会取代这个按键原本的动作，clickadd 是追加，所以上面两行的结果是「先执行 /spawn，再播音效」。 全部动作见 点击动作。

第 6 步：看看存成的文件​

所有指令都会马上保存到 plugins/CloudHologram/holograms/rules.yml，内容大致是：

location: world:12.500:64.000:-3.500
enabled: true
display-range: 48
update-range: 48
update-interval: 20
facing: 0.0
down-origin: false
pages:
- lines:
  - content: <gradient:#78EFFF:#CB9CFF><bold>服务器规则</bold></gradient>
    height: 0.3
  - content: <white>1. 不可以使用外挂</white>
    height: 0.3
  - content: <white>2. 不可以恶意破坏</white>
    height: 0.3
  - content: <gray>第 {page} / {pages} 页 · <yellow>左键</yellow> 下一页</gray>
    height: 0.3
  clicks:
    left: next
    shift-left:
    - 'player: spawn'
    - 'sound: UI_BUTTON_CLICK:1:1'
- lines:
  - content: <gradient:#FFD37A:#FF8A9C><bold>新手指南</bold></gradient>
    height: 0.3
  # ……第二页其余的行
  clicks:
    right: previous
display:
  background-opacity: 120
  text-shadow: true

自己写文件时可以写得更短，例如一行只写文字、不写 height。每个项目的意思见 看板文件。

改完文件要让它生效：

/clh validate
/clh reload

validate 只检查不载入：哪个文件哪里写错（动作名称打错、颜色没加引号、位置格式不对、文件名不合规则、旗标拼错…）会直接列出来，正在显示的看板不受影响。没问题再 reload。详见 /clh validate。

接下来​

想做的事看这里
显示物品、头颅、实体行类型
更多颜色写法、字体颜色与格式
点击执行指令、传送、切服点击动作
会动的文字动画
只给 VIP 看基本概念 · 谁看得到 与 权限
全部指令指令总览
最后于 更新