Terrain Editor | Documentation - Roblox Creator Hub (2024)

The Terrain Editor, accessible from the Home or View tab, lets you generate and manipulate environmental terrain through its Create and Edit toolsets.

Create Tab

The Create tab includes the Generate, Import, and Clear tools.

Generate

The Generate tool procedurally generates terrain within a region selected by the Select tool. This is useful if you want to create a large map and then fine-tune terrain details using the Edit tab tools.

Import

The Import tool imports a heightmap and optional colormap and applies them to a region selected by the Select tool.

See Also

Generative AI on Roblox: Our Vision for the Future of Creation - Roblox BlogHow to Use Scripts in Roblox - The Blox ScriptsData Stores | Documentation - Roblox Creator HubDeveloper Products | Documentation - Roblox Creator Hub

Clear

The Clear tool opens a confirmation prompt to clear all terrain within the entire place.

Edit Tab

The Edit tab includes the Select, Transform, Fill, Draw, Sculpt, Smooth, Flatten, Paint, and SeaLevel tools.

Select

The Select tool is the universal tool for selecting rectangular regions of terrain. With the tool enabled, select a region by clicking and dragging in the 3D viewport, reposition it with the move draggers, and edit its size with the scale handles. Alternatively, enter values into the tool's X/Y/Z inputs to set a specific position and size.

Studio also supports the following keyboard and mouse shortcuts, assuming the Select tool is active and nothing is selected in the Explorer hierarchy.

Transform

The Transform tool manipulates entire selected regions to a new position, size, or orientation. With the tool enabled, transform a selected region with the move draggers, rotate rings, and scale handles. Alternatively, enter values into the tool's X/Y/Z inputs to set a specific position, size, and rotation.

Fill

The Fill tool fills an entire selected region with a specific material, or replaces all material within the region with another material.

Draw

The Draw tool adds or subtracts terrain using the brush. This tool functions in a dual mode where holding down Ctrl or ⌘ toggles on "subtract" mode instead of the default "add" mode. Additionally, holding down Shift temporarily activates the Smooth tool.

Option	Description
BrushMode	Toggles the tool between Add and Subtract mode. Also toggled by holding down Ctrl or ⌘.
Shape	Sets the brush shape to either a sphere, box, or cylinder.
Base Size	Sets the brush size from 1 to 64. If you choose a brush shape of box or cylinder, a Height slider/input also appears to adjust the brush height proportionally or independently of the base size.
PivotPosition	Sets the vertical pivot point of the brush to either the bottom, center, or top of where the brush connects with existing terrain.
Plane Lock	Toggles whether to enable a visual plane which the brush locks to. In Auto mode, the plane tilts and rotates with the camera. In Manual mode, the EditPlane option appears, letting you set a specific position/orientation through the visual draggers or X/Y/Z inputs.
Snap to Voxels	Snaps the brush to the nearest voxel.
Ignore Water	Ignores water when adding or subtracting terrain.
Ignore Parts	Ignores parts in regards to brush placement while moving the mouse pointer across part surfaces.
Auto Material	Uses the same terrain material in the brush's vicinity when adding new terrain.
Material	Sets the material for Add mode.

Sculpt

The Sculpt tool adds or subtracts terrain using the brush. Unlike the Draw tool, this tool includes a strength slider/input to allow for more gentle manipulation of terrain. This tool functions in a dual mode where holding down Ctrl or ⌘ toggles on "subtract" mode instead of the default "add" mode, and holding down Shift temporarily activates the Smooth tool.

Option	Description
BrushMode	Toggles the tool between Add and Subtract mode. Also toggled by holding down Ctrl or ⌘.
Shape	Sets the brush shape to either a sphere, box, or cylinder.
Base Size	Sets the brush size from 1 to 64. If you choose a brush shape of box or cylinder, a Height slider/input also appears to adjust the brush height proportionally or independently of the base size.
Strength	Sets the brush strength from 0.1 to 1.
PivotPosition	Sets the vertical pivot point of the brush to either the bottom, center, or top of where the brush connects with existing terrain.
Plane Lock	Toggles whether to enable a visual plane which the brush locks to. In Auto mode, the plane tilts and rotates with the camera. In Manual mode, the EditPlane option appears, letting you set a specific position/orientation through the visual draggers or X/Y/Z inputs.
Snap to Voxels	Snaps the brush to the nearest voxel.
Ignore Water	Ignores water when adding or subtracting terrain.
Ignore Parts	Ignores parts in regards to brush placement while moving the mouse pointer across part surfaces.
Auto Material	Uses the same terrain material in the brush's vicinity when adding new terrain.
Material	Sets the material for Add mode.

