Used to determine how a surface should be displayed on a part and how
automatic surface joints should behave.

## Surface behavior

When surface joining is on, all planar touching flat sides of parts will weld
together, regardless of SurfaceType. This does not affect Hinge, Motor,
SteppingMotor.

- Glue, Studs, Inlets, Universal, Weld, and Smooth surfaces will all create
  Weld instances
- Spheres will not surface-weld to anything. The rounded sides of cylinders
  will not surface-weld, but the flat end sides will.

## Surface appearance

Stud, Inlet, Universal, Weld, and Glue Surface textures only appear on plastic
material parts, both in-game and in Studio.

See also:

- `Class.Workspace:JoinToOutsiders()`, creates joints between the specified
  parts and any touching parts depending on the parts' surfaces and the
  specified joint creation mode
- `Enum.JointCreationMode`, the way joints are created between two surfaces


Smooth

Makes the side appear without any surface detail (except for _outlines_).


Glue

Makes the side appear with thick diagonal "X"s.


Weld

Studs

Makes the side appear with square studs.


Inlet

Makes the side appear with holes where studs would be.


Universal

Makes the side appear with both Studs and Inlets in a checker pattern.


Hinge

Makes the side appear with a yellow hinge. Any part connected to this
hinge will stick to the side and rotate using physics, however, using
`Class.HingeConstraint` to join parts is preferred.


Motor

Acts the same as a Hinge, but has a grey ring around it and automatically
rotates any part connected to it, however, using `Class.HingeConstraint`
to join parts is preferred.


SteppingMotor

Functions identically to a motor. It may have functioned differently in
the past, but that functionality no longer seems to exist.


SmoothNoOutlines

Same as Smooth, but removes the _outlines_ of the surface.


SurfaceType

Used to determine how a surface should be displayed on a part and how
automatic surface joints should behave.


Default Value: {defaultValueStart}{defaultValueEnd}

This function returns immediately if possible, but can yield the thread that called it until it can return a value.

This member doesn’t appear in the object browser and is not intended for widespread use.

This member is only accessible only through the command bar. Attempting to access this member from scripts causes an error.

This function can’t pause the Lua thread that called it.

Attempting to access this member in scripts causes an error. You might be able to access this member from Roblox Studio's property window.

This member doesn’t appear in Roblox Studio’s Object Browser.

You can’t create an instance of this class with the Instance.new constructor.

Roblox does not replicate this member across its server-client boundary.

Lua code can’t access this member. You might be able to change its value from the property window in Roblox Studio.

This object’s replication behavior is dependent on the player who owns it.

This member is accessible only through the command bar and plugins only. Attempting to access this member from scripts causes an error.

This property is read-only and is safe to read in unsynchronized threads. Attempting to write to it causes an error.

This member is read only. Attempting to write to this member causes an error.

This member is accessible only in CoreScripts.

Only Roblox CoreScripts can access this member, and it isn’t usable by Players.

You can read and write to this property safely from multiple threads.

This class is a top-level singleton. Retrieve an instance of this class with the GetService function.

Multiple threads can potentially write to this property, so it’s unsafe to read from unsynchronized threads.

This function pauses the Lua thread that called it until it returns a result. This doesn’t interrupt other scripts.

{pageTitle} | {SiteName}

We’re making things more awesome. Thanks for your patience.

By clicking "Continue", you will be directed to {redirectLinkStart}{redirectLinkEnd}

This site is not owned or operated by Roblox. They may have different terms and privacy policies.

SurfaceType

Items