Terrain | Documentación del Centro de creación de Roblox

local terrainRegion = workspace.Terrain:CopyRegion(workspace.Terrain.MaxExtents)
workspace.Terrain:Clear()

task.wait(5)

workspace.Terrain:PasteRegion(terrainRegion, workspace.Terrain.MaxExtents.Min, true)

CountCells

Capacidades: Environment

Terrain:CountCells():number

Devuelve

number

FillBall

Capacidades: Environment

Terrain:FillBall(

center:Vector3, radius:number, material:Enum.Material

):()

Parámetros

center:Vector3

radius:number

material:Enum.Material

Devuelve

()

FillBlock

Capacidades: Environment

Terrain:FillBlock(

cframe:CFrame, size:Vector3, material:Enum.Material

):()

Parámetros

cframe:CFrame

size:Vector3

material:Enum.Material

Devuelve

()

FillCylinder

Capacidades: Environment

Terrain:FillCylinder(

cframe:CFrame, height:number, radius:number, material:Enum.Material

):()

Parámetros

cframe:CFrame

height:number

radius:number

material:Enum.Material

Devuelve

()

FillRegion

Capacidades: Environment

Terrain:FillRegion(

region:Region3, resolution:number, material:Enum.Material

):()

Parámetros

region:Region3

resolution:number

material:Enum.Material

Devuelve

()

FillWedge

Capacidades: Environment

Terrain:FillWedge(

cframe:CFrame, size:Vector3, material:Enum.Material

):()

Parámetros

cframe:CFrame

size:Vector3

material:Enum.Material

Devuelve

()

GetCell

Obsoleto

GetMaterialColor

Escribir paralelo

Capacidades: Environment

Terrain:GetMaterialColor(material:Enum.Material):Color3

Parámetros

material:Enum.Material

Devuelve

Color3

GetMaterialSlot

Capacidades: Environment

Terrain:GetMaterialSlot(slotIndex:number):Tuple

Parámetros

slotIndex:number

Devuelve

Tuple

Muestras de código

Espacios de Material del Terreno

local MaterialService = game:GetService("MaterialService")
local Terrain = workspace.Terrain

-- Los espacios 2 a 63 son escribibles; los espacios 0 y 1 están reservados para Aire y Agua
local SLOT_INDEX = 2
local BASE_MATERIAL = Enum.Material.Grass
local VARIANT_NAME = "SwampVariant"

-- Encuentra un MaterialVariant existente para el material base, o crea uno
-- SetMaterialSlot() espera el nombre del variante, no el nombre de visualización del Material Manager
local variant = MaterialService:FindFirstChild(VARIANT_NAME)
if not variant then
	variant = Instance.new("MaterialVariant")
	variant.Name = VARIANT_NAME
	variant.BaseMaterial = BASE_MATERIAL
	variant.Parent = MaterialService
end

-- Configura el espacio con el material base, el nombre del MaterialVariant y un tinte
-- Pasa una cadena vacía en lugar de un nombre de variante para usar la apariencia predeterminada del material base teñida por el color dado
Terrain:SetMaterialSlot(SLOT_INDEX, BASE_MATERIAL, variant.Name, Color3.fromRGB(50, 60, 30))

local baseMaterial, materialVariant, color = Terrain:GetMaterialSlot(SLOT_INDEX)
print(baseMaterial, materialVariant, color)

-- Escribe una región de vóxeles que referencia el espacio por índice, en lugar de por Enum.Material, usando el canal SolidMaterialIndex
local region = Region3.new(Vector3.new(0, 0, 0), Vector3.new(16, 16, 16)):ExpandToGrid(4)
local size = region.Size / 4

local materialIndices = {}
local occupancies = {}
for x = 1, size.X do
	materialIndices[x] = {}
	occupancies[x] = {}
	for y = 1, size.Y do
		materialIndices[x][y] = {}
		occupancies[x][y] = {}
		for z = 1, size.Z do
			materialIndices[x][y][z] = SLOT_INDEX
			occupancies[x][y][z] = 1
		end
	end
