Με λίγα λόγια
Πάρτε την υπηρεσία με game:GetService("TweenService"), περιγράψτε την κίνηση με TweenInfo.new(time, easingStyle, easingDirection), μετά καλέστε TweenService:Create(part, info, { Position = goal }) και ξεκινήστε το tween που επιστρέφεται με :Play(). Μπορείτε να κάνετε tween σε κάθε ιδιότητα τύπου number, Vector3, CFrame, Color3, UDim2 και παρόμοιων. Για να περιμένετε το τέλος, χρησιμοποιήστε tween.Completed:Wait(), και για κίνηση πέρα δώθε χωρίς τέλος βάλτε στο TweenInfo αριθμό επαναλήψεων -1 και ενεργοποιήστε το reverses.
- Κάντε tween στο part στον server όταν πρέπει να το βλέπουν όλοι οι παίκτες· στον client όταν το εφέ αφορά μόνο αυτόν τον παίκτη.
- Κάντε Anchored τα parts στα οποία κάνετε tween, αλλιώς η φυσική θα εμποδίζει το tween.
- Ένα Model δεν έχει Position ή CFrame για tween: κάντε tween σε ένα NumberValue και μετακινήστε το μοντέλο με
PivotTo.
Σε αυτή τη σελίδα
Οι τρεις γραμμές που χρειάζεται κάθε tween
Βάλτε ένα Part στο Workspace, τσεκάρετε το Anchored, μετά περάστε τον κέρσορα από πάνω του, πατήστε + και προσθέστε ένα Script. Αυτό το script ανεβάζει το part 10 studs σε 2 δευτερόλεπτα:
-- Script μέσα σε Part.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 δευτερόλεπτα, προεπιλεγμένο easing
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
Ο στόχος είναι ένας πίνακας με ονόματα ιδιοτήτων και τις τιμές στις οποίες πρέπει να καταλήξουν. Μπορείτε να κάνετε tween σε πολλές ιδιότητες μαζί: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Το tween ξεκινά από τις τιμές που υπάρχουν τη στιγμή που καλείται το Play, οπότε ορίζετε πάντα μόνο το τέλος.
| Τύπος | Ομαλό tween; | Παραδείγματα |
|---|---|---|
| number | Ναι | Transparency, Reflectance, Value σε NumberValue |
| Vector3, CFrame | Ναι | Position, Size, CFrame, Orientation |
| Color3 | Ναι | Color |
| UDim2, Vector2 | Ναι | Size και Position σε GUI |
| boolean, EnumItem | Αλλάζει στο τέλος | CanCollide, Material |
| string, Instance | Όχι | Δίνει το σφάλμα cannot be tweened due to type mismatch |
Βήμα 1: όλες οι ρυθμίσεις του TweenInfo
Το TweenInfo.new δέχεται έως έξι τιμές με αυτή τη σειρά. Τις τελευταίες μπορείτε να τις παραλείψετε.
| Τιμή | Προεπιλογή | Τι κάνει |
|---|---|---|
time | 1 | Δευτερόλεπτα για μία αναπαραγωγή. |
easingStyle | Quad | Μορφή της κίνησης: Linear (σταθερή ταχύτητα), Sine, Quad, Cubic, Back (με υπέρβαση), Bounce, Elastic, Exponential. |
easingDirection | Out | Το Out ξεκινά γρήγορα και επιβραδύνει· το In ξεκινά αργά· το InOut κάνει και τα δύο. |
repeatCount | 0 | Πόσες φορές επαναλαμβάνεται μετά την πρώτη αναπαραγωγή. Το -1 επαναλαμβάνει για πάντα. |
reverses | false | Επιστροφή στην αρχή μετά από κάθε αναπαραγωγή. |
delayTime | 0 | Πόσα δευτερόλεπτα να περιμένει πριν ξεκινήσει. |
-- Script μέσα σε Part με όνομα Platform.
-- Πηγαινοέρχεται ατελείωτα 12 studs, ομαλά και στις δύο άκρες.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- δευτερόλεπτα προς κάθε κατεύθυνση
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- επανάληψη για πάντα
true -- επιστροφή κάθε φορά
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Αν η πλατφόρμα πρέπει να μεταφέρει τους παίκτες που στέκονται πάνω της, έχετε υπόψη: ένα anchored part με tween κινείται κάτω από αυτούς, αλλά δεν τους παίρνει μαζί του. Αυτή η περίπτωση εξηγείται στον οδηγό για κινούμενη πλατφόρμα.
Βήμα 2: περιστροφή, μέγεθος και εξαφάνιση
Για να περιστρέψετε ένα part, κάντε tween στο CFrame προς το τρέχον CFrame πολλαπλασιασμένο με μια περιστροφή. Tween στο Orientation δουλεύει επίσης, αλλά με το CFrame το part περιστρέφεται επί τόπου. Εδώ ο τοίχος, όταν ξεκινά το script, στρίβει, μετά σβήνει και μικραίνει, και όταν τελειώσει το tween διαγράφεται:
-- Script μέσα σε Part με όνομα FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- στροφή ενός τετάρτου γύρω από τον δικό του κατακόρυφο άξονα σε 1 δευτερόλεπτο
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- συνεχίζουμε μόνο όταν τελειώσει η στροφή
-- μετά ταυτόχρονα σβήνουμε και μικραίνουμε
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 πυροδοτείται με ένα PlaybackState: Completed αν το tween έφτασε στον στόχο ή Cancelled αν το σταμάτησε το tween:Cancel(). Μην περιμένετε το Completed σε tween που επαναλαμβάνεται για πάντα: δεν θα τελειώσει ποτέ.
Βήμα 3: αντικείμενο που αιωρείται και περιστρέφεται
Δύο tweens σε βρόχο πάνω σε διαφορετικές ιδιότητες τρέχουν ταυτόχρονα. Ένα tween πλήρους περιστροφής 360 μοιρών μέσω CFrame δεν κάνει τίποτα, γιατί αρχή και τέλος είναι η ίδια περιστροφή, γι' αυτό η περιστροφή κάνει tween σε ένα NumberValue από 0 έως 360 και ορίζει το CFrame με βάση αυτό. Βάλτε αυτό το Script σε ένα anchored part:
-- Script μέσα σε Part με όνομα Gem. Αιωρείται πάνω-κάτω και περιστρέφεται ατελείωτα.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- studs πάνω από το σημείο όπου το τοποθετήσατε
local FLOAT_SECONDS = 1.2 -- προς κάθε κατεύθυνση
local SPIN_SECONDS = 3 -- μία πλήρης περιστροφή
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()
Η περιστροφή χρησιμοποιεί Linear easing, οπότε γυρίζει με σταθερή ταχύτητα, και κάθε κύκλος ξεκινά ξανά από το 0, που είναι η ίδια γωνία με το 360, άρα δεν υπάρχει τίναγμα. Ο οδηγός για συλλογή νομισμάτων βάζει τέτοια αντικείμενα μέσα σε ένα παιχνίδι.
Βήμα 4: tween ολόκληρου μοντέλου
Ένα Model δεν έχει ιδιότητα Position ή CFrame, οπότε το TweenService:Create(model, ...) δεν έχει τι να κινήσει. Αντί γι' αυτό, κάντε tween σε ένα NumberValue από 0 έως 1 και μετακινήστε το μοντέλο με PivotTo, που μετακινεί όλα τα parts μέσα του μαζί:
-- Script μέσα σε Model με όνομα Elevator.
-- Μετακινεί όλο το μοντέλο 20 studs πάνω και πίσω, όλα τα parts μαζί.
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()
Κάντε Anchored όλα τα parts του μοντέλου. Το 2 στο τέλος του TweenInfo είναι η καθυστέρηση πριν από κάθε αναπαραγωγή, γι' αυτό ο ανελκυστήρας στέκεται λίγο πάνω και κάτω. Ο οδηγός για πόρτες ανοίγει με τον ίδιο τρόπο πόρτες από πολλά parts.
Server ή client;
Ένα tween που ξεκινά σε Script του server αλλάζει το part στον server, και οι νέες τιμές αναπαράγονται (replicate) σε όλους τους παίκτες, οπότε το βλέπουν όλοι. Ένα tween σε LocalScript αλλάζει το part μόνο στην οθόνη αυτού του παίκτη.
| Τρέξτε το σε | Πότε | Παράδειγμα |
|---|---|---|
| Script του server | Η αλλαγή έχει σημασία για το παιχνίδι ή για όλους. | Πόρτες, κινούμενα εμπόδια, γέφυρα που ανοίγει |
| LocalScript | Πρέπει να το βλέπει μόνο αυτός ο παίκτης ή είναι καθαρά οπτικό εφέ. | Αντικείμενο που σβήνει για τον παίκτη που το μάζεψε, UI |
Η αναπαραγωγή (replication) στέλνει ενημερώσεις πολλές φορές το δευτερόλεπτο, οπότε τα tweens του server φαίνονται ομαλά στους περισσότερους παίκτες, αλλά πολύ γρήγορα ή πάρα πολλά tweens στον server μπορεί να φαίνονται λιγότερο ομαλά σε αργή σύνδεση. Για μεγάλη ποσότητα διακοσμητικής κίνησης (εκατοντάδες νομίσματα που γυρίζουν) τρέξτε τα tweens σε LocalScript σε κάθε client.
Συνηθισμένα λάθη και λύσεις
Ανοίξτε το παράθυρο Output (μενού Window, μετά Output) πριν πατήσετε Play.
Το part δεν κινείται καθόλου
Ελέγξτε ότι καλέσατε :Play() στο tween, ότι το όνομα της ιδιότητας στον στόχο είναι γραμμένο ακριβώς (Position, όχι position) και ότι είναι Script σε σημείο όπου τα scripts τρέχουν (μέσα σε part στο Workspace ή στο ServerScriptService).
Το part πέφτει ή τρέμει κατά τη διάρκεια του tween
Δεν είναι anchored, οπότε η βαρύτητα και οι συγκρούσεις εμποδίζουν το tween. Τσεκάρετε το Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Η τιμή στόχου είναι λάθος τύπου, για παράδειγμα αριθμός για ιδιότητα τύπου Vector3. Δείτε τη σελίδα του σφάλματος (στα αγγλικά).
Unable to cast to Dictionary ή Unable to cast value to Object
Τα ορίσματα είναι σε λάθος σειρά ή λάθος τύπου. Η σειρά είναι πάντα Create(instance, tweenInfo, goalTable). Δείτε Unable to cast value to Object (στα αγγλικά).
Φτιάξτε το με το RoCode
Αν δεν θέλετε να γράφετε tweens με το χέρι, το RoCode μπορεί να τα φτιάξει στο place που έχετε ανοιχτό. Το RoCode είναι ανεξάρτητος πράκτορας AI για το Roblox Studio, όχι της Roblox: περιγράφετε την αλλαγή στη συνομιλία στο web και το plugin του για το Studio δημιουργεί τα scripts στο Explorer σας, οπότε δεν χρειάζεται να επικολλήσετε κώδικα.
Κάνε το μοντέλο της γέφυρας στο Workspace να μετακινείται 15 studs στο πλάι όταν ξεκινά ο γύρος, με tween σε NumberValue και PivotTo, και ταυτόχρονα σβήσε τα κόκκινα parts-φράγματα σε 1 δευτερόλεπτο.
- Μπορεί να βρει τα σωστά parts και μοντέλα με το Search Game πριν γράψει οτιδήποτε
- Γράφει το Script με το Create Script και έχει εντολή να ελέγξει ότι κάνει compile με το Check Script
- Βάζει σημείο αναίρεσης πριν και μετά από κάθε δέσμη αλλαγών, οπότε το Ctrl+Z αναιρεί μία δέσμη κάθε φορά
Με το plugin 3.9 ή νεότερο το RoCode μπορεί να τρέξει ένα σύντομο playtest και να διαβάσει τα σφάλματα, αλλά την κίνηση την κρίνετε καλύτερα με τα μάτια σας, οπότε πατήστε Play και κοιτάξτε. Πώς συνδέεται το RoCode με το Studio.
Συχνές ερωτήσεις
Πώς χρησιμοποιείται το TweenService στο Roblox;
Πάρτε την υπηρεσία, δημιουργήστε ένα TweenInfo, καλέστε TweenService:Create(object, info, { Property = goal }) και ξεκινήστε το αποτέλεσμα με :Play(). Στην πρώτη ενότητα υπάρχει παράδειγμα τριών γραμμών.
Πώς κάνω ένα tween να επαναλαμβάνεται για πάντα;
Δώστε -1 ως τέταρτη τιμή στο TweenInfo.new (repeatCount) και true ως πέμπτη, αν πρέπει να πηγαινοέρχεται.
Πώς περιμένω να τελειώσει ένα tween;
Καλέστε tween.Completed:Wait() μετά το tween:Play() ή συνδέστε μια συνάρτηση στο tween.Completed.
Μπορώ να κάνω tween σε Model;
Απευθείας όχι. Κάντε tween σε ένα NumberValue από 0 έως 1 και σε κάθε αλλαγή καλέστε model:PivotTo(start:Lerp(goal, value)), όπως στο βήμα 4.
Πώς σταματάω ένα tween;
Καλέστε tween:Cancel() για να το σταματήσετε και να αφήσετε το part εκεί που βρίσκεται, ή tween:Pause() για να συνεχίσετε αργότερα με Play().
Πηγές και περαιτέρω ανάγνωση
- Roblox Creator Docs: TweenService (στα αγγλικά). Create, ποιοι τύποι γίνονται tween και ακύρωση
- Roblox Creator Docs: TweenInfo (στα αγγλικά)
- Roblox Creator Docs: Tween (στα αγγλικά). Play, Pause, Cancel και Completed
- Roblox Creator Docs: UI animation and tweens (στα αγγλικά). στυλ και κατευθύνσεις easing με παράδειγμα σε UI
- Roblox Creator Docs: PVInstance:PivotTo (στα αγγλικά)
Πώς ελέγχθηκε ο κώδικας: κάθε script σε αυτή τη σελίδα περνά αυστηρό έλεγχο τύπων Luau με τους ορισμούς του Roblox API (luau-lsp, 20 Νοεμβρίου 2026). Ο έλεγχος τύπων πιάνει λάθη σε ονόματα API και λάθος τύπους, όχι όμως λάθη στη λογική του παιχνιδιού, γι' αυτό δοκιμάστε τα πάντα στο Studio πριν τη δημοσίευση.