用途:在 Decentraland 场景中实现动态光照与环境氛围,包括点光、聚光、阴影、时间(昼夜)控制和自发光材质。
主要能力:LightSource 支持 Point 与 Spot 类型,参数包括 color、intensity(默认 16000 candela)、range、active、shadow 与 shadowMaskTexture(gobo)。阴影仅对聚光生效,且同时最多渲染约 3 个投射阴影的灯;灯光数量受玩家画质与距离影响,约 4 到 10 盏同时渲染,超出时只渲染离玩家最近的。range 为 -1 时按 intensity^0.25 自动计算,建议显式设置。
时间与环境:可在 scene.json 的顶层 skyboxConfig.fixedTime 或 worldConfiguration.skyboxConfig.fixedTime 设置固定时间;优先级为 worldConfiguration 高于顶层,运行时 RootEntity 上的 SkyboxTime 组件再覆盖两者,deleteFrom 可还原。时间值以秒计(0 午夜、43200 正午)。可用 getWorldTime 读取当前时间,getRealm 检测 realm 名称、networkId 与 baseUrl。自发光材质用 Material.setPbrMaterial 的 emissiveColor(Color3)与 emissiveIntensity,仅发光不照亮周围,常与 LightSource 搭配。
用法与限制:若存在 Creator Hub MCP 工具,应先用 search_catalog 查找灯光 Smart Item(Spotlight、Point Light),用 place_smart_item 放置,仅在无 MCP、需要隐形光源或非标准参数时才手动创建 LightSource。GLB 模型中的灯具网格不会发光,需附加 LightSource 组件。移动端自 v1.13.0 支持,但有场景上限(8 软/16 硬光源,2 软/4 硬阴影),且按画质档位仅激活最近的灯(Very Low 为 0),不应让玩法可见性依赖特定灯光,也不应以阴影作为唯一位置线索。SkyboxTime 必须挂在 engine.RootEntity 上。
资料未提供收费与价格信息。