Skip to content
Roblox API Reference

Workspace

Workspace houses 3D objects which are rendered to the 3D world. Objects not descending from it will not be rendered or physically interact with the world.
  • Not creatable
  • Service
Memory category
BaseParts
Own members
89
Inherited members
160
Subclasses
0
Siblings
2

Properties115

Inherited fromObject2

Property categoryData

Inherited fromInstance21

Property categoryBehavior

Property categoryData

Property categoryPermissions

Inherited fromPVInstance2

Property categoryPivot

  • Editor-only property that displays and edits the pivot's CFrame relative to the instance, moving only the pivot and leaving the instance in place.
    • Not replicated
    • Not scriptable

Property categoryTransform

  • Editor-only property that reads and sets the world CFrame of the PVInstance's pivot, moving the entire instance when changed from the Studio Properties window.
    • Not replicated
    • Not scriptable
Inherited fromModel14

Property categoryAppearance

Property categoryBehavior

Property categoryData

Property categoryPivot

Inherited fromWorldRoot7

Property categoryAirProperties

Property categoryBehavior

Property categoryData

Defined byWorkspace69

Property categoryAirProperties

  • Workspace.AirDensity: number
    The air density at ground level, used in the aerodynamic force model.
    • Capabilities: Environment + Physics
    • Simulation access
  • Workspace.AirTurbulenceIntensity: number
    Controls the strength of turbulence present in the wind velocity field, affecting the aerodynamic force model.
    • Capabilities: Environment + Physics
    • Simulation access
  • Workspace.GlobalWind: Vector3
    Specifies the global wind vector for animated terrain grass, dynamic clouds, and particles.
    • Read capabilities: Basic
    • Write capabilities: Basic + Physics
    • Simulation access