end

Terrain:WriteVoxelChannels(region, 4, {
	SolidMaterialIndex = materialIndices,
	SolidOccupancy = occupancies,
})

-- Limpiar el espacio deja vóxeles que lo referencian renderizándose como inválidos hasta que se repinten con un índice de espacio válido
Terrain:ResetMaterialSlot(SLOT_INDEX)

GetWaterCell

Obsoleto

PasteRegion

Capacidades: Environment

Terrain:PasteRegion(

region:TerrainRegion, corner:Vector3int16, pasteEmptyCells:boolean

):()

Parámetros

region:TerrainRegion

corner:Vector3int16

pasteEmptyCells:boolean

Devuelve

()

Muestras de código

Crear, Copiar y Pegar Terreno

local Terrain = workspace.Terrain

-- Crea una región de terreno simple
local initialRegion = Region3.new(Vector3.zero, Vector3.one * 10)
Terrain:FillRegion(initialRegion, 4, Enum.Material.Grass)

-- Copia la región
local copyRegion = Region3int16.new(Vector3int16.new(0, 0, 0), Vector3int16.new(10, 10, 10))
local copiedRegion = Terrain:CopyRegion(copyRegion)

-- Define dónde pegar la región
local newRegionCorner = Vector3int16.new(5, 0, 0)

-- Pega la región
Terrain:PasteRegion(copiedRegion, newRegionCorner, true)

ReadVoxelChannels

Escribir paralelo

Capacidades: Environment

Terrain:ReadVoxelChannels(

region:Region3, resolution:number, channelIds:{any}

):Dictionary

Parámetros

region:Region3

resolution:number

channelIds:{any}

Devuelve

Dictionary

Muestras de código

Terrain:ReadVoxelChannels()

local REGION_START = Vector3.new(-20, -20, -20)
local REGION_END = Vector3.new(20, 20, 20)

local function printRegion(terrain, region)
	local channelOutput = terrain:ReadVoxelChannels(region, 4, { "OcupaciónSólida", "MaterialSólido", "OcupaciónLíquida" })
	local size = channelOutput.Size
	for x = 1, size.X do
		for y = 1, size.Y do
			for z = 1, size.Z do
				print(
					("(%2i, %2i, %2i): %.2f %s %.2f"):format(
						x,
						y,
						z,
						channelOutput.SolidOccupancy[x][y][z],
						channelOutput.SolidMaterial[x][y][z].Name,
						channelOutput.LiquidOccupancy[x][y][z]
					)
				)
			end
		end
	end
end

local region = Region3.new(REGION_START, REGION_END)
printRegion(workspace.Terrain, region)

ReadVoxels

Escribir paralelo

Capacidades: Environment

Terrain:ReadVoxels(

region:Region3, resolution:number

):Tuple

Parámetros

region:Region3

resolution:number

Devuelve

Tuple

Muestras de código

Terrain:ReadVoxels()

local REGION_START = Vector3.new(-20, -20, -20)
local REGION_END = Vector3.new(20, 20, 20)

local function printRegion(terrain, region)
	local materials, occupancies = terrain:ReadVoxels(region, 4)

	local size = materials.Size -- Igual que occupancies.Size

	for x = 1, size.X, 1 do
		for y = 1, size.Y, 1 do
			for z = 1, size.Z, 1 do
				print(("(%2i, %2i, %2i): %.2f %s"):format(x, y, z, occupancies[x][y][z], materials[x][y][z].Name))
			end
		end
	end
end

local region = Region3.new(REGION_START, REGION_END)

printRegion(workspace.Terrain, region)

ReplaceMaterial

Capacidades: Environment

Terrain:ReplaceMaterial(

region:Region3, resolution:number, sourceMaterial:Enum.Material, targetMaterial:Enum.Material

):()

