Hex Text

Hex Text 为 Minecraft 的字体渲染器拓展了现代色彩处理流程，支持完整的 RGB 十六进制代码、嵌套颜色跨度以及多种文字动画效果。

本文档汇总了可用的格式符号及其交互方式，帮助你充分利用该系统。

该模组运行需依赖 UniMixins，服务端与客户端均支持安装。

Minecraft 标准格式

所有原版 § 样式的格式代码均保持与原版 Minecraft 完全一致的功能。

使用 Hex Text 时，你可选择用 & 符号替代 § 以简化输入；若服务器允许 & 格式，Hex Text 会在渲染时自动将其标准化为游戏可识别的格式。支持的代码如下：

符号描述

&0–&9、&a–&f 原版调色板颜色（共 16 种）

&k 混淆/随机字符
&l 粗体文本
&m 删除线
&n 下划线
&o 斜体文本
&r 重置颜色并清除样式/效果

若你偏好原版语法，也可继续使用 § 而非 & 输入相同代码。

直接 RGB 颜色

Hex Text 支持两种聚焦 RGB 的语法，让你突破原版调色板限制：

内嵌十六进制颜色

使用 &#RRGGBB（或 §#RRGGBB）可立即切换至精确的 RGB 颜色（例如 &#ff8800）；

颜色变更从该代码后的第一个字符开始生效，并清除此前激活的所有嵌套颜色跨度。

作用域十六进制跨度

用 ... 包裹文本段落，可将颜色应用至匹配的结束标签处；

这些跨度支持嵌套，且能与内嵌十六进制颜色代码配合使用；

关闭跨度会恢复之前的颜色，无需永久覆盖颜色栈即可轻松临时高亮文本；

服务器可禁用此类 HTML 风格标签，仅允许使用内嵌代码进行格式设置；

两种语法均支持大小写十六进制数字。

特殊效果

除原版样式切换外，Hex Text 新增了四种额外效果代码。

与其他格式代码相同，它们均可使用 & 或 § 输入：

符号效果

&g 启用彩虹动画着色器，需用 &r 清除
&h 文本上下翻转（Dinnerbone 效果）
&i 为文本添加火焰燃烧叠加层
&j 应用轻微震动/抖动动画

效果会持续生效直至渲染器重置。任何显式重置（&r）或颜色栈变更（如应用新颜色、关闭跨度）都会清除效果，因此需将效果代码放在待动画的颜色之后。

创作者提示

十六进制颜色代码必须为六位十六进制数字，不支持简写形式（如 #abc）；

嵌套跨度安全可靠，渲染器会维护内部颜色栈，关闭跨度时自动恢复之前的颜色；

可在单个字符串中自由组合 RGB 颜色、原版颜色代码及样式/效果切换，Hex Text 会在渲染前解析出预期效果。

借助这些符号，你可实现复杂渐变、高亮文本段落或制作动画聊天消息，同时保持与 Minecraft 现有格式系统的兼容性。

服务器配置

Hex Text 通过配置文件的服务器分类提供多项服务端切换功能：

enableRgbHtmlFormat：启用时解析上述和标签，禁用时将其视为普通文本；

allowSignEditing：控制玩家是否可空手右键点击告示牌打开编辑器；

universalAmpersandFormatting：允许用 & 作为 § 的替代符号，用于格式代码和直接 RGB 颜色；

ampersandsInChat：发送聊天消息或命令时，将 & 格式符号转换为 §；

ampersandsInSigns：编辑告示牌时，将 & 格式符号转换为 §；

ampersandsInRepairs：在铁砧重命名物品时，将 & 格式符号转换为 §。

这些选项可帮助服务器根据管理需求或游戏玩法，灵活调整 Hex Text 的功能表现。