Property categoryBehavior

  • Workspace.AllowThirdPartySales: boolean
    Determines whether assets created by other users can be sold in the game.
    • Not replicated
    • Capabilities: Monetization
  • Workspace.AvatarUnificationMode: Enum.AvatarUnificationMode
    Enables the R6 to R15 adapter, allowing R15 avatars to join R6 experiences.
    • Not scriptable
  • Workspace.ClientAnimatorThrottling: Enum.ClientAnimatorThrottlingMode
    Specifies the animation throttling mode for the local client.
    • Capabilities: Animation
  • Workspace.CollisionGroups: string
    • Hidden
    • Not replicated
    • Not scriptable
    • Write only
    • Load only
  • Workspace.DataModelPlaceVersion: number
    • Hidden
    • Not scriptable
  • Workspace.ExpandedTerrain: Enum.RolloutState
    • Not scriptable
  • Workspace.ExplicitAutoJoints: boolean
    • Hidden
    • Not scriptable
  • Workspace.FallenPartsDestroyHeight: number
    Determines the height at which falling BaseParts and their ancestor Models are removed from Workspace.
    • Read capabilities: Basic
    • Write capabilities: PluginOrOpenCloud
  • Workspace.FallHeightEnabled: boolean
    Controls whether parts that fall below Workspace.FallenPartsDestroyHeight are automatically destroyed.
    • Read capabilities: Basic
    • Write capabilities: PluginOrOpenCloud
  • Workspace.FluidForces: Enum.FluidForces
    Determines whether the physics engine computes aerodynamic forces on BaseParts whose EnableFluidForces property is true.
    • Not scriptable
  • Workspace.Gravity: number
    Determines the acceleration due to gravity applied to falling BaseParts.
    • Read capabilities: Basic
    • Write capabilities: Basic + Physics
    • Simulation access
  • Workspace.IKControlConstraintSupport: Enum.IKControlConstraintSupport
    Enables support for constraints for IKControls. If disabled, IKControls ignore physics constraints.
    • Not scriptable
  • Workspace.ImprovedAnimationConstraint: Enum.RolloutState
    Controls whether improved behavior is enabled for AnimationConstraints.
    • Not scriptable
  • Workspace.ImprovedPhysicsReplication: Enum.RolloutState
    Controls whether the experience uses the improved physics replication path between the server and clients.
    • Not scriptable
  • Workspace.LayeredClothingCacheOptimizations: Enum.RolloutState
    Controls whether layered clothing cache optimizations are enabled.
    • Not scriptable
    • Capabilities: AvatarAppearance
  • Workspace.MapTVRemoteToGamepadKeycodes: Enum.RolloutState
    • Not scriptable
  • Workspace.MeshPartHeadsAndAccessories: Enum.MeshPartHeadsAndAccessories
    Sets whether character Heads and Accessories should be downloaded as MeshParts.
    • Not scriptable
  • Workspace.MeshStreamingAndImprovedLods: Enum.RolloutState
    Controls whether the experience uses the new mesh streaming and improved LOD system.
    • Not scriptable
  • Workspace.NextGenerationReplication: Enum.RolloutState
    When true, enables an alternate replication system that alters and improves how properties are replicated under the hood.
    • Not scriptable
  • Workspace.PathfindingUseImprovedSearch: Enum.PathfindingUseImprovedSearch
    Controls whether an improved search algorithm is used by PathfindingService.
    • Not scriptable
  • Workspace.PhysicsSteppingMethod: Enum.PhysicsSteppingMethod
    Sets how the solver will advance the physics simulation forward in time.
    • Not scriptable
  • Workspace.PlayerCharacterDestroyBehavior: Enum.PlayerCharacterDestroyBehavior
    Controls whether the engine automatically calls Destroy() on a player's character when it is replaced and on the Player object when the player leaves.
    • Not scriptable
  • Workspace.PlayerScriptsUseInputActionSystem: Enum.RolloutState
    Controls whether the built-in player scripts are updated to use the Input Action System.
    • Roblox script security
  • Workspace.PrimalPhysicsSolver: Enum.PrimalPhysicsSolver
    Controls whether the experimental Primal Physics Solver is enabled.
    • Not scriptable
  • Workspace.RenderingCacheOptimizations: Enum.RenderingCacheOptimizationMode
    Controls whether rendering cache optimizations are enabled.
    • Not scriptable
    • Capabilities: Physics
  • Workspace.ReplicateInstanceDestroySetting: Enum.ReplicateInstanceDestroySetting
    Controls how Instance:Destroy() calls are replicated from the server to clients.
    • Not scriptable
  • Workspace.ReplicationFrequency: Enum.ReplicationMode
    • Capabilities: PluginOrOpenCloud
  • Workspace.ReplicationThroughput: Enum.ReplicationMode
    • Capabilities: PluginOrOpenCloud
  • Workspace.Retargeting: Enum.AnimatorRetargetingMode
    Controls whether animation retargeting is enabled for character animations.
    • Capabilities: Animation
  • Workspace.SignalBehavior: Enum.SignalBehavior
    Configures when the engine resumes event handlers.
    • Not scriptable
  • Workspace.SignalBehavior2: Enum.SignalBehavior
    • Hidden
    • Not replicated
    • Not scriptable
  • Workspace.Terrain: Terrain
    A reference to the Terrain object parented to the Workspace.
    • Read only
  • Workspace.TerrainWeldsFixed: boolean
    • Hidden
    • Not scriptable
  • Workspace.ThrottleLevel: number
    • Hidden
    • Not scriptable
    • Roblox engine security
  • Workspace.TouchesUseCollisionGroups: boolean
    Determines whether parts in different groups set to not collide will ignore collisions and touch events.
    • Not scriptable
  • Workspace.TouchEventsUseCollisionGroups: Enum.RolloutState
    • Not scriptable
  • Workspace.UseFixedSimulation: Enum.RolloutState
    When true, enables RunService:BindToSimulation() which calls a function at a fixed frequency, updates physics stepping logic, and makes the time() function return the fixed stepped frame time.
    • Not scriptable
  • Workspace.UseInputSink: Enum.RolloutState
    • Not scriptable
  • Workspace.ValidateEnabledProximityPrompt: Enum.RolloutState
    • Not scriptable
    • Capabilities: Basic
  • Workspace.WatermarkHash: string
    • Hidden
    • Not scriptable
    • Roblox engine security
  • Workspace.FilteringEnabled: boolean
    Deprecated: This property is discontinued.
    Determines whether changes made from the client will replicate to the server or not.
    • Deprecated
    • Hidden
    • Not replicated
    • Write: Plugin security
    • Read capabilities: Basic
  • Workspace.InterpolationThrottling: Enum.InterpolationThrottlingMode
    Deprecated: This property should not be used for new work.
    Deprecated setting that configured the interpolation throttling mode; it no longer takes effect.
    • Deprecated
    • Hidden
    • Not replicated
    • Write: Plugin security
    • Read capabilities: Physics

Property categoryData

  • Workspace.CurrentCamera: Camera
    The Camera object being used by the local player.
    • Not replicated
    • Read capabilities: Basic
    • Write capabilities: Basic + Input
  • Workspace.DistributedGameTime: number
    The amount of time, in seconds, that the game has been running.
    • Not replicated
    • Capabilities: Basic
  • Workspace.InsertPoint: Vector3
    The world position at which new objects are placed when inserted from the toolbox.
    • Not replicated
  • Workspace.StreamingEnabledStorage: boolean
    • Hidden
    • Not replicated
    • Not scriptable
    • Roblox engine security