Parámetros

region:Region3

resolution:number

sourceMaterial:Enum.Material

targetMaterial:Enum.Material

Devuelve

()

Muestras de código

Terrain:ReplaceMaterial

local terrain = workspace.Terrain
local region = Region3.new(Vector3.new(-20, -20, -20), Vector3.new(20, 20, 20))
local resolution = 4
local materialToReplace = Enum.Material.Grass
local replacementMaterial = Enum.Material.Asphalt

terrain:ReplaceMaterial(region, resolution, materialToReplace, replacementMaterial)

ResetMaterialSlot

Capacidades: Environment

Terrain:ResetMaterialSlot(slotIndex:number):()

Parámetros

slotIndex:number

Devuelve

()

Muestras de código

Espacios de Material del Terreno

local MaterialService = game:GetService("MaterialService")
local Terrain = workspace.Terrain

-- Los espacios 2 a 63 son escribibles; los espacios 0 y 1 están reservados para Aire y Agua
local SLOT_INDEX = 2
local BASE_MATERIAL = Enum.Material.Grass
local VARIANT_NAME = "SwampVariant"

-- Encuentra un MaterialVariant existente para el material base, o crea uno
-- SetMaterialSlot() espera el nombre del variante, no el nombre de visualización del Material Manager
local variant = MaterialService:FindFirstChild(VARIANT_NAME)
if not variant then
	variant = Instance.new("MaterialVariant")
	variant.Name = VARIANT_NAME
	variant.BaseMaterial = BASE_MATERIAL
	variant.Parent = MaterialService
end

-- Configura el espacio con el material base, el nombre del MaterialVariant y un tinte
-- Pasa una cadena vacía en lugar de un nombre de variante para usar la apariencia predeterminada del material base teñida por el color dado
Terrain:SetMaterialSlot(SLOT_INDEX, BASE_MATERIAL, variant.Name, Color3.fromRGB(50, 60, 30))

local baseMaterial, materialVariant, color = Terrain:GetMaterialSlot(SLOT_INDEX)
print(baseMaterial, materialVariant, color)

-- Escribe una región de vóxeles que referencia el espacio por índice, en lugar de por Enum.Material, usando el canal SolidMaterialIndex
local region = Region3.new(Vector3.new(0, 0, 0), Vector3.new(16, 16, 16)):ExpandToGrid(4)
local size = region.Size / 4

local materialIndices = {}
local occupancies = {}
for x = 1, size.X do
	materialIndices[x] = {}
	occupancies[x] = {}
	for y = 1, size.Y do
		materialIndices[x][y] = {}
		occupancies[x][y] = {}
		for z = 1, size.Z do
			materialIndices[x][y][z] = SLOT_INDEX
			occupancies[x][y][z] = 1
		end
	end
end

Terrain:WriteVoxelChannels(region, 4, {
	SolidMaterialIndex = materialIndices,
	SolidOccupancy = occupancies,
})

-- Limpiar el espacio deja vóxeles que lo referencian renderizándose como inválidos hasta que se repinten con un índice de espacio válido
Terrain:ResetMaterialSlot(SLOT_INDEX)

SetCell

Obsoleto

SetCells

Obsoleto

SetMaterialColor

Capacidades: Environment

Terrain:SetMaterialColor(

material:Enum.Material, value:Color3

):()

Parámetros

material:Enum.Material

value:Color3

Devuelve

()

SetMaterialSlot

Capacidades: Environment

Terrain:SetMaterialSlot(

slotIndex:number, baseMaterial:Enum.Material, materialVariant:string, color:Color3

):()

Parámetros

slotIndex:number

baseMaterial:Enum.Material

materialVariant:string

color:Color3

Devuelve

()

Muestras de código

Espacios de Material del Terreno

local MaterialService = game:GetService("MaterialService")
local Terrain = workspace.Terrain

