跳到主要内容

旗标

旗标（flag）是停用某个功能的开关。平常不需要用；当你想要「这个看板不要动画」「这行字要原样显示 %」时才加。

一共四个：

旗标一句话加在看板加在单行
DISABLE_PLACEHOLDERS不替换变量所有文字行这一行
DISABLE_UPDATING不定时更新所有行这一行
DISABLE_ANIMATIONS不播放动画所有文字行这一行
DISABLE_ACTIONS不执行点击动作整个看板没有效果
  • 加在看板上的旗标，对看板里每一页的每一行都有效。
  • 加在行上的旗标只影响那一行。
  • 一行「有效的旗标」= 这一行自己的旗标 ＋ 看板的旗标。没办法在看板有旗标时，让某一行例外。

DISABLE_PLACEHOLDERS​

文字行里的变量不会被替换，原样显示：{player}、{page}、{pages} 与 PlaceholderAPI 的 %...%。

  • 用途：教学看板想显示 %player_name% 这几个字本身。
  • 只影响文字行。物品 / 头颅行的 ({player})、生物行、点击动作里的变量照常替换。
  • 文字行的动画照常播放。

DISABLE_UPDATING​

不再定时更新。

  • 变量只在看板出现在玩家画面时计算一次，之后不再变化（update-interval 失效）；玩家走远再回来会重新计算。
  • 用指令修改这一行的文字（同类型，例如文字改文字）或用 /clh style 改样式时，正在看的玩家不会马上看到，要离开显示范围再回来、重新进服或 /clh reload 才会更新。
  • 动画照常播放（动画不算「更新」）；要停动画请用 DISABLE_ANIMATIONS。
  • 用途：内容固定不变、看的人又很多的看板，可以省一点效能。

DISABLE_ANIMATIONS​

不播放动画。

  • 加在看板上：整个看板的动画都停止计算。
  • 加在行上：只有这一行停止。
  • 动画标签不会被处理，<#ANIM:...>、{#ANIM:...}、&u 会原样出现在文字里。所以停用动画时，最好也把标签拿掉。
  • 变量照常更新。

DISABLE_ACTIONS​

不执行 点击动作。

  • 动作仍然保存在文件里，移除旗标后恢复。
  • 看板不会再放「接收点击用的隐形盔甲架」，所以玩家点看板时会直接打到后面的东西。
  • 其他插件的 HologramClickEvent 照常触发（如果有插件在监听，盔甲架也照常存在）。
  • 只能加在看板上。加在单一行上没有任何效果，因为点击动作是属于「页」的，不属于行。

用指令加旗标​

/clh hologram addflag​

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

/clh hologram removeflag​

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

/clh line addflag​

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

/clh line removeflag​

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

例子

/clh hologram addflag welcome DISABLE_ANIMATIONS      # 整个看板停用动画
/clh hologram removeflag welcome DISABLE_ANIMATIONS   # 恢复
/clh line addflag tutorial 1 2 DISABLE_PLACEHOLDERS   # 第 1 页第 2 行原样显示变量
/clh hologram addflag shop DISABLE_ACTIONS            # 暂时关闭商店看板的点击
  • 旗标名称必须全部大写，与上表一模一样（disable_actions 会显示「找不到旗标」）。按 Tab 可以补全。
  • 指令会立刻存档。

写在看板文件​

location: world:0.5:65:0.5
flags:                         # 看板的旗标
  - DISABLE_ACTIONS
pages:
  - lines:
      - '<gold>普通的一行</gold>'
      - content: '教学：输入 %player_name% 会显示你的名字'
        flags: [DISABLE_PLACEHOLDERS]   # 这一行的旗标
拼错旗标的后果不一样
  • 看板的 flags 拼错：整个看板载入失败，控制台会出现错误。
  • 行的 flags 拼错：控制台警告「Flags for line ... seem to be invalid」，这一行的所有旗标都被忽略，看板仍会载入。

改完文件先执行 /clh validate：看板和行的 flags 里只要有拼错的名称，都会列出来（例如 flags 里有不存在的旗标：disable_actions）。

最后于 更新