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.

EnviromentalPhysicsThrottle

The EnviromentalPhysicsThrottle enum is used with PhysicsSettings.PhysicsEnvironmentalThrottle, controlling how aggressively the engine skips physics simulation steps to reduce CPU load.

Items

NameValueDescription
DefaultAuto0Automatically adjusts throttle level based on performance.
Disabled1No throttling; every physics step runs.
Always2Maximum throttling; physics is effectively frozen.
Skip23Runs 1 out of every 2 steps (50% reduction). If Workspace.PhysicsSteppingMethod is set to Adaptive, skipping is based on groups of 4 steps instead of individual steps.
Skip44Runs 1 out of every 4 steps (75% reduction). If Workspace.PhysicsSteppingMethod is set to Adaptive, skipping is based on groups of 4 steps instead of individual steps.
Skip85Runs 1 out of every 8 steps (87.5% reduction). If Workspace.PhysicsSteppingMethod is set to Adaptive, skipping is based on groups of 4 steps instead of individual steps.
Skip166Runs 1 out of every 16 steps (93.75% reduction). If Workspace.PhysicsSteppingMethod is set to Adaptive, skipping is based on groups of 4 steps instead of individual steps.

DefaultAuto

Automatically adjusts throttle level based on performance.

FieldValue
value0

Disabled

No throttling; every physics step runs.

FieldValue
value1

Always

Maximum throttling; physics is effectively frozen.

FieldValue
value2

Skip2

Runs 1 out of every 2 steps (50% reduction). If Workspace.PhysicsSteppingMethod is set to Adaptive, skipping is based on groups of 4 steps instead of individual steps.

FieldValue
value3

Skip4

Runs 1 out of every 4 steps (75% reduction). If Workspace.PhysicsSteppingMethod is set to Adaptive, skipping is based on groups of 4 steps instead of individual steps.

FieldValue
value4

Skip8

Runs 1 out of every 8 steps (87.5% reduction). If Workspace.PhysicsSteppingMethod is set to Adaptive, skipping is based on groups of 4 steps instead of individual steps.

FieldValue
value5

Skip16

Runs 1 out of every 16 steps (93.75% reduction). If Workspace.PhysicsSteppingMethod is set to Adaptive, skipping is based on groups of 4 steps instead of individual steps.

FieldValue
value6