跳到主要内容

背景与阴影

1.19.4 以上，看板的文字行会用 TextDisplay 显示。每一行可以设定三种外观：

设定作用值默认
background-color背景颜色'#RRGGBB'（文件里一定要加引号）'#000000'（黑）
background-opacity背景不透明度0～255 的整数64
text-shadow文字阴影true / falsefalse

背景与阴��影对比

TextDisplay 与盔甲架的差别​

DecentHolograms 原本用「隐形盔甲架的名字」显示文字。CloudHologram 在 1.19.4 以上改用 TextDisplay：

TextDisplay（默认）隐形盔甲架
适用版本1.19.4+所有版本
背景颜色 / 不透明度可以调固定原版名牌的淡黑底
文字阴影可以开关没有
永远面向玩家是是
亮度固定全亮，晚上、洞穴里一样清楚全亮
隔着方块被方块挡住就看不到名字会透过方块淡淡地显示
自动换行不会不会

想改回盔甲架，把 config.yml 的 text-display-lines 设成 false，然后重启服务器。改回后背景与阴影设定会被忽略（但不会被删掉）。 1.19.3 以下的服务器一律使用盔甲架，display 设定写了也没有作用。

不透明度怎么选​

值看起来适合
0没有背景，只有文字想要干净的浮空字，建议配 text-shadow: true 让字更清楚
64淡淡一层黑底（与原版名牌差不多）默认，一般用途
128半透明背景很花、需要衬托文字时
192很深，几乎看不到后面公告板、规则说明
255完全不透明的色块做成「招牌」，配合 background-color 换成主题色

background-color 只决定颜色，透明程度一律看 background-opacity。例如想要半透明紫色：background-color: '#4A2A7A' + background-opacity: 170。

text-shadow 是文字本身的阴影（与聊天栏文字一样，在字的右下方多一层深色投影），不是地上的影子。浅色背景或没有背景时，开启会清楚很多。

看板设定与单行设定​

  • 看板最外层的 display 是整个看板的默认值。
  • 每一行可以有自己的 display，只覆盖写到的项目，没写的项目沿用看板的。
  • 看板也没写的项目，用上面表格的默认值。

举例：看板写 background-opacity: 128、text-shadow: true；某一行只写 background-opacity: 0 → 这一行没有背景，但仍然有文字阴影（沿用看板）。

display 只影响文字行。物品、头颅、生物行不受影响。

用指令设定​

项目内容
用法/clh style <看板> [页 行] <background-color|background-opacity|text-shadow|reset> [值]
权限dh.command.holograms.update
控制台可以
参数必填说明
<看板>是看板名称
[页 行]否两个数字（从 1 开始）。写了就只改这一行，不写就改整个看板
background-color值写 #1E1E2E 或 1E1E2E（会自动补 #），必须是六位十六进制
background-opacity值写 0～255 的整数
text-shadow值写 true、on、yes、1、开、是 表示开启（英文不分大小写），其他任何值（例如 false、off）都是关闭
reset不用写值。清除看板（或这一行）的所有 display 设定

例子

/clh style welcome background-opacity 128          # 整个看板半透明
/clh style welcome text-shadow true                # 整个看板开文字阴影
/clh style welcome background-color #1E1E2E        # 整个看板换成深蓝灰底
/clh style welcome 1 1 background-opacity 0        # 只有第 1 页第 1 行没有背景
/clh style welcome 1 3 background-color #4A2A7A    # 只有第 1 页第 3 行是紫底
/clh style welcome 1 3 reset                       # 第 1 页第 3 行回到看板设定
/clh style welcome reset                           # 清除看板的设定（各行自己的设定保留）

指令会立刻存档并更新给正在看的玩家。

写在看板文件​

location: world:0.5:100:0.5
display:                       # 整个看板的默认值
  background-color: '#000000'
  background-opacity: 128
  text-shadow: true
pages:
  - lines:
      - '<gold>这一行沿用看板设定</gold>'
      - content: '<white>这一行没有背景，但有阴影</white>'
        display:               # 只覆盖写到的项目
          background-opacity: 0
      - content: '<white>紫色招牌</white>'
        display:
          background-color: '#4A2A7A'
          background-opacity: 255

写错时 /clh validate 会指出原因，看板不会载入：

错误讯息原因
display.background-color 请使用 '#000000' 格式（要加引号）没加引号（YAML 把 # 后面当成注解）、少了 #，或不是六位
display.background-opacity 必须是 0～255 的整数有小数、超出范围，或加了引号变成文字
display.text-shadow 必须是 true 或 false加了引号变成文字（'true'），或写了 true / false 以外的值
未知的 display 设定：…拼错键名，例如 background-colour

一整块底板​

每一行都有自己的背景，宽度跟着这一行的文字长度。默认行距是 0.3，行与行之间会露出一条缝。

想要「一整块」的效果：

  1. 把每一行的 height 调到 约 0.25（一行文字背景的高度）。比它大会有缝，比它小会重叠（重叠处颜色会变深）。
  2. 背景宽度跟着文字，想要每行一样宽，可以在短的行两边补空格。
  3. 不透明度用 192 或 255，接缝比较不明显。
display:
  background-opacity: 192
pages:
  - lines:
      - content: '<gold>   服务器规则   </gold>'
        height: 0.25
      - content: '<white> 1. 禁止使用外挂 </white>'
        height: 0.25
      - content: '<white> 2. 禁止恶意破坏 </white>'
        height: 0.25

限制​

  • 只有文字行有背景与阴影；display 写在物品、头颅、生物行上不会有效果。
  • 背景是长方形，没有圆角、没有边框、没有渐层。
  • 文字固定全亮，不会因为天色或光照变暗。
  • 被方块挡住时看不到（盔甲架模式的名字则会透过方块显示）。
  • 有 DISABLE_UPDATING 旗标 的看板，用 /clh style 修改后不会立刻更新，玩家离开再回来（或 /clh reload）才会看到。
  • 使用 ViaBackwards 让 1.19.3 以下的客户端进服时，旧客户端可能看不到或显示不同；需要照顾旧客户端时，请把 text-display-lines 设成 false。
最后于 更新