Embers Text API

一个库模组，可完全控制动画化、样式化的文本叠加层。显示丰富的屏幕信息，支持彩虹渐变、霓虹辉光、打字机逐字揭示、故障扭曲等效果……所有效果均可组合和叠加。

点击任意预览——每种效果在*文档*中都有动画示例。

功能

• 视觉效果：彩虹、渐变、故障、波浪、抖动、脉冲、轮廓等……逐字符且可叠加
• 霓虹辉光：基于SDF的字形光晕，可控制颜色、半径、柔度和脉冲
• 动画：打字机文本、模糊揭示/隐藏、滚动跑马灯
• 消息效果：整条消息的动态效果，如猛砸、破碎、矩阵、滑动、呼吸和旋转
• 标记解析器：使用XML风格标签简易样式化文本：<rainbow>、<wave>、<neon>、[slam]
• MSDF字体渲染：使用多通道有符号距离场，在任何缩放比例下清晰渲染TrueType/OpenType字体，并保留锐利拐角
• 内联渲染：文本中可嵌入物品和实体
• 服务端控制：从服务器向客户端发送样式化消息
• 高度可定制：逐字符效果、渐变、背景、锚点和队列通道

---

命令

命令	描述
/eta send player duration text	发送一条样式化消息
/eta queue player channel definition	在指定通道上排队顺序消息
/eta test id	播放内置演示消息
/eta test effect name	预览单个效果
/eta test combo effects	预览效果组合

---

面向开发者

Embers Text API 提供了一个完整的 Java API，用于从服务器发送样式化消息。可以注册自定义效果、解析标记或以编程方式构建文本跨度。

请查看**文档**了解集成指南和API参考。

---

面向整合包制作者

• 这是一个库/API模组，本身不会对游戏玩法产生任何影响，但命令系统允许你在游戏中创建和测试效果，内联标记（如<rainbow>或<neon>）可用于样式化物品名称、提示文本和任务描述！
• 可安全包含在任何整合包中。
• 非常适合任务描述、提示、Boss登场或任何时尚的文本叠加。
• 兼容KubeJS和数据包！v3版本内置了KubeJS支持！