config.yml

plugins/CloudHologram/config.yml 是插件的全局设定。第一次启动时自动生成，注释都是中文。

修改后怎么生效

设定	生效方式
`text-display-lines`、`defaults.lru-cache-size`	重启服务器
其他全部	`/clh reload`

几个要知道的规则：

数字会被限制在范围内：例如 click-cooldown: 9999 实际会当成 300。各项的范围见下表。
删掉某个键不会恢复默认值：/clh reload 只读取文件里有写的键，删掉的键会保留删除前的值，直到重启。想恢复默认，请把默认值写回去。
升级后不会自动补上新设定：新版本新增的设定，如果你的 config.yml 没有，会直接使用默认值。想调整就自己把键加进去。
想要一份全新的 config.yml：把文件改名或删除，执行 /clh reload，插件会重新生成带中文注释的默认文件。

新看板的默认值（defaults）

defaults:
  text: 空白行
  display-range: 48
  update-range: 48
  update-interval: 20
  lru-cache-size: 500
  height:
    text: 0.3
    icon: 0.6
    head: 0.75
    smallhead: 0.6
  down-origin: false

键	类型	默认	范围	作用
`defaults.text`	文字	`空白行`	—	`/clh line add`、`/clh line insert`、`/clh page add` 等没写内容时，新行使用的文字。
`defaults.display-range`	整数（格）	`48`	1～48	新看板的显示范围；看板文件没写 `display-range` 时也用这个。
`defaults.update-range`	整数（格）	`48`	1～48	新看板的更新范围（变量与动画会刷新的距离）。
`defaults.update-interval`	整数（tick）	`20`	1～1200	新看板的变量刷新间隔，20 tick = 1 秒。
`defaults.lru-cache-size`	整数	`500`	5～10000	颜色代码处理结果的缓存数量。看板文字种类非常多时可以调大，会多用一点内存。重启生效。
`defaults.height.text`	数字	`0.3`	0～2.5	新文字行占的高度。
`defaults.height.icon`	数字	`0.6`	0～2.5	新 `#ICON:` 行的高度。
`defaults.height.head`	数字	`0.75`	0～2.5	新 `#HEAD:` 行的高度。
`defaults.height.smallhead`	数字	`0.6`	0～2.5	新 `#SMALLHEAD:` 行的高度。
`defaults.down-origin`	true / false	`false`	—	新看板是否从位置点往上排列。

这些只影响之后新建的看板与行；已经存在的看板以自己文件里的值为准。（看板文件里的范围可以用 /clh hologram setdisplayrange 等指令另外设到 64。）

一般设定

键	类型	默认	作用
`click-cooldown`	整数（tick）	`1`	同一个玩家两次点击看板之间至少要隔多久（范围 1～300）。所有看板共用一个冷却。玩家狂点导致指令重复执行时，可以调到 `10`（半秒）左右。
`allow-placeholders-inside-animations`	true / false	`false`	`true` = 动画的每一帧也解析 PlaceholderAPI 变量。会明显增加 CPU 使用，确定需要才开。
`update-visibility-on-teleport`	true / false	`false`	`true` = 玩家传送或重生后，先把所有看板隐藏再重新显示。部分客户端传送后看板会消失，遇到这个问题才开；开了以后即使只传送一小段距离，看板也会闪一下。
`holograms-eye-level-positioning`	true / false	`false`	`true` = `/clh create`、`/clh movehere`、`/clh clone` 把看板放在玩家眼睛高度；`false` = 放在脚下。
`displays-eye-level-positioning`	true / false	`false`	同上，给 Display 实体的建立与 `movehere` 用。
`text-display-lines`	true / false	`true`	`true` = 文字行使用 TextDisplay（1.19.4+），可以设定背景与阴影，而且永远全亮、不受昼夜影响；`false` = 改用旧的隐形盔甲架（和 DecentHolograms 一样）。1.19.3 以下一律使用盔甲架。重启生效。
`player-skin-connection-timeout`	整数（秒）	`5`	保留项，范围 1～60。目前版本没有用到这个值，改了不会有变化。
`update-checker`	true / false	`false`	保留项，只为兼容。云全息不会连线检查更新。

伤害显示（damage-display）

生物或玩家受伤时，在它身上短暂飘出伤害数字。默认关闭。

damage-display:
  enabled: false
  players: true
  mobs: true
  zero-damage: false
  duration: 40
  appearance: '&c{damage}'
  critical-appearance: '&4&l暴击！&4 {damage}'
  height: 0

