Tutoriel · Bases du scripting

Tutoriel TweenService : déplacer, tourner et faire disparaître des parts

Un tween change une propriété en douceur, de sa valeur actuelle vers un objectif, sur une durée donnée : une plateforme glisse, une gemme tourne, un mur s'efface. TweenService calcule les étapes intermédiaires pour toi, donc tu n'écris jamais de boucle qui pousse une part à chaque image. Ce guide couvre les trois lignes dont tout tween a besoin, ce que fait chaque réglage de TweenInfo, déplacer, faire tourner et faire disparaître des parts, les boucles, attendre la fin d'un tween, et l'astuce pour tweener un Model entier.

Mis à jour le 12 novembre 20266 min de lectureÉcrit par

En bref

Récupère le service avec game:GetService("TweenService"), décris le mouvement avec TweenInfo.new(time, easingStyle, easingDirection), puis appelle TweenService:Create(part, info, { Position = goal }) et lance avec :Play() le tween qu'il renvoie. N'importe quelle propriété de type nombre, Vector3, CFrame, Color3, UDim2 ou similaire peut être tweenée. Utilise tween.Completed:Wait() pour attendre sa fin, et donne à TweenInfo un nombre de répétitions de -1 avec le retour activé pour une boucle d'aller-retour.

  • Tweene la part sur le serveur quand tous les joueurs doivent la voir ; sur le client pour des effets dont seul ce joueur a besoin.
  • Ancre les parts que tu tweenes, sinon la physique se bat contre le tween.
  • Un Model n'a ni Position ni CFrame à tweener : tweene une NumberValue et déplace le modèle avec PivotTo.
Sur cette page
  1. Fonctionnement
  2. 1. TweenInfo
  3. 2. Tourner et disparaître
  4. 3. Boucles
  5. 4. Models
  6. Serveur ou client
  7. Problèmes courants
  8. Avec RoCode
  9. Questions fréquentes
  10. Sources et lectures

Les trois lignes dont tout tween a besoin

Insère une Part dans Workspace, coche Anchored, puis survole-la, clique sur + et insère un Script. Celui-ci monte la part de 10 studs en 2 secondes :

Script dans une Part de Workspace nommé Rise
-- Script dans une Part.
local TweenService = game:GetService("TweenService")

local part = script.Parent :: BasePart

local info = TweenInfo.new(2) -- 2 secondes, easing par défaut
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }

local tween = TweenService:Create(part, info, goal)
tween:Play()

L'objectif est une table de noms de propriétés et des valeurs auxquelles elles doivent arriver. Tu peux tweener plusieurs propriétés à la fois : { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Le tween part des valeurs qu'elles ont au moment où tu appelles Play, donc tu ne donnes jamais que la fin.

Ce qui peut être tweené et ce qui ne peut pas l'être
TypeTween fluide ?Exemples
numberOuiTransparency, Reflectance, la Value d'une NumberValue
Vector3, CFrameOuiPosition, Size, CFrame, Orientation
Color3OuiColor
UDim2, Vector2OuiSize et Position des interfaces
boolean, EnumItemChange à la finCanCollide, Material
string, InstanceNonDonne cannot be tweened due to type mismatch (en anglais)

Étape 1 : chaque réglage de TweenInfo

TweenInfo.new prend jusqu'à six valeurs, dans cet ordre. Tu peux omettre celles de la fin.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
ValeurPar défautCe qu'elle fait
time1Secondes pour une lecture.
easingStyleQuadLa forme du mouvement : Linear (vitesse constante), Sine, Quad, Cubic, Back (dépasse un peu), Bounce, Elastic, Exponential.
easingDirectionOutOut démarre vite et ralentit ; In démarre lentement ; InOut fait les deux.
repeatCount0Lectures en plus après la première. -1 répète à l'infini.
reversesfalseRevient au départ après chaque lecture.
delayTime0Secondes d'attente avant de commencer.
Script dans une Part de Workspace nommé Platform
-- Script dans une Part nommée Platform.
-- Glisse de 12 studs en aller-retour à l'infini, en ralentissant aux deux bouts.
local TweenService = game:GetService("TweenService")

local platform = script.Parent :: BasePart

local info = TweenInfo.new(
	3, -- secondes dans chaque sens
	Enum.EasingStyle.Sine,
	Enum.EasingDirection.InOut,
	-1, -- répète à l'infini
	true -- revient à chaque fois
)

TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()

Pour une plateforme qui doit transporter les joueurs debout dessus, une part ancrée tweenée bouge sous eux mais ne les emmène pas. Le guide de la plateforme mobile (en anglais) couvre ce cas.

