富文本渲染（drawable/text 包）
基本信息
| 属性 | 值 |
|---|---|
| 包路径 | com.cleanroommc.modularui.drawable.text |
| 文件数 | 18 |
| 入口 | TextRenderer（基类）、RichText（复合文本） |
| 接口 | ITextLine（api/drawable/ITextLine.java）、IKey（api/drawable/IKey.java） |
| 调试颜色 | debugTextColor（#FFAAAAAA）、debugOutlineColor（#DCB42873） |
ModularUI2 有自己的文本渲染实现（drawable/text/ 的 18 个类），
但并非完全不用原版字体：绘制入口 drawable/GuiDraw.java 同时 import 了
net.minecraft.client.gui.FontRenderer（:17）并在 :360 取
Minecraft.getMinecraft().fontRenderer；
另有 core/mixins/early/minecraft/FontRendererAccessor.java:9
（@Mixin(FontRenderer.class)）为原版字体生成访问器，
GuiScreenMixin.java:58/:68 用它接管原版 drawHoveringText 的 tooltip 渲染。
功能
文本键（IKey 家族，5 个实现）
文本的「键」把「要显示什么」抽象出来，同一份内容可被替换或延迟求值：
| 类 | 文件 | 说明 |
|---|---|---|
LangKey |
drawable/text/LangKey.java |
取自语言文件的文本（modularui2.* / modularui.*） |
StringKey |
drawable/text/StringKey.java |
字面字符串 |
DynamicKey |
drawable/text/DynamicKey.java |
动态求值的文本 |
BaseKey |
drawable/text/BaseKey.java |
上述的抽象基类 |
KeyIcon |
drawable/text/KeyIcon.java |
把文本键渲染成图标 |
TextIcon |
drawable/text/TextIcon.java |
文本图标 |
文本结构
| 类 | 文件 | 说明 |
|---|---|---|
TextLine |
drawable/text/TextLine.java |
一行文本（实现 ITextLine） |
ComposedLine |
drawable/text/ComposedLine.java |
由多段拼接成的行 |
CompoundKey |
drawable/text/CompoundKey.java |
复合键（多段拼接） |
Spacer |
drawable/text/Spacer.java |
空白间隔 |
富文本与渲染
| 类 | 文件 | 说明 |
|---|---|---|
RichText |
drawable/text/RichText.java |
富文本容器 |
RichTextCompiler |
drawable/text/RichTextCompiler.java |
把带格式的源码编译成 TextLine |
StyledText |
drawable/text/StyledText.java |
带样式的文本 |
FormattingState |
drawable/text/FormattingState.java |
格式状态机 |
TextRenderer |
drawable/text/TextRenderer.java |
渲染器基类（TextFieldRenderer 继承它） |
FontRenderHelper |
drawable/text/FontRenderHelper.java |
字体渲染辅助 |
TextDrawParams |
drawable/text/TextDrawParams.java |
绘制参数 |
AnimatedText |
drawable/text/AnimatedText.java |
带动画的文本 |
格式语法
格式语法可在仓库自带示例中看到
（src/main/resources/assets/modularui2/guis/test.json:18）：
§{#3058B8}Blue §nUnderlined§rBlue §{#469E8F}Mint Hello
| 记号 | 含义 |
|---|---|
§{...} |
自定义颜色（#RRGGBB 形式） |
§n |
下划线 |
§r |
重置格式 |
同仓库的 assets/modularui/lang/en_us.lang 大量使用原版颜色码
（§b、§7、§6、§e、§a、§9、§c），两套语法共存。
消费者
| 消费者 | 文件 | 用途 |
|---|---|---|
RichTooltip |
screen/RichTooltip.java:35 |
提示气泡内容（implements IRichTextBuilder<RichTooltip>） |
RichTextWidget |
widgets/RichTextWidget.java |
可交互的富文本控件 |
TextFieldRenderer |
widgets/textfield/TextFieldRenderer.java |
文本框渲染（extends TextRenderer） |
数值
| 数值名 | 值 | 来源 |
|---|---|---|
| 文本相关类数 | 18 | drawable/text/ |
| 调试文字色 | #FFAAAAAA |
ModularUIConfig.java:42 |
| 调试轮廓色 | #DCB42873 |
ModularUIConfig.java:46 |
| 兜底部件文字尺寸 | 18 | api/IThemeApi.java:35（darkTextNoShadow(18, 18, null)） |
交互
| 触发 | 行为 |
|---|---|
| 界面渲染 | TextRenderer 逐 TextLine 绘制 |
配置了 guiDebugMode |
叠加控件轮廓与调试文字（用上述两种调试色） |
| 悬停控件 | RichTooltip 用同一套系统渲染提示内容 |