动态物品照明

动态物品照明

利用手持和掉落物品的彩色光芒、可充电头灯以及食用发光浆果后的临时发光来探索。

随身携带光源。

探索时在副手拿一支火把,把发光灯笼留在它落下的地方,或给头盔装上可充电的头灯,解放双手。动态物品光照让便携光源照亮附近的方块和生物,颜色与携带的物品相匹配。

适用于 Minecraft:Java 版 1.21.1 · NeoForge 21.1.200 或 1.21.1 系列更新版本 · Java 21。 使用 NeoForge 21.1.252 构建并测试。无需额外模组依赖。

光照仅为视觉效果。 它不会放置光源方块,也不会改变世界光照等级、生物生成、作物生长、生物 AI 或 F3 界面显示的光照值。看起来明亮的洞穴仍然可能生成敌对生物。

随你移动的光

  • 手持物品: 任一只手中的发光物品会照亮周围环境。系统也会追踪附近玩家和生物手持的光源。
    - 掉落物品: 受支持的物品在被投掷或掉落后会继续照亮该区域,直到被拾取、合并或消失。
    - 83 条内置原版物品规则: 火把、灯笼、蛙明灯、蜡烛、萤石、熔岩桶等都有各自的亮度和颜色设置。
    - 感知水环境的光源: 普通火把和其他火焰类光源在水下停止发光。灯笼和头灯会继续工作,海泡菜只在水中发光。红石火把在水下也会继续发光。
    - 亮度不叠加: 一叠火把与一支火把一样亮。重叠的光照采用最强亮度,而非相加。

为黑暗之处着色

火把光带有暖琥珀色调,灵魂光呈蓝色,红石火把发红光,蜡烛则跟随其染料颜色。动态光照的色调会作用于比现有光照更亮的地形和生物;它不会给日光或已放置的光源重新着色。

颜色以渲染色调的形式应用。手持物品、粒子和方块实体(例如箱子)会获得额外亮度,但不带颜色色调。光影包可能会改变或隐藏效果。

可充电头灯

将灯装在头盔上,即可双手自由地探索。头盔会保留其护甲值、耐久度、附魔、纹饰和自定义名称。灯的充能与头盔耐久度相互独立。

在工作台中使用以下配方制作:

玻璃块 | 玻璃板   | 玻璃块
玻璃块 | 能量源   | 玻璃块
玻璃块 | 头盔     | 玻璃块

六个玻璃块必须为同一种物品。可选择透明玻璃、遮光玻璃或 16 种染色玻璃颜色之一。透明玻璃使用能量源的颜色;染色玻璃会覆盖它,而遮光玻璃则呈现烟熏紫色调。顶部的玻璃板不决定光照颜色。

能量源 默认亮度 满充能 充能物品
火把 14 20 分钟 火把或灵魂火把
灵魂火把 10 20 分钟 灵魂火把或火把
红石灯 14 40 分钟 仅红石灯
红石火把 7 60 分钟 仅红石火把
  • 开启或关闭已佩戴的头灯: 按 H(可重新绑定),或空手主手蹲下并右键点击。佩戴头灯时,该蹲下点击手势会保留给头灯使用。
    - 在合成格中充能: 将匹配的充能物品直接放在头灯上方,合成格中不放其他物品。2×2 的物品栏合成格也可使用。物品会被消耗,头灯会以满充能且开启的状态返回,并保留其玻璃颜色和头盔耐久度。
    - 切换火把类型: 用灵魂火把为火把供能的头灯充能会将其变为灵魂版本,反之亦然。红石粉无法为两种红石变体充能。
    - 更改玻璃或能量源: 以现有头灯作为头盔,再次使用完整的工作台配方。
    - 查看充能: 头灯有充能条和提示信息。充能通常只在头灯被佩戴并开启时消耗;请参阅下方的边缘情况。

服务器设置可以更改新制作或重新充能的头灯的充能时间和亮度。

发光浆果:发光

食用发光浆果会给予玩家 发光 效果,持续 30 秒,产生等级 10 的暖黄色光。再次食用会重新计时,牛奶可移除该效果。手持发光浆果可提供较弱的等级 5 光照,无需食用。

