Luminotype

Luminotype

为 Minecraft 提供的十种动态文字效果。适用于物品名称、附魔描述、悬停提示、聊天框、书籍、告示牌——以及游戏中渲染任何文本组件的任何地方。

Minecraft 1.20.1 · Forge 47.4.x

---

功能简介

在任意文本前写入一个控制代码，即可让其动态化。

&p流光彩虹 Rainbow
&u红线超载 Red Speed Neon
&m合成波核心 Synthwave Neon

无需资源包、无需配置、无需依赖。将 jar 文件放入 mods/ 文件夹后，这些代码即可生效。

---

十种效果

代码	效果
&p	彩虹（Rainbow） — 色彩在文本上流动
&g	故障（Glitch） — 间歇性碎裂；文本本身保持原位
&h	赛博故障（Cyber Glitch） — 红/青色差、像素残影、深色背景、强烈高光
&q	魔力霓虹（Magical Neon） — 紫到青色渐变、粗体、分层光晕
&y	全息投影（Holographic） — 液态虹彩、金属质感深色边缘、锐利白色高光
&s	能量条（Energy Bar） — 半透明青色光条对角扫过字符
&t	熔岩等离子（Lava Plasma） — 橙红黄流动核心、深色描边、火焰光晕
&v	羊皮纸（Parchment） — 古旧法术书风格、紫蓝黄绿色冲洗效果、棕色投影
&u	红线超载（Red Speed Neon） — 浓重红色光晕、水平速度线、红/黑条带、运动残影
&m	合成波核心（Synthwave Neon） — 青至品红 3D 立体拉伸、像素化边缘、双通道色差、VHS 扫描故障

规则

代码可叠加。 &q&t Molten Grimoire 同时应用魔力与熔岩效果。所有十种效果同时开启也行，不过大概不该这么尝试。

&r 重置。 清除所有动态效果和原版格式。§r 与之等价。

&m Synthwave Title&r plain text from here

\&p 转义。 按字面渲染这两个字符，而不是应用效果。

未知代码直接透传。 &x 渲染为 &x — 不会崩溃，也不会吞掉任何内容。

---

适用场景

• 物品自定义名称与附魔描述
• 完整悬停提示框
• 聊天框、书籍、告示牌
• 游戏渲染的任何 Component 组件
• FTB Quests 的标题、子标题、描述与奖励文本（可选）

---

可选兼容性

以下功能均非必需。每个都在运行时检测，仅在存在时自动启用。

• FTB Quests / FTB Library — 代码在任务文本中生效，反射式 API 允许脚本将其写入任务数据
• ModernUI — 文本保持正确的字体回退，而非降级到默认字面

---

脚本开发

模组 ID 为 luminotype，包名为 cn.blockforge.luminotype。

const DynamicTextApi = Java.loadClass('cn.blockforge.luminotype.api.DynamicTextApi')
const FtbQuestTextApi = Java.loadClass('cn.blockforge.luminotype.compat.FtbQuestTextApi')

FtbQuestTextApi.setTitle('5A1B2C3D4E5F6071', '&u Red Overload')
FtbQuestTextApi.setDescription('5A1B2C3D4E5F6071', ['&7 briefing', '&m core status'])
DynamicTextApi.refresh()

任务 ID 请以字符串形式传入 — 它们是完整的 64 位数值，JavaScript 数字会丢失精度。

FtbQuestTextApi 是完全反射式的：即使 FTB Quests 不存在，每个方法也会返回 false 而非抛异常，因此可以不加保护地调用。

在 Java 侧，每个效果都有同名方法（rainbow、cyber、synthwaveNeon 等），另有 parse、stripEffectCodes，以及运行时开关（可在不写入配置的情况下覆盖配置）。

---

配置

config/luminotype-client.toml，首次运行时生成。

键	默认值	说明
enabled	true	总开关
rainbowSpeed	1.35	0.05–8.0
glitchFrequency	16	1–60
refreshIntervalMs	40	16–1000。调高可减少 CPU 占用
maxTextLength	512	每次运行可动态化的可见字符数，16–8192
compatibleScreens	["*"]	允许动态化的界面

另有每个效果独立的开关：rainbowEnabled、glitchEnabled、cyberEnabled、magicEnabled、holographicEnabled、energyBarEnabled、lavaEnabled、parchmentEnabled、redSpeedNeonEnabled、synthwaveNeonEnabled。

compatibleScreens 是对小写屏幕类名的子串匹配，因此 ["inventory"] 就够了——无需完整限定名。* 匹配所有内容；hud 覆盖无界面打开时绘制的文本。

关闭某个效果仍会隐藏其代码。 文本回退到纯色与默认格式，而不是显示字面的 &p。

---

性能

不含控制代码的文本零开销 — 解析器扫描一遍、未找到代码、直接返回原文。

带有效果的文本按字形逐字渲染，比普通文本更消耗资源。有三个调节杠杆：调高 refreshIntervalMs、调低 maxTextLength、或收窄 compatibleScreens。

---

注意事项

&m 是原版的删除线代码。 本模组将其征用为合成波核心效果。如需删除线请使用 §m。没有其他原版代码冲突。

&o 曾是抖动效果，现已移除。 该代码现在被静默剥离；文本正常渲染。

客户端渲染。 动画在字体渲染阶段发生，因此服务器无需安装此模组——但控制代码存于服务器端数据（如物品 NBT 和任务文件）中，未安装模组的玩家会看到字面的 &p。制作整合包时，请要求所有客户端安装。

---

也可在 Iron's Spells: Light Pollution 中使用

该模组内置了同样的十种效果。两者同时安装时，Luminotype 优先，另一方的副本自动停用，因此不会产生冲突，也不会重复解析。仅安装 Light Pollution 也能使用这些代码；Luminotype 则维护 FTB Quests 和 ModernUI 的兼容性。