Property categoryNetworking

  • Workspace.RejectCharacterDeletions: Enum.RejectCharacterDeletions
    Controls whether the server rejects attempts by clients to delete player characters from the workspace.
    • Not scriptable

Property categoryPermissions

  • Workspace.SandboxedInstanceMode: Enum.SandboxedInstanceMode
    Controls whether sandboxed instance mode (script capabilities) is enabled.
    • Not scriptable

Property categoryScripting

  • Workspace.LuauTypeCheckMode: Enum.LuauTypeCheckMode
    Sets the Luau type checking mode for scripts in the experience.
    • Capabilities: PluginOrOpenCloud
  • Workspace.UseNewLuauTypeSolver: Enum.RolloutState
    Controls whether the new Luau type solver is used for type inference.
    • Not scriptable

Property categoryServer Authority

  • Workspace.AuthorityMode: Enum.AuthorityMode
    Sets the server authority mode.
    • Roblox script security
  • Workspace.NextGenerationReplicationAlias: Enum.RolloutState
    • Not replicated
    • Not scriptable
    • Roblox engine security
  • Workspace.PlayerScriptsUseInputActionSystemAlias: Enum.RolloutState
    • Not replicated
    • Not scriptable
    • Roblox engine security
  • Workspace.SignalBehaviorAlias: Enum.SignalBehavior
    • Not replicated
    • Not scriptable
    • Roblox engine security
  • Workspace.StreamingEnabledAlias: boolean
    • Not replicated
    • Not scriptable
    • Roblox engine security
  • Workspace.UseFixedSimulationAlias: Enum.RolloutState
    • Not replicated
    • Not scriptable
    • Roblox engine security

Property categoryStreaming

  • Workspace.EnableSLIMAvatars: Enum.RolloutState
    Controls whether SLIM rendering is used for avatars in the experience.
    • Not scriptable
    • Capabilities: Players
  • Workspace.ModelStreamingBehavior: Enum.ModelStreamingBehavior
    Controls how Models are replicated in experiences when instance streaming is enabled.
    • Not scriptable
  • Workspace.PredictiveStreamingMode: Enum.PredictiveStreamingMode
    Controls whether the engine can make predictive streaming decisions.
    • Not scriptable
  • Workspace.StreamingAdaptiveRadius: boolean
    • Capabilities: PluginOrOpenCloud
  • Workspace.StreamingEnabled: boolean
    Whether content streaming is enabled for the place.
    • Write capabilities: PluginOrOpenCloud
  • Workspace.StreamingIntegrityMode: Enum.StreamingIntegrityMode
    Determines whether streaming integrity mode is active.
    • Not scriptable
  • Workspace.StreamingMinRadius: number
    Minimum distance that content will be streamed to players with high priority.
    • Not scriptable
  • Workspace.StreamingPauseMode: Enum.StreamingPauseMode
    • Hidden
    • Not replicated
    • Not scriptable
    • Load only
  • Workspace.StreamingTargetRadius: number
    Maximum distance that content will be streamed to players.
    • Not scriptable
  • Workspace.StreamOutBehavior: Enum.StreamOutBehavior
    Configures how the engine decides when to stream content away from players.
    • Not scriptable

Methods121

Inherited fromObject3
  • Get an event that fires when a given property of the object changes.
    Parameters
    ParameterDescription
    property: string
    The property to connect to.
    Returns
    TypeDescription
    RBXScriptSignal
    A signal that fires whenever the property changes.
  • Object:IsA(className: string): boolean
    Returns true if an object's class matches or inherits from a given class.
    • Custom Lua state
    • Thread safe
    Parameters
    ParameterDescription
    className: string
    The class against which the Object's class will be checked. Case-sensitive.
    Returns
    TypeDescription
    boolean
    Describes whether the Object's class matched or is a subclass of the given class.
  • Object:isA(className: string): boolean
    Deprecated: This deprecated function is a variant of Object:IsA() which should be used instead.
    • Deprecated
    • Custom Lua state
    Parameters
    Parameter
    className: string
    Returns
    Type
    boolean

    Use IsA instead.

