文字渲染与图标

文字渲染系统

ArcartX 使用 SDF（Signed Distance Field）技术进行文字渲染，替代了传统的位图渲染方式。同时增加了一些特殊效果：描边、流光、渐变等特效。

特殊格式码

除了 Minecraft 原版的格式码（§0~§f、§l、§o 等），ArcartX 还支持以下扩展格式码：

自定义颜色

§#RRGGBB

使用 6 位十六进制颜色值指定文字颜色。例如 §#FF5500 显示为橙色。

描边

§s
§s§0
§s§#RRGGBB

• §s — 开启描边，默认黑色描边
• §s§0 — 描边 + 使用 MC 色码指定描边颜色
• §s§#FF0000 — 描边 + 使用 Hex 颜色指定描边颜色

渐变色

§~RRGGBB-RRGGBB

从第一个颜色渐变到第二个颜色，按文字像素位置线性插值。渐变范围从当前位置开始，到遇到 §r、新颜色码或新渐变码时结束。

例如 §~FF0000-00FF00渐变文字§r 会从红色渐变到绿色。

流光（扫光）

§^RRGGBB

在文字上产生从左到右的高光扫过效果，周期约 1.5 秒。指定的颜色为高光颜色，文字本身保持当前颜色。

例如 §^FFFFFF流光文字§r 会产生白色高光扫过效果。

荧光笔背景

§*RRGGBB

为文字添加半透明的背景色（80% 不透明度），类似荧光笔标记效果。

例如 §*FFFF00高亮文字§r 会添加黄色荧光笔背景。

图标

§%000000龘

在文字中插入自定义图标。6 位数字为图标 ID（000000~999999），后面跟一个 龘 字符作为占位符。

转义符号

如果使用ArcartX文字渲染器接管原版渲染，在聊天栏、物品名等位置使用 ArcartX 格式码时，需要通过转义方式输入 § 符号：

§k!

§k! 会被替换为 § 字符本身。通过这种方式，你可以在聊天栏、物品名等任何位置使用 ArcartX 的文字渲染格式。请注意，由于MC机制，原版不接受任何它不认识的格式，如果同一行有多个该用法，请确保第一个结束之后使用§r清除格式，否则将无法被正常处理，

自定义文字图标

文字图标配置位于服务端 plugins/ArcartX/font_icon/ 目录下，支持创建多个 yml 文件。

配置格式

example:
  # 图标 ID，取值范围 0 ~ 999999
  id: 0
  # 图标贴图路径，支持 PNG 和 GIF
  path: "icons/smile.png"
  # 图标与文字高度的比值（默认 0.8）
  proportion: 0.8

图标的宽度会根据贴图的长宽比自动计算，不需要手动设置尺寸。

使用方式

在文字中使用 §%000000<icon> 格式插入图标，其中 6 位数字对应图标的 ID。

例如图标 ID 为 1，则使用 §%000001<icon>。