-- Los espacios 2 a 63 son escribibles; los espacios 0 y 1 están reservados para Aire y Agua
local SLOT_INDEX = 2
local BASE_MATERIAL = Enum.Material.Grass
local VARIANT_NAME = "SwampVariant"

-- Encuentra un MaterialVariant existente para el material base, o crea uno
-- SetMaterialSlot() espera el nombre del variante, no el nombre de visualización del Material Manager
local variant = MaterialService:FindFirstChild(VARIANT_NAME)
if not variant then
	variant = Instance.new("MaterialVariant")
	variant.Name = VARIANT_NAME
	variant.BaseMaterial = BASE_MATERIAL
	variant.Parent = MaterialService
end

-- Configura el espacio con el material base, el nombre del MaterialVariant y un tinte
-- Pasa una cadena vacía en lugar de un nombre de variante para usar la apariencia predeterminada del material base teñida por el color dado
Terrain:SetMaterialSlot(SLOT_INDEX, BASE_MATERIAL, variant.Name, Color3.fromRGB(50, 60, 30))

local baseMaterial, materialVariant, color = Terrain:GetMaterialSlot(SLOT_INDEX)
print(baseMaterial, materialVariant, color)

-- Escribe una región de vóxeles que referencia el espacio por índice, en lugar de por Enum.Material, usando el canal SolidMaterialIndex
local region = Region3.new(Vector3.new(0, 0, 0), Vector3.new(16, 16, 16)):ExpandToGrid(4)
local size = region.Size / 4

local materialIndices = {}
local occupancies = {}
for x = 1, size.X do
	materialIndices[x] = {}
	occupancies[x] = {}
	for y = 1, size.Y do
		materialIndices[x][y] = {}
		occupancies[x][y] = {}
		for z = 1, size.Z do
			materialIndices[x][y][z] = SLOT_INDEX
			occupancies[x][y][z] = 1
		end
	end
end

Terrain:WriteVoxelChannels(region, 4, {
	SolidMaterialIndex = materialIndices,
	SolidOccupancy = occupancies,
})

-- Limpiar el espacio deja vóxeles que lo referencian renderizándose como inválidos hasta que se repinten con un índice de espacio válido
Terrain:ResetMaterialSlot(SLOT_INDEX)

SetWaterCell

Obsoleto

WorldToCell

Capacidades: Environment

Terrain:WorldToCell(position:Vector3):Vector3

Parámetros

position:Vector3

Devuelve

Vector3

WorldToCellPreferEmpty

Capacidades: Environment

Terrain:WorldToCellPreferEmpty(position:Vector3):Vector3

Parámetros

position:Vector3

Devuelve

Vector3

WorldToCellPreferSolid

Capacidades: Environment

Terrain:WorldToCellPreferSolid(position:Vector3):Vector3

Parámetros

position:Vector3

Devuelve

Vector3

WriteVoxelChannels

Capacidades: Environment

Terrain:WriteVoxelChannels(

region:Region3, resolution:number, channels:Dictionary

):()

Parámetros

region:Region3

resolution:number

channels:Dictionary

Devuelve

()

Muestras de código

Terrain:WriteVoxelChannels()

local region = Region3.new(Vector3.new(0, 0, 0), Vector3.new(64, 32, 64))

local RESOLUTION = 4
local OCC_EPSILON = 1 / 256

