Vector3Value

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Um Vector3Value simplesmente armazena um Vector3 como um valor. Este valor pode ser usado para scripts se comunicarem, para objetos se moverem para uma localização predefinida, etc.

Amostras de código

Este exemplo de código causa a teleportação de uma peça para qualquer jogador que a toque para uma posição específica definida por um valor de vetor "TeleportPosition" Vector3.

Parte do Teletransportador

-- Coloque-me em um Script dentro de uma Parte
local part = script.Parent
local teleportPosition = part.TeleportPosition
local function onTouch(otherPart)
-- Primeiro, encontre a HumanoidRootPart. Se não pudermos encontrá-la, saia.
local hrp = otherPart.Parent:FindFirstChild("HumanoidRootPart")
if not hrp then
return
end
-- Agora teletransporte definindo o CFrame para um criado a partir de
-- a posição de teletransporte armazenada
hrp.CFrame = CFrame.new(teleportPosition.Value)
end
part.Touched:Connect(onTouch)

This code sample demonstrates how it is possible to store a Vector2 within a Vector3Value by converting a Vector2 into a Vector3 with a dummy Z value. Similarly, you can load it by reconstructing the Vector2 from the X and Y axes.

Storing Vector2 inside Vector3Value

local vector3Value = Instance.new("Vector3Value")
-- Store a Vector2 in a Vector3
local vector2 = Vector2.new(42, 70)
vector3Value.Value = Vector3.new(vector2.X, vector2.Y, 0) -- The Z value is ignored
-- Load a Vector2 from a Vector3
vector2 = Vector2.new(vector3Value.Value.X, vector3Value.Value.Y)
print(vector2)

Propriedades

Value

Ler Parallel

O armazenado Vector3 armazenado.

Métodos

Eventos

Changed

Dispedido sempre que o Vector3Value.Value da Vector3Value for alterado.Ele será executado com o novo valor sendo armazenado no Objetode argumento, em vez de uma string que representa a propriedade sendo alterada.

Este evento, como outros eventos alterados, pode ser usado para rastrear quando um Vector3Value muda e para rastrear os diferentes valores que ele pode mudar.

Por instância, isso pode ser útil em jogos que dependem de Vector3Values para rastrear posições no mundo do jogo.

Eventos equivalentes modificados existem para objetos semelhantes, como NumberValue e StringValue, dependendo do tipo de objeto que melhor atende à necessidade.

Parâmetros

value: Vector3

O novo valor após a alteração.


Amostras de código

O exemplo a seguir, assumindo que todos os objetos referenciados existissem, imprimiria o novo valor do Vector3Value cada vez que ele mudasse.No exemplo abaixo, ele imprimiria "10,10,10" .

Como usar o Vector3Value.Changed

local value = Instance.new("Vector3Value")
value.Parent = workspace
value.Changed:Connect(function(NewValue)
print(NewValue)
end)
value.Value = Vector3.new(10, 10, 10)