Stars

概览

字段	值
Kind	Unit · 单位 Unit
Realm	common

继承关系

• Unit（4 属性 / 25 函数 / 6 事件）
  • [Stars]（6 属性）

继承成员

1 个来源 / 4 属性 / 25 函数 / 6 事件

• 来自 Unit（4 属性 / 25 函数 / 6 事件）
  • 属性：AssetId、Name、Desc、Parent
  • 函数：ClearAllChildren、GetChildren、GetDescendants、IsAncestorOf、IsDescendantOf、FindFirstAncestor、FindFirstAncestorWhichIsA、FindFirstAncestorOfClass、FindFirstChild、FindFirstChildWhichIsA、FindFirstChildOfClass、HasChildren、GetChildCount、GetChildAtIndex、SetAttribute、GetAttribute、GetAllProps、Clone、IsA、Destroy、GetPropertyChangedSignal、GetAttributeChangedSignal、FindFromPath、GetFullPath、GetDebugId
  • 事件：ChildAdded、ChildRemoved、DescendantAdded、DescendantRemoving、AncestryChanged、Destroying

Stars 是用于呈现天空星点的单位。将其挂载到 LightingService 后，可通过 Color、Brightness、Density、TwinkleSpeed、Coverage 和 AffectedByFog 控制星空颜色、亮度、密度、闪烁、覆盖范围与雾效影响。

适用场景

当需要为夜间、太空或幻想主题场景铺出一片星空时，创建 Stars 实例并挂到 LightingService 下即可让星点生效；调试阶段也可以逐项调整密度与闪烁速度，观察不同星空观感。

使用要点

使用 game:CreateUnit("Stars", { Parent = game:GetService("LightingService") }) 创建并挂载实例；随后可直接读写 Color、Brightness、Density、Coverage、TwinkleSpeed、AffectedByFog 等属性。不再需要时调用 Destroy() 释放实例。

注意事项

Stars 是 Unit，只能通过 game:CreateUnit 或 World:CreateUnit 创建，不能直接构造；要产生天空效果，实例必须挂到 LightingService。Color 必须传入 Color 值，销毁时调用继承自 Unit 的 Destroy()，不要只清空 Parent 后丢弃引用。

代码示例

创建并挂载星空

-- @runtime client
local lighting = game:GetService("LightingService")
local stars = game:CreateUnit("Stars", {
    Parent = lighting,
    Brightness = 1.0,
    Density = 1.0,
})
print("星空已挂载到光照节点:", stars.Parent == lighting)

属性 (6)

Name	类型	默认值	说明
Color	Color	Color.New(255, 255, 255, 255)	颜色属性，类型为 Color，用于表示星星的颜色，默认值为 16777215。
Brightness	Float	1.0	亮度属性，类型为 Float，用于表示星星的亮度，默认值为 1.0。
Density	Float	1.0	密度属性，类型为 Float，用于表示星星的密集程度，默认值为 1.0。
TwinkleSpeed	Float	1.0	闪烁速度属性，类型为 Float，用于表示星星的闪烁快慢，默认值为 1.0。
Coverage	Float	5.0	覆盖率属性，类型为 Float，用于表示星星在天空中的覆盖范围，默认值为 5.0。
AffectedByFog	Bool	false	受雾影响属性，类型为 Bool，用于控制星星的显示是否受场景雾效影响，默认值为 false。

关联类型

• Unit
• Color