local function generateRandomTerrainInRegion(regionInput)
	local region = regionInput:ExpandToGrid(4)
	local size = region.Size / 4
	local solidMaterials = {}
	local solidOccupancies = {}
	local waterOcc = {}

	for x = 1, size.X do
		table.insert(solidMaterials, {})
		table.insert(solidOccupancies, {})
		table.insert(waterOcc, {})

		for y = 1, size.Y do
			table.insert(solidMaterials[x], {})
			table.insert(solidOccupancies[x], {})
			table.insert(waterOcc[x], {})

			for z = 1, size.Z do
				local mat = if math.random() < 0.5 then Enum.Material.Air else Enum.Material.Sand
				local occ = 0
				local water = math.random()
				if mat == Enum.Material.Sand then
					occ = math.random() / 2 + 0.5
					if occ > 1 - OCC_EPSILON then
						water = 0 -- Los sólidos no pueden contener agua
					end
				else
					occ = 0
				end
				table.insert(solidMaterials[x][y], mat)
				table.insert(solidOccupancies[x][y], occ)
				table.insert(waterOcc[x][y], water)
			end
		end
	end
	return { SolidMaterial = solidMaterials, SolidOccupancy = solidOccupancies, LiquidOccupancy = waterOcc }
end

local regionContent = generateRandomTerrainInRegion(region)
workspace.Terrain:WriteVoxelChannels(region, 4, regionContent)

WriteVoxels

Capacidades: Environment

Terrain:WriteVoxels(

region:Region3, resolution:number, materials:{any}, occupancy:{any}

):()

Parámetros

region:Region3

resolution:number

materials:{any}

occupancy:{any}

Devuelve

()

Muestras de código

Terrain:WriteVoxels()

local terrain = workspace.Terrain
local resolution = 4
local region = Region3.new(Vector3.new(0, 0, 0), Vector3.new(16, 28, 20)):ExpandToGrid(resolution)
local materials = {
	{
		{
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
		},
		{ Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock },
		{ Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock },
		{ Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand },
		{ Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand },
		{ Enum.Material.Mud, Enum.Material.Mud, Enum.Material.Mud, Enum.Material.Mud, Enum.Material.Mud },
		{ Enum.Material.Air, Enum.Material.Air, Enum.Material.Air, Enum.Material.Air, Enum.Material.Air },
	},
	{
		{
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
		},
		{ Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock },
		{ Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock },
		{ Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand },
		{ Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand },
		{ Enum.Material.Mud, Enum.Material.Snow, Enum.Material.Snow, Enum.Material.Snow, Enum.Material.Mud },
		{ Enum.Material.Air, Enum.Material.Snow, Enum.Material.Snow, Enum.Material.Snow, Enum.Material.Air },
	},
	{
		{
			Enum.Material.CrackedLava,
			Enum.Material.Sand,
			Enum.Material.Sand,
			Enum.Material.Sand,
			Enum.Material.CrackedLava,
		},
		{ Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock },
		{ Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock },
		{ Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand },
		{ Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand },
		{ Enum.Material.Mud, Enum.Material.Snow, Enum.Material.Snow, Enum.Material.Snow, Enum.Material.Mud },
		{ Enum.Material.Air, Enum.Material.Snow, Enum.Material.Snow, Enum.Material.Snow, Enum.Material.Air },
	},
	{
		{
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
			Enum.Material.CrackedLava,
		},
		{ Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock },
		{ Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock, Enum.Material.Rock },
		{ Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand },
		{ Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand, Enum.Material.Sand },
		{ Enum.Material.Mud, Enum.Material.Mud, Enum.Material.Mud, Enum.Material.Mud, Enum.Material.Mud },
		{ Enum.Material.Air, Enum.Material.Air, Enum.Material.Air, Enum.Material.Air, Enum.Material.Air },
	},
}
local occupancies = {
	{
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 0.5, 0.5, 0.5, 0.5, 0.5 },
		{ 0, 0, 0, 0, 0 },
	},
	{
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 0.5, 1, 1, 1, 0.5 },
		{ 0, 1, 1, 1, 0 },
	},
	{
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 0.5, 1, 1, 1, 0.5 },
		{ 0, 1, 1, 1, 0 },
	},
	{
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 1, 1, 1, 1, 1 },
		{ 0.5, 0.5, 0.5, 0.5, 0.5 },
		{ 0, 0, 0, 0, 0 },
	},
}

terrain:WriteVoxels(region, resolution, materials, occupancies)