Étape 2 : tourner, redimensionner et faire disparaître

Pour faire tourner une part, tweene son CFrame vers le CFrame actuel multiplié par une rotation. Tweener Orientation marche aussi, mais le CFrame garde la part en place pendant qu'elle tourne. Ici, un mur tourne puis s'efface et rétrécit quand le script tourne, et il est supprimé une fois le tween terminé :

Script dans une Part de Workspace nommé FadingWall
-- Script dans une Part nommée FadingWall.
local TweenService = game:GetService("TweenService")

local wall = script.Parent :: BasePart

-- un quart de tour autour de l'axe vertical de la part, en 1 seconde
local turn = TweenService:Create(wall, TweenInfo.new(1), {
	CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- ne continue qu'une fois le tween terminé

-- puis s'efface et rétrécit en même temps
local fade = TweenService:Create(wall, TweenInfo.new(0.8, Enum.EasingStyle.Quad, Enum.EasingDirection.In), {
	Transparency = 1,
	Size = wall.Size * 0.2,
})
fade:Play()
fade.Completed:Wait()
wall:Destroy()

Completed se déclenche avec un PlaybackState : Completed quand le tween a atteint l'objectif, ou Cancelled quand tween:Cancel() l'a arrêté. N'attends pas Completed pour un tween qui se répète à l'infini : il ne finit jamais.

Étape 3 : un objet à ramasser qui flotte et tourne

Deux tweens en boucle sur des propriétés différentes tournent côte à côte. Tweener un tour complet de 360 degrés avec le CFrame ne fait rien, parce que le départ et l'arrivée sont la même rotation, donc la rotation tweene une NumberValue de 0 à 360 et règle le CFrame à partir d'elle. Mets ce Script dans une part ancrée :

Script dans une Part de Workspace nommé FloatingGem
-- Script dans une Part nommée Gem. Flotte de haut en bas et tourne à l'infini.
local TweenService = game:GetService("TweenService")

local FLOAT_HEIGHT = 1.5 -- studs au-dessus de l'endroit où tu l'as posée
local FLOAT_SECONDS = 1.2 -- dans chaque sens
local SPIN_SECONDS = 3 -- un tour complet

local gem = script.Parent :: BasePart
gem.Anchored = true
local baseCFrame = gem.CFrame

local height = Instance.new("NumberValue")
local angle = Instance.new("NumberValue")

local function apply()
	gem.CFrame = baseCFrame * CFrame.new(0, height.Value, 0) * CFrame.Angles(0, math.rad(angle.Value), 0)
end
height.Changed:Connect(apply)
angle.Changed:Connect(apply)

TweenService:Create(height, TweenInfo.new(FLOAT_SECONDS, Enum.EasingStyle.Sine, Enum.EasingDirection.InOut, -1, true), {
	Value = FLOAT_HEIGHT,
}):Play()

TweenService:Create(angle, TweenInfo.new(SPIN_SECONDS, Enum.EasingStyle.Linear, Enum.EasingDirection.In, -1), {
	Value = 360,
}):Play()

La rotation utilise l'easing Linear pour tourner à vitesse constante, et elle repart à 0 à chaque boucle, ce qui est le même angle que 360, donc il n'y a pas de saut. Le guide des pièces à ramasser (en anglais) met des objets comme celui-ci dans un jeu.

Étape 4 : tweener un Model entier

Un Model n'a pas de propriété Position ni CFrame, donc TweenService:Create(model, ...) n'a rien à déplacer. Tweene plutôt une NumberValue de 0 à 1 et déplace le modèle avec PivotTo, qui déplace toutes ses parts ensemble :

Script dans un Model de Workspace nommé Elevator
-- Script dans un Model nommé Elevator.
-- Monte le modèle entier de 20 studs puis le redescend, toutes les parts ensemble.
local TweenService = game:GetService("TweenService")

local elevator = script.Parent :: Model
local startPivot = elevator:GetPivot()
local endPivot = startPivot * CFrame.new(0, 20, 0)

local progress = Instance.new("NumberValue")
progress.Changed:Connect(function(alpha: number)
	elevator:PivotTo(startPivot:Lerp(endPivot, alpha))
end)

local info = TweenInfo.new(4, Enum.EasingStyle.Quad, Enum.EasingDirection.InOut, -1, true, 2)
TweenService:Create(progress, info, { Value = 1 }):Play()

Ancre toutes les parts du modèle. Le 2 à la fin de TweenInfo est le délai avant chaque lecture, donc l'ascenseur attend en haut et en bas. Le guide des portes (en anglais) utilise la même méthode pour ouvrir des portes faites de plusieurs parts.

Serveur ou client ?

Un tween lancé dans un Script serveur change la part sur le serveur, et les nouvelles valeurs sont répliquées à tous les joueurs, donc tout le monde le voit. Un tween dans un LocalScript ne change la part que sur l'écran de ce joueur.

Où lancer un tween
Lance-le dansQuandExemple
Un Script serveurLe changement compte pour le jeu ou pour tout le monde.Des portes, des obstacles mobiles, un pont qui s'ouvre
Un LocalScriptSeul ce joueur doit le voir, ou c'est un effet purement visuel.Un objet qui s'efface pour le joueur qui l'a ramassé, l'interface

La réplication envoie des mises à jour plusieurs fois par seconde, donc les tweens serveur paraissent fluides pour la plupart des joueurs, mais des tweens serveur très rapides ou très nombreux peuvent paraître moins fluides avec une connexion lente. Pour beaucoup de mouvements décoratifs (des centaines de pièces qui tournent), lance les tweens dans un LocalScript sur chaque client.

Problèmes courants

Ouvre la fenêtre Output (menu Window, puis Output) avant d'appuyer sur Play.

La part ne bouge pas du tout

Vérifie que tu as appelé :Play() sur le tween, que le nom de la propriété de l'objectif est écrit exactement (Position, pas position), et que c'est un Script à un endroit où les scripts tournent (dans une part de Workspace, ou dans ServerScriptService).

La part tombe ou tremble pendant le tween

Elle n'est pas ancrée, donc la gravité et les collisions se battent contre le tween. Coche Anchored.

TweenService:Create property cannot be tweened due to type mismatch

La valeur de l'objectif n'a pas le bon type, par exemple un nombre pour une propriété Vector3. Vois la page de l'erreur (en anglais).

Unable to cast to Dictionary ou Unable to cast value to Object

Les arguments ne sont pas dans le bon ordre ou n'ont pas le bon type. C'est toujours Create(instance, tweenInfo, goalTable). Vois Unable to cast value to Object (en anglais).

Le faire avec RoCode

Si tu préfères ne pas écrire les tweens à la main, RoCode peut les construire dans le jeu que tu as ouvert. RoCode est un agent IA indépendant pour Roblox Studio, qui n'est pas fait par Roblox : tu décris le changement dans un chat web, et son plugin pour Studio crée les scripts dans ton Explorer, donc il n'y a pas de code à coller.

Tu écris

Fais glisser le modèle du pont dans Workspace de 15 studs sur le côté quand la manche commence, avec un tween de NumberValue et PivotTo, et fais disparaître en même temps les parts rouges de la barrière en 1 seconde.

RoCode fait
  • Peut trouver les parts et les modèles dont tu parles avec Search Game avant d'écrire quoi que ce soit
  • Écrit le Script avec Create Script et a pour consigne de vérifier sa compilation avec Check Script
  • Place un point d'annulation avant et après chaque lot de changements, donc Ctrl+Z revient en arrière un lot à la fois

Avec le plugin 3.9 ou plus récent, RoCode peut lancer un court test et lire les erreurs, mais un mouvement se juge mieux de tes propres yeux, donc appuie sur Play et regarde. Comment RoCode se connecte à Studio.

Questions fréquentes

Comment utiliser TweenService sur Roblox ?

Récupère le service, crée un TweenInfo, appelle TweenService:Create(object, info, { Property = goal }) et lance le résultat avec :Play(). La première partie a un exemple en trois lignes.

Comment faire tourner un tween en boucle à l'infini ?

Passe -1 comme quatrième valeur de TweenInfo.new (repeatCount), et true comme cinquième s'il doit faire l'aller-retour.

Comment attendre la fin d'un tween ?

Appelle tween.Completed:Wait() après tween:Play(), ou connecte une fonction à tween.Completed.

Peut-on tweener un Model ?

Pas directement. Tweene une NumberValue de 0 à 1 et appelle model:PivotTo(start:Lerp(goal, value)) quand elle change, comme à l'étape 4.

Comment arrêter un tween ?

Appelle tween:Cancel() pour l'arrêter et laisser la part là où elle est, ou tween:Pause() pour reprendre plus tard avec Play().

Sources et lectures

Comment le code a été vérifié : chaque script de cette page passe le vérificateur de types strict de Luau avec les définitions de l'API Roblox (luau-lsp, 12 novembre 2026). Une vérification de types repère les API mal écrites et les mauvais types, pas la logique du jeu : teste dans Studio avant de publier.

Essaie RoCode sur ton propre jeu.

Des crédits gratuits chaque jour, sans carte. Installe le plugin, décris la fonctionnalité et vérifie ce qui arrive dans Studio.