Inherited fromInstance39
Inherited fromPVInstance2
Inherited fromModel21
Inherited fromWorldRoot38
Defined byWorkspace18
  • Workspace:ApplyRecommendedStreamingSettings(): boolean
    Applies Roblox's recommended instance streaming settings to the Workspace.
    • Plugin security
    Returns
    TypeDescription
    boolean
    true if one or more streaming properties were changed; false if every value already matched its recommended setting.
  • Workspace:CalculateJumpDistance(gravity: number,jumpPower: number,walkSpeed: number,): number
    • Roblox script security
    Parameters
    Parameter
    gravity: number
    jumpPower: number
    walkSpeed: number
    Returns
    Type
    number
  • Workspace:CalculateJumpHeight(gravity: number, jumpPower: number): number
    • Roblox script security
    Parameters
    Parameter
    gravity: number
    jumpPower: number
    Returns
    Type
    number
  • Workspace:CalculateJumpPower(gravity: number, jumpHeight: number): number
    • Roblox script security
    Parameters
    Parameter
    gravity: number
    jumpHeight: number
    Returns
    Type
    number
  • Workspace:ExperimentalSolverIsEnabled(): boolean
    • Local user security
    Returns
    Type
    boolean
  • Workspace:GetNumAwakeParts(): number
    Returns the number of BaseParts that are deemed physically active, due to being recently under the influence of physics.
    • Thread safe
    • Capabilities: Basic
    Returns
    TypeDescription
    number
    The number of awake parts.
  • Workspace:GetPhysicsThrottling(): number
    Returns an integer, between 0 and 100, representing the percentage of real time that physics simulation is currently being throttled to.
    • Thread safe
    • Capabilities: Basic
    Returns
    TypeDescription
    number
    The percentage of real time that physics simulation is currently being throttled to.
  • Workspace:GetRealPhysicsFPS(): number
    Returns the number of frames per second that physics is currently being simulated at.
    • Thread safe
    • Capabilities: Basic
    Returns
    TypeDescription
    number
    Returns the number of frames per second that physics is currently being simulated at.
  • Workspace:GetServerTimeNow(): number
    Returns the server's Unix time in seconds.
    • Thread safe
    • Capabilities: Basic
    Returns
    TypeDescription
    number
    The estimated Unix timestamp on the server.
  • Workspace:JoinToOutsiders(objects: { Instance },jointType: Enum.JointCreationMode,)
    Creates joints between the specified Parts and any touching parts depending on the parts' surfaces and the specified joint creation mode.
    • Capabilities: Physics
    Parameters
    ParameterDescription
    objects: { Instance }
    An array of BaseParts for whom joints are to be made.
    jointType: Enum.JointCreationMode
    The JointCreationMode to be used. Passing in Enum.JointCreationMode.All or Enum.JointCreationMode.Surface has the same behavior which equates to Join Always.
  • Workspace:PGSIsEnabled(): boolean
    Returns true if the game has the PGS Physics solver enabled.
    • Capabilities: Basic
    Returns
    TypeDescription
    boolean
    True if the PGS solver is enabled.
  • Workspace:SetAvatarUnificationMode(value: Enum.AvatarUnificationMode)
    • Roblox script security
    Parameters
    Parameter
    value: Enum.AvatarUnificationMode
  • Workspace:SetMeshPartHeadsAndAccessories(value: Enum.MeshPartHeadsAndAccessories)
    • Roblox script security
    Parameters
    Parameter
    value: Enum.MeshPartHeadsAndAccessories
  • Workspace:SetPhysicsThrottleEnabled(value: boolean)
    • Local user security
    Parameters
    Parameter
    value: boolean
  • Workspace:UnjoinFromOutsiders(objects: { Instance })
    Breaks all joints between the specified BaseParts and other BaseParts.
    • Capabilities: Physics
    Parameters
    ParameterDescription
    objects: { Instance }
    An array of BaseParts for whom joints are to be broken.
  • Workspace:ZoomToExtents()
    Positions and zooms the Workspace.CurrentCamera to show the extent of BaseParts currently in the Workspace.
    • Plugin security
  • Workspace:BreakJoints(objects: { Instance })
    Deprecated: This method is deprecated. Do not use it for new work.
    Goes through all BaseParts given, breaking any joints connected to these parts.
    • Deprecated
    • Plugin security
    Parameters
    ParameterDescription
    objects: { Instance }
    An array of BaseParts for whom joints are to be broken.
  • Workspace:MakeJoints(objects: { Instance })
    Deprecated: This method is deprecated. Do not use it for new work.
    Goes through all BaseParts given. If any part's side has a SurfaceType that can make a joint it will create a joint with any adjacent parts.
    • Deprecated
    • Plugin security
    Parameters
    ParameterDescription
    objects: { Instance }
    An array of parts for whom joints are to be made.

Events13

Inherited fromObject1
Inherited fromInstance9
Inherited fromWorldRoot1
Defined byWorkspace2
  • Workspace.PersistentLoaded: RBXScriptSignal<(player: Player)>
    Fires when persistent models have been sent to the specified player.
    Parameters
    Parameter
    player: Player
  • Workspace.SendServerTime: RBXScriptSignal<(serverTimeMs: number)>
    • Hidden
    • Roblox engine security
    Parameters
    Parameter
    serverTimeMs: number