2 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

ModelStreamingMode

Controls how model is streamed in and out when used in an experience that is streaming enabled. Has no effect when experience is not streaming enabled.

Items

NameValueDescription
Default0Default behavior (subject to change).
Atomic1The Model and all of its descendants are streamed in/out together. For streaming in, this applies when any descendant BasePart is eligible for streaming in. For streaming out, this applies when all descendant BaseParts are eligible for streaming out.
Persistent2Persistent models are sent as a complete atomic unit soon after the player joins and before the Workspace.PersistentLoaded event fires. Persistent models and their descendants are never streamed out.
PersistentPerPlayer3Behaves as a persistent model for players that have been added using Model:AddPersistentPlayer(). For other players, behavior is the same as Atomic. You can revert a model from player persistence via Model:RemovePersistentPlayer().
Nonatomic4When a nonatomic model is streamed, descendants are also sent, except for part descendants. Nonatomic models that are not descendants of parts are sent during experience loading.

Default

Default behavior (subject to change).

FieldValue
value0

Atomic

The Model and all of its descendants are streamed in/out together. For streaming in, this applies when any descendant BasePart is eligible for streaming in. For streaming out, this applies when all descendant BaseParts are eligible for streaming out.

FieldValue
value1

Persistent

Persistent models are sent as a complete atomic unit soon after the player joins and before the Workspace.PersistentLoaded event fires. Persistent models and their descendants are never streamed out.

FieldValue
value2

PersistentPerPlayer

Behaves as a persistent model for players that have been added using Model:AddPersistentPlayer(). For other players, behavior is the same as Atomic. You can revert a model from player persistence via Model:RemovePersistentPlayer().

FieldValue
value3

Nonatomic

When a nonatomic model is streamed, descendants are also sent, except for part descendants. Nonatomic models that are not descendants of parts are sent during experience loading.

FieldValue
value4