LiliumStudio

Lilium 动态光照

作者：LiliumStudio
适用平台：Minecraft 基岩版

Lilium 动态光照是一款贴近原版体验的独立附加包，为玩家、生物和掉落物带来实时动态光照效果。它不会修改任何原版方块或实体组件，能够直接融入生存世界与领域。

主要功能

玩家、生物与物品动态光照：火把、灯笼、荧石以及数十种其他发光物品，在被手持、装备或丢弃时，都会自动照亮周围环境。 彩色光照：开启 Vibrant Visuals 后，光源会根据自身颜色呈现对应光效，支持 16 种染料颜色，并能自动识别部分原版物品与已放置的发光方块。例如，灵魂灯笼会发出蓝色光芒，红石火把会呈现红色光效。关闭 Vibrant Visuals 时，则会回退为标准白光。 可调节检测范围：可在“常规设置”菜单中，将实体和生物光源检测距离调整至最多 128 格，并将发光方块扫描半径调整至最多 32 格。 原生 20 FPS 低延迟引擎：以接近一对一的方式追踪动态光源，移动时不会留下光照拖影，并会自动即时清理无效光源。 智能多光源混合：当多个光源逐渐远离时，光照会平滑减弱，而不是突然熄灭。 火焰与爆炸响应：正在燃烧的实体，以及已蓄力或即将爆炸的苦力怕，都会产生自身光照。 双击潜行切换副手光源：连续潜行两次即可将光源切换到副手，同时保留主手武器。 游戏内配置菜单：无需退出游戏，即可开关功能、调整检测范围，并注册自定义发光物品、生物和方块。 崩溃安全持久化：已经放置的光源会在世界重新加载后继续保留，即使游戏发生崩溃，也能安全恢复。 公开标签与组件 API：其他附加包制作者可以通过简单标签让物品和生物发光，也能使用单个 JSON 组件为自定义方块添加动态光照，无需编写脚本。

功能预览

预览图 1、预览图 2、预览图 3、预览图 4、预览图 5、预览图 6、预览图 7、预览图 8。

官方扩展附加包：Lilium 动态光照：额外内容

Lilium 动态光照：额外内容是 Lilium 动态光照的官方扩展包，为世界加入更多发光物品、方块和动画内容。

16 种染色火把：支持全部 16 种染料颜色，可制作、放置，也能作为物品使用，并提供 14 级彩色动态光照。 102 顶矿工头盔：包含锁链、铜、钻石、金、铁和下界合金 6 种护甲等级。每个等级提供默认颜色及 16 种染料颜色，共计 17 种配色；装备在头部时会发出 14 级动态光照。 Actions & Stuff 联动支持：原生支持 Oreville Studios 的 Actions & Stuff 动画资源包子包，可兼容第一人称持握动画与 Molang 变量。 创造模式目录与合成配方：提供完整合成配方，并加入独立的创造模式目录分组，方便查找和整理。

预览图 10、预览图 11、预览图 12。

第三方公开 API 与自定义组件

自定义物品标签

将以下标签加入自定义物品 JSON 的 minecraft:tags 中，即可让物品发出动态光照。

标签 说明 ldl:level_light_{1-15} 必需标签，用于设置物品发出的光照等级。 ldl:vv_{color} 开启 Vibrant Visuals 时设置光照颜色，可使用 white、light_gray、gray、black、red、orange、yellow、lime、green、cyan、light_blue、blue、purple、magenta、pink、brown。 ldl:water 让物品在水下仍然保持发光。 ldl:offhand 允许通过双击潜行动作将物品切换至副手。 ldl:equipped_{slot} 将光照限制在指定装备栏位，可使用 any、mainhand、offhand、head、chest、legs 或 feet。

自定义生物与实体标签

可以通过生成事件命令、.mcfunction 文件或 Script API 为实体添加这些标签，例如使用 /tag @s add ldl:... 或 entity.addTag(...)。

标签 说明 ldl:level_light_{1-15} 必需标签，用于设置生物或实体发出的光照等级。 ldl:vv_{color} 开启 Vibrant Visuals 时设置光照颜色，例如 white、red、blue 或 green。 ldl:water 让生物或实体在水下仍然保持发光。

标签可以在任何时候添加或移除，因此生物在存活期间也能动态开始或停止发光。只需添加或移除对应的 ldl:level_light_{n} 标签即可。

自定义方块组件

在自定义方块 JSON 中加入 ldl:light 组件，即可让方块发出动态光照，无需编写脚本。

{ "format_version": "1.26.0", "minecraft:block": { "description": { "identifier": "my_addon:crystal" }, "components": { "ldl:light": { "level": 15, "color": "purple", "water": true } } } } 参数 说明 level 必需参数，用于设置方块发出的光照等级，范围为 1–15。超出范围的数值会被忽略。 color 开启 Vibrant Visuals 时设置光照颜色，可使用 white、light_gray、gray、black、red、orange、yellow、lime、green、cyan、light_blue、blue、purple、magenta、pink 或 brown。省略此参数时使用白光。 water 设置方块浸入水中后是否继续发光，默认值为 false。

使用该组件的方块必须声明 format_version 1.26.0 或更高版本，旧版本会拒绝加载此组件。每个方块都可以单独设置参数，因此同一方块系列的不同变体也能使用不同的光照等级。

基岩版附加包规格

无需开启实验性玩法，可直接用于生存世界或领域。 支持 Minecraft 基岩版 1.26.0 及更高版本。 不修改任何原版方块或实体组件，具有较高兼容性。 基于 @minecraft/server v2.8.0 与 @minecraft/server-ui v2.1.0 开发。 支持 19 种语言本地化。

基岩版限制与性能说明

动态光照基于隐形 light_block 方块模拟，因为基岩版目前没有原生方式将光源直接绑定到移动实体。

彩色光照必须依赖 Vibrant Visuals。关闭该图形选项后，所有动态光照都会以标准白光显示。

发光方块扫描半径过大时，会显著增加每个游戏刻所需执行的空间方块检查。将“常规设置”中的扫描半径提高到 6–8 格以上，可能会让性能较弱的设备出现卡顿。为了获得更稳定的表现，建议将该数值保持在 4–6 格之间。

Lilium 动态光照基岩版由 Lilium Studio 开发。