Smooth

The Smooth tool smoothes out abrupt edges in terrain using the brush. This tool can be used in standalone mode, or you can toggle it on by holding Shift while using the Draw or Sculpt tools.

Option	Description
Shape	Sets the brush shape to either a sphere, box, or cylinder.
Base Size	Sets the brush size from 1 to 64. If you choose a brush shape of box or cylinder, a Height slider/input also appears to adjust the brush height proportionally or independently of the base size.
Strength	Sets the brush strength from 0.1 to 1.
PivotPosition	Sets the vertical pivot point of the brush to either the bottom, center, or top of where the brush connects with existing terrain.
Plane Lock	Toggles whether to enable a visual plane which the brush locks to. In Auto mode, the plane tilts and rotates with the camera. In Manual mode, the EditPlane option appears, letting you set a specific position/orientation through the visual draggers or X/Y/Z inputs.
Snap to Voxels	Snaps the brush to the nearest voxel.
Ignore Water	Ignores water when smoothing terrain.
Ignore Parts	Ignores parts in regards to brush placement while moving the mouse pointer across part surfaces.

Flatten

The Flatten tool flattens terrain to a consistent level across a visualized plane. By default, the tool lowers terrain above the plane and raises terrain below to the plane, but you can opt to selectively lower or raise through the tool's FlattenMode option.

Option	Description
Shape	Sets the brush shape to either a sphere, box, or cylinder.
Base Size	Sets the brush size from 1 to 64. If you choose a brush shape of box or cylinder, a Height slider/input also appears to adjust the brush height proportionally or independently of the base size.
Strength	Sets the brush strength from 0.1 to 1.
Flatten Mode	Erode to Flat¹ flattens terrain above the plane. GrowtoFlat² fills in terrain below the plane. FlattenAll³ removes terrain above the plane and fills in terrain below the plane.
PivotPosition	Sets the vertical pivot point of the brush to either the bottom, center, or top of where the brush connects with existing terrain.
Fixed Plane	Toggles a fixed visual plane in Y world space upon which to flatten terrain.
Snap to Voxels	Snaps the brush to the nearest voxel.
Ignore Water	Ignores water when flattening terrain.
Ignore Parts	Ignores parts in regards to brush placement while moving the mouse pointer across part surfaces.

Paint

The Paint tool, using the brush, paints a terrain material over an existing material or replaces one material with another material.

Option	Description
Shape	Sets the brush shape to either a sphere, box, or cylinder.
Base Size	Sets the brush size from 1 to 64. If you choose a brush shape of box or cylinder, a Height slider/input also appears to adjust the brush height proportionally or independently of the base size.
PivotPosition	Sets the vertical pivot point of the brush to either the bottom, center, or top of where the brush connects with existing terrain.
Plane Lock	Toggles whether to enable a visual plane which the brush locks to. In Auto mode, the plane tilts and rotates with the camera. In Manual mode, the EditPlane option appears, letting you set a specific position/orientation through the visual draggers or X/Y/Z inputs.
Snap to Voxels	Snaps the brush to the nearest voxel.
Ignore Water	Ignores water when flattening terrain.
Ignore Parts	Ignores parts in regards to brush placement while moving the mouse pointer across part surfaces.
MaterialMode	Toggles the tool between Paint and Replace mode. In Paint mode, choose the desired painting material from the tool's picker tiles. In Replace mode, choose both the source material to replace and the target material to replace it with.

Sea Level

The Sea Level tool lets you create a consistent water level or remove all water within a region.

Studio Shortcuts

For tools which use the brush (Draw, Sculpt, Smooth, Flatten, Paint), Studio supports the following keyboard and mouse shortcuts.