Experiences
GuidesTutorialsReferenceResourcesArtDesign

Vector3Value

Show Deprecated

A Vector3Value simply holds a Vector3 as a value. This value can be used for scripts to communicate, for objects to move to a preset location, etc.

Code Samples

Teleporter Part
-- Paste me in a Script inside a Part

local part = script.Parent



local teleportPosition = part.TeleportPosition



local function onTouch(otherPart)

	-- First, find the HumanoidRootPart. If we can't find it, exit.

	local hrp = otherPart.Parent:FindFirstChild("HumanoidRootPart")

	if not hrp then

		return

	end



	-- Now teleport by setting the CFrame to one created from

	-- the stored TeleportPosition

	hrp.CFrame = CFrame.new(teleportPosition.Value)

end



part.Touched:Connect(onTouch)
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)

Summary

Properties

Value: Vector3

The stored Vector3.

Methods

Events

Changed(value: Vector3): RBXScriptSignal  

Fired whenever Vector3Value.Value is changed.

Properties

Methods

Events

Changed

Fired whenever the Vector3Value.Value of the Vector3Value is changed. It will run with the new value being stored in the argument object, instead of a string representing the property being changed.

This event, like other changed events, can be used to track when an Vector3Value changes and to track the different values that it may change to.

For instance, this may be useful in games that rely on Vector3Values to track positions in the game world.

Equivalent changed events exist for similar objects, such as NumberValue and StringValue, depending on what object type best suits the need.

Parameters

value: Vector3

The new value after the change.


Code Samples

How to Use 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)