Embers Text API - 余烬文本API

Embers Text API

一个提供对动画化、样式化文本覆盖层完全控制的库模组。显示丰富的屏幕消息，支持彩虹渐变、霓虹辉光、打字机式揭示、故障失真等多种效果——所有效果均可组合与堆叠。

支持版本： Forge 1.20.1 | Fabric 1.20.1 & 1.21.1 | NeoForge 1.21.1

文档与维基：

注意： 从 v2 版本起，Caxton 不再兼容，因为它替换了原版文本渲染器。你仍可使用自定义字体——只需使用 TTF 字体而非 OTF。

功能特性

• 19+ 内置效果 — 彩虹、渐变、脉动、波浪、抖动、弹跳、故障、霓虹辉光、打字机、混淆、阴影、摇摆、湍流、圆形、扭动、钟摆、滚动、淡入淡出和颜色。
• 可组合的效果堆叠 — 在同一文本上叠加任意数量的效果。每个效果都会修改前一个结果。
• 标记语言 — 使用类似 XML 的标签声明式地样式化文本：你好！
• 预设系统 — 将效果打包成可重用的 JSON 预设，并将其作为标签使用：`、、`——或创建你自己的预设。
• 消息队列 — 在指定频道上链接消息，用于顺序或并行播放。
• 内联物品与实体 — 直接在文本内渲染物品图标和实体模型。
• 背景 — 消息后方支持纯色、渐变、边框或纹理背景。
• 自定义字体 — 在 assets/emberstextapi/font/ 下放置你自己的位图字体。
• 灵活的定位 — 锚点、对齐、偏移、缩放、淡入/淡出。
• 命令 — 使用 /eta send、/eta queue 和 /eta test 进行测试和原型设计。

命令

面向开发者

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

查看 文档 获取集成指南和 API 参考。

面向整合包开发者

• 这是一个库模组——它本身不会对游戏玩法产生任何影响，但命令系统允许你在游戏内创建和测试效果。此外，你还可以使用内联文本样式标签（如 ``）来美化物品和任务描述等内容！
• 可安全包含在任何整合包中。
• 非常适合用于任务描述、提示、Boss 介绍或任何需要风格化文本覆盖层的场景。
• 与 KubeJS 和数据包兼容！