3D Workspace

Workspace is a container service that holds objects that you want the Roblox engine to render in the 3D world. You typically will add these objects to the workspace:

  • BasePart objects, which includes both Part and MeshPart objects.
  • Attachment objects, which you can attach to special effect generators like a ParticleEmitter, UI objects like a BillboardGui, physical Constraints, and more.
  • Model objects that organize geometric groupings.
  • Script objects that are parented by other objects in the workspace. Scripts aren't rendered but can affect another object's rendering.

Parts

Part objects represent the primitive building blocks in Roblox. By default, all parts have their physics simulated and are rendered if they appear in the 3D workspace. Parts can take the shape of blocks, spheres, cylinders, wedges, or corner wedges. In addition, TrussPart acts as a truss beam that characters can climb like a ladder.

Block
Sphere
Cylinder
Wedge
Corner Wedge
A single gray block partA single gray sphere partA single gray cylinder partA single gray wedge partA single gray corner wedge part

You can also apply solid modeling operations to parts, such as union or negate, to combine them into something more complex like bowls or hollow pipes.

Meshes

A MeshPart is an object that represents a mesh (a collection of vertices, edges, and faces that make up a 3D object). You typically create meshes using third-party software such as Blender or Maya, then import them as a MeshPart using Studio.

Meshes can include far more detail than any solid modeling you can do in Studio. They can also have internal rigs and textures, allowing you to create lifelike objects that you can pose and animate.

A high-quality treasure chest mesh with a texture.
Mesh with texture
A realistic looking leafy bush with shadows and depth.
Mesh with SurfaceAppearance

Terrain

The Terrain object allows you to generate and sculpt detailed and realistic terrain environments, such as mountains, bodies of water, grass-covered hills, or a flat desert. Using the Terrain Editor, you can easily generate and alter large regions of terrain.

A viewport view of desert terrain with mountains in the distance.

Models

A Model is a container object for geometric groupings, such as BasePart, Motor6D objects, and other models. Models can be simple groupings or you can set a primary part within the model, so that it functions as an assembly, which the physics engine treats as a single rigid body. Models can also contain scripts that act on the individual objects of the model.

A humanoid model of a creepy girl with four red eyes standing in an A pose. She wears a maroon dress with webs and bright red stockings.
A model named Octavia
A close up view of the model's children in the Explorer window that comprise the model.
The groupings that comprise the model

Accessing the Workspace in Scripts

Within a script, you can access a place's Workspace in three different ways, all of which are valid.

  • workspace
  • game.Workspace
  • game:GetService("Workspace")

From there, you can carry out a large set of use cases to script logic for your experiences and create dynamic worlds and interactions. For example:

  • Obtain a reference to any object in the workspace to change its properties during runtime.
  • Obtain a reference to a user's Camera object to manipulate their view of the workspace.
  • Listen for events on objects in the workspace to carry out logic at specific times, such as when a user's playable character touches an object.