Pulsar Lighting Engine

模组

· 作者 pepelys

将基于 Starlight 的光照引擎移植到 CleanroomLoader

0 本站下载 0 关注 更新于 2 天前

最新 0.6.6-beta · 1.12.2 · Forge

一键开服(送7天)

Pulsar Lighting Engine

概述

Pulsar 是 Cleanroom 的光照引擎模组,基于 Starlight 和 SuperNova。 它使用源自 Starlight 的基于队列的广度优先搜索(BFS)光照传播算法,替换了 Minecraft 原版的光照引擎。 它提供了类似 Starlight 的非彩色标量(SCALAR)光照模式,以及类似 SuperNova 的全 RGB 彩色光照模式。

特性

  • RGB 彩色光照:按 RGB 通道分别计算方块光和天空光,考虑光源颜色以及透过染色玻璃等方块的过滤效果。
  • SCALAR 模式:使用传统的非彩色光照计算,与 Starlight 类似。
  • 异步并行处理:在独立的工作线程上运行服务器端的光照传播。
  • 批量光照更新:将大量方块变化引起的光照更新进行分组处理。
  • 光照数据缓存:将计算出的光照数据保存在区块 NBT 中,避免在加载区块时重新计算。
  • 各种未在此列出的额外错误修复和生活质量改进。
  • Thaumcraft 水晶的自然光照。

已修复的 Bug

兼容性

  • JSON Paintings:为该模组添加的画作应用平滑光照。
  • SpongeForge:包含对异步光照的兼容支持。
  • Fluidlogged API:考虑存储在方块内流体的不透明度和发光属性。
  • CBMultipart:标准微型方块继承其材料的光源颜色。自定义部件除非有专门的集成处理,否则保持中性发光。
  • ProjectRed:全方块灯、多部件灯具、光按钮和光微型方块材料提供 RGB 发光,保留其实际亮度和电源状态。
  • Depths Update:支持扩展的世界高度范围。
  • Thaumcraft:为水晶添加平滑光照。
  • Celeritas:支持其渲染管线。
  • Demonica Shader:已与 Complementary Reimagined 测试并确认正常工作。
    • 不能保证与 Actinium、Pintonium 和 Impetus 等分支兼容。

不兼容项

Pulsar 完全替换了光照引擎,因此与其他光照引擎模组不兼容。

  • Alfheim
  • Phosphor
  • Hesperus
  • Starlight-1.12
  • OptiFine:请改用 Celeritas。Demonica Shader 提供光影支持,而 Celeritas Extra 和 Celeritas Leaf Culling 应涵盖额外的视频选项。
  • The Aether II:请改用 The Aether II: Phosphor Not Included。

配置

  • config/pulsar.cfg:选择光照模式并配置其他功能。
    • lightingMode:RGB(默认,RGB 彩色光照)或 SCALAR(传统非彩色光照)。
    • rgbGameplayLight:RGB_MAX(默认,使用最亮的 RGB 分量作为游戏性亮度;逐通道衰减影响诸如生物生成之类的光照检测)或 VANILLA(为游戏性光照检测单独计算非彩色光照)。
    • rgbBlendMode:包含一个可选的 MAXIMUM 模式,通过取每个通道的最亮值来组合方块光和天空光。在彩色光源周围,正午阳光保持中性。这控制正常渲染;光影包自行处理其着色。
    • debug.traceLightUpdates:用于光照队列、渲染请求和 Celeritas 重建的可选诊断工具。每 200 个客户端刻记录一次有界摘要;调用者和位置样本覆盖 1/64 的请求。
  • config/pulsar-colors.cfg:定义光源颜色。
  • config/pulsar-filters.cfg:定义每个 RGB 通道的衰减。

API

Pulsar 为其他模组提供了定义光源颜色和光线传输属性的 API。

  • ColoredLightSource / PositionalColoredLightSource:基于方块状态或位置定义 RGB 发光。
  • ColoredTranslucency / PositionalColoredTranslucency:定义逐通道的 RGB 透射率。
  • FaceLightOcclusion:定义单个方块面的光照不透明度。
  • BlockLightColors / BlockLightFilters:注册方块或方块状态的光源颜色和最小逐通道吸收值。
  • RegisterLightPropertiesEvent:用于注册光源颜色和过滤器的 Forge 事件。
  • PackedLightColor:打包和解压 0xRGB 值(组件范围为 0 到 15),并在 SuperNova 格式之间进行转换。
  • LightColors:提供基本颜色常量。
  • ExtendedChunk / ExtendedWorld:查询区块光照就绪状态和待处理的全球光照更新。

详见 API 文档 和 集成示例。

基准测试

于 2026-10-30 在 Minecraft 1.12.2 / Cleanroom 0.6.13-alpha 环境下测量,对比原版光照、Alfheim 1.6 以及 Pulsar 0.6.0 的 SCALAR 和 RGB (RGB_MAX) 模式。

图表测量的是从方块变化到光照完成(包括完成适配器)的专用服务器延迟。每个值是四次全新 JVM 运行均值的中间值;须线显示最小值和最大值。CPU 为 Ryzen AI MAX+ 395,Java 版本为 25,固定堆内存为 4 GiB。数值越低越好;坐标轴采用对数刻度。

方块光更新完成时间

天空光照更新完成时间

Vanilla 通过了开放天空区块光照测试,但在屋顶灯具的初始存储天空光照验证中失败,因此不计入 Vanilla 的天空更新耗时。RGB 计算额外的彩色光照信息。这些重复且逐个等待更新的步骤并不用于衡量 FPS、区块生成或并发更新吞吐量。

完整对比请参阅 测量值与运行范围 以及 原始测量结果。

兼容性探测及可选空段实验请参阅 光照验证说明。

致谢

  • Starlight: 光照引擎架构与核心算法的基础。
  • SuperNova: 移植的光照引擎、按世界任务管理以及压缩 RGB 传播代码的来源。
  • Alfheim: 多种光照修复方案的参考。
  • CleanroomModTemplate: Cleanroom 优秀的模组开发模板。
  • CleanroomVersioning: 用于版本管理的构建插件。
  • TokenEnvoy: 在构建时嵌入元数据的构建插件。

LLM 使用

LLM 被用于辅助编写 Pulsar 的部分代码与文档。

许可证

Pulsar 采用 LGPL-3.0 许可证授权。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源