单人游戏与多人游戏

将模组 JAR 安装到 NeoForge 1.21.1 安装目录的 mods 文件夹中。多人游戏中,请在服务器和每位玩家的客户端上安装该模组。它会注册配方、头灯数据和发光效果,因此未安装该模组的客户端无法加入已安装该模组的服务器。在未安装该模组的服务器上仅客户端使用尚未验证,可能会被 NeoForge 拒绝。

光照在每个客户端上绘制。服务器负责处理共享物品规则、头灯充能和发光同步。在单人游戏中,默认使用本地规则;在模组服务器上,通常以共享的服务器规则为准。每位玩家可以选择自己的渲染质量并关闭视觉效果。

专用开发服务器的加入和规则同步已有记录测试。双人测试头灯、开关切换和发光可见性仍待完成。

设置与自定义物品规则

  • 客户端配置: config/dynamicitemlights-client.toml 控制效果开关、手持和掉落光源、发现距离、自动质量缩放、诊断和渲染器模式。
    - 质量预设: 低、均衡和高分别将活动光源上限设为 16、48 和 96。均衡为默认值。当模组的工作量超出预算时,自动缩放可以降低质量。
    - 服务器配置: config/dynamicitemlights-server.toml 控制共享策略、手持和掉落光源、隐身排除,以及头灯亮度和充能时间。
    - JSON 物品规则: 使用本地文件或资源包自定义亮度、颜色、水下行为和适用范围;服务器所有者可以通过数据包分发规则。本地松散规则放在 config/dynamicitemlights/items/<namespace>/<name>.json。
    - 模组物品: 放置发光方块的物品可以从其默认方块状态自动发现。其他物品或依赖上下文的发光体可能需要显式规则。

实用命令:

  • /dilclient toggle —— 启用或禁用你的动态光照。
    - /dilclient quality low|balanced|high —— 选择你的最高质量预设。
    - /dilclient status —— 查看活动光源、渲染器状态和诊断信息。
    - /dilclient export_catalog —— 导出已安装物品的光照信息,用于编辑规则。
    - /dilpolicy reload 和 /dilpolicy status —— 重新加载或查看服务器规则;需要管理员权限。

使用 F3 + T 重新加载本地规则。光源上限和计划的地形更新有助于管理渲染工作量,但性能取决于你的硬件、世界和已安装的模组。

兼容性与已知限制

  • 原版渲染器: 已实现并测试。这是已验证的渲染配置。
    - Embeddium、Sodium 和 Rubidium: 未验证。在默认的 AUTO 模式下,检测到这些模组会禁用本模组的光照。FORCE_ENABLE 是未经测试的覆盖选项,不保证兼容性。
    - 其他动态光照模组: 在 AUTO 模式下,检测到已知的竞争模组 ID 也会禁用本模组的渲染器。请选择一种光照系统;本模组不会替你禁用其他模组。
    - Iris、Oculus 和光影包: 未验证。会显示提示,但本模组会继续渲染。光影包可能显示白光、隐藏效果,或提供自己的手持光照。
    - 模组头盔和玻璃: 配方使用标准头盔和玻璃标签。支持已实现,但特定的第三方组合尚未测试。
    - 光会穿墙: 没有阴影或墙体遮挡计算。快速移动时,地形重绘追赶期间也可能留下短暂的光照拖尾。
    - 色调刷新: 静止光源的地形色调可能会保留之前的外观,直到该区域重绘,包括黄昏前后。
    - 头灯充能边缘情况: 将头灯从光标处直接丢下时,若刚将其取下,可能导致其充能持续消耗直到被拾取。生物身上的头灯在其区块未加载时可能继续消耗充能。

开发状态

版本 1.3.1 包含修正后的头灯充能规则。上述功能已实现,核心系统已有单元测试和游戏内开发检查记录。第三方渲染器和光影支持、特定模组装备、双人功能可见性、生产服务器验证,以及大型服务器或真实硬件性能检查仍未验证。