键	类型	默认	作用
`enabled`	true / false	`false`	是否开启。
`players`	true / false	`true`	玩家受伤时显示。
`mobs`	true / false	`true`	生物（非玩家）受伤时显示。
`zero-damage`	true / false	`false`	最终伤害是 0（或更低）也显示。
`duration`	整数（tick）	`40`	数字停留多久，40 tick = 2 秒。
`appearance`	文字	`&c{damage}`	一般伤害的样式。
`critical-appearance`	文字	`&4&l暴击！&4 {damage}`	暴击时的样式。
`height`	数字	`0`	高度偏移（格），正数往上。

细节：

显示的数字：{damage} 是扣完护甲、附魔等之后的最终伤害，最多一位小数（例如 7、4.5）。
位置：受伤者脚下往上 1 + height 格，再随机偏移最多半格，连续打击时数字不会叠在一起。
谁看得到：数字是一个临时的文字行，会发给和受伤者在同一个世界的所有在线玩家，没有权限过滤；离得远的人自然看不到。
暴击判定：攻击者必须是玩家本人近战（弓箭等投射物不算），并且正在下落、不在地上、没有骑乘、没有失明、不在梯子或藤蔓上、没有缓降效果。条件和原版暴击相近，但没有检查疾跑与水中。
盔甲架受伤不会显示；被其他插件取消的伤害不会显示。
appearance 可以用 & 颜色、MiniMessage 与 PlaceholderAPI 变量。变量是以「看到数字的玩家」来解析的（%player_name% 会显示成每个观看者自己的名字，不是受伤者）。
也可以写动画，但数字出现后不会再刷新，只会停在出现那一刻的画面。

治疗显示（healing-display）

生命值回复时飘出回复量。默认关闭。

healing-display:
  enabled: false
  players: true
  mobs: true
  duration: 40
  appearance: '&a+ {heal}'
  height: 0

键	类型	默认	作用
`enabled`	true / false	`false`	是否开启。
`players`	true / false	`true`	玩家回血时显示。
`mobs`	true / false	`true`	生物回血时显示。
`duration`	整数（tick）	`40`	停留多久。
`appearance`	文字	`&a+ {heal}`	样式，`{heal}` 是回复量（最多一位小数）。
`height`	数字	`0`	高度偏移。

细节：

回复前已经满血的不显示；回复量是 0 的不显示；被取消的回血不显示。
位置、谁看得到与伤害显示相同。
任何原因的回血都算，包含玩家靠饱食度自然回血，所以玩家身上会很频繁出现。觉得太吵可以把 players 改成 false。

用指令临时开关

/clh feature enable damage_display
/clh feature disable healing_display
/clh feature reload damage_display

enable / disable 只在这次开服期间有效，不会写回 config.yml；/clh reload 或重启后会回到 config.yml 的设定。
feature reload 重新套用上一次 /clh reload（或开服）时读到的设定，不会重新读取文件。改了 config.yml 请用 /clh reload。
要永久开启，请把 enabled 改成 true 再 /clh reload。指令说明见其他指令。

自定义文字替换（custom-replacements）

在看板文字里写短代码，显示成特殊符号。适合画进度条或分隔线：

custom-replacements:
  '[x]': '█'
  '[X]': '█'
  '[/]': '▌'
  '[,]': '░'
  '[,,]': '▒'
  '[,,,]': '▓'
  '[p]': '•'
  '[P]': '•'
  '[|]': '⎹'

例子：

lines:
  - '&a[x][x][x][x][x][x]&7[x][x][x][x]'   # 显示成 60% 的进度条
  - '&8[,,][,,][,,] &f公告 &8[,,][,,][,,]'

注意事项：

键和值都要用引号包起来；值必须是文字，写成数字或列表的项目会被忽略。
可以自己加新的代码，例如 '[heart]': '❤'。改完 /clh reload 生效。
如果你在 config.yml 写了 custom-replacements，会整个取代默认的列表。想保留默认的 [x] 等代码，就不要删掉它们。
替换只对文字行有效，而且是直接改写行的内容：看板被指令修改、存档后，文件里会变成替换后的符号（例如 █），不再是 [x]。

提示文字

所有聊天提示（看板已创建！ 之类）都在 lang.yml，不在这里。见 lang.yml。

修改后怎么生效​

新看板的默认值（defaults）​

一般设定​

伤害显示（damage-display）​

治疗显示（healing-display）​

用指令临时开关​

自定义文字替换（custom-replacements）​

提示文字​