Vector3Value

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Une valeur Vector3 simplement tient un Vector3 comme valeur. Cette valeur peut être utilisée pour que les scripts se communiquent, pour que les objets se déplacent vers une position prédéfinie, etc.

Échantillons de code

Ce code d'exemple fait en sorte qu'une partie téléporte n'importe quel joueur qui la touche vers une position spécifique définie par un vecteur "Position de téléportation" Vector3Value.

Partie téléporteur

-- Collez-moi dans un script à l'intérieur d'une partie
local part = script.Parent
local teleportPosition = part.TeleportPosition
local function onTouch(otherPart)
-- Tout d'abord, trouvez la partie racine humanoïde. Si nous ne pouvons pas la trouver, sortez.
local hrp = otherPart.Parent:FindFirstChild("HumanoidRootPart")
if not hrp then
return
end
-- Maintenant téléporter en définissant le CFrame sur celui créé à partir de
-- la position de téléportation stockée
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)

Propriétés

Value

Lecture parallèle

Le stocké Vector3 .

Méthodes

Évènements

Changed

Tiré chaque fois que le Vector3Value.Value du Vector3Value est modifié.Il s'exécutera avec la nouvelle valeur stockée dans l'objet d'argument, au lieu d'une chaîne représentant la propriété modifiée.

Cet événement, comme d'autres événements modifiés, peut être utilisé pour suivre quand un Vector3Value change et pour suivre les différentes valeurs qu'il peut changer.

Par instance, cela peut être utile dans les jeux qui comptent sur Vector3Values pour suivre les positions dans le monde du jeu.

Des événements équivalents modifiés existent pour des objets similaires, tels que NumberValue et StringValue, en fonction du type d'objet qui convient le mieux aux besoins.

Paramètres

value: Vector3

La nouvelle valeur après le changement.


Échantillons de code

L'exemple ci-dessous, en supposant que tous les objets référencés existaient, imprimerait la nouvelle valeur du Vector3Value à chaque fois qu'elle changeait.Dans l'exemple ci-dessous, il imprimerait "10,10,10" .

Comment utiliser 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)