Οδηγός · Βασικά του scripting

TweenService στο Roblox: κινούμε, περιστρέφουμε και κρύβουμε parts

Ένα tween αλλάζει ομαλά μια ιδιότητα από την τρέχουσα τιμή της ως τον στόχο μέσα σε ορισμένο χρόνο: μια πλατφόρμα γλιστράει, ένας κρύσταλλος περιστρέφεται, ένας τοίχος σβήνει. Το TweenService υπολογίζει μόνο του τα ενδιάμεσα βήματα, οπότε δεν χρειάζεται να γράψετε βρόχο που μετακινεί το part σε κάθε καρέ. Σε αυτόν τον οδηγό: οι τρεις γραμμές που χρειάζεται κάθε tween, τι κάνει κάθε ρύθμιση του TweenInfo, κίνηση, περιστροφή και εξαφάνιση parts, βρόχοι, αναμονή για το τέλος ενός tween και το κόλπο για tween ολόκληρου μοντέλου (Model).

Ενημερώθηκε 20 Νοεμβρίου 20266 λεπτά ανάγνωσηςΣυντάκτης:

Με λίγα λόγια

Πάρτε την υπηρεσία με 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.
Σε αυτή τη σελίδα
  1. Πώς λειτουργεί
  2. 1. TweenInfo
  3. 2. Περιστροφή και εξαφάνιση
  4. 3. Βρόχοι
  5. 4. Μοντέλα
  6. Server ή client
  7. Common errors
  8. Με το RoCode
  9. Συχνές ερωτήσεις
  10. Πηγές και περαιτέρω ανάγνωση

Οι τρεις γραμμές που χρειάζεται κάθε tween

Βάλτε ένα Part στο Workspace, τσεκάρετε το Anchored, μετά περάστε τον κέρσορα από πάνω του, πατήστε + και προσθέστε ένα Script. Αυτό το script ανεβάζει το part 10 studs σε 2 δευτερόλεπτα:

Script στο part στο Workspace με όνομα Rise
-- 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
ΤύποςΟμαλό 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 δέχεται έως έξι τιμές με αυτή τη σειρά. Τις τελευταίες μπορείτε να τις παραλείψετε.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
ΤιμήΠροεπιλογήΤι κάνει
time1Δευτερόλεπτα για μία αναπαραγωγή.
easingStyleQuadΜορφή της κίνησης: Linear (σταθερή ταχύτητα), Sine, Quad, Cubic, Back (με υπέρβαση), Bounce, Elastic, Exponential.
easingDirectionOutΤο Out ξεκινά γρήγορα και επιβραδύνει· το In ξεκινά αργά· το InOut κάνει και τα δύο.
repeatCount0Πόσες φορές επαναλαμβάνεται μετά την πρώτη αναπαραγωγή. Το -1 επαναλαμβάνει για πάντα.
reversesfalseΕπιστροφή στην αρχή μετά από κάθε αναπαραγωγή.
delayTime0Πόσα δευτερόλεπτα να περιμένει πριν ξεκινήσει.
Script στο part στο Workspace με όνομα Platform
-- 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 στο Workspace με όνομα FadingWall
-- 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 στο Workspace με όνομα FloatingGem
-- 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 στο μοντέλο στο Workspace με όνομα Elevator
-- 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 μόνο στην οθόνη αυτού του παίκτη.

Πού να τρέχει το tween
Τρέξτε το σεΠότεΠαράδειγμα
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 δευτερόλεπτο.

Το RoCode κάνει
  • Μπορεί να βρει τα σωστά 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().

Πηγές και περαιτέρω ανάγνωση

Πώς ελέγχθηκε ο κώδικας: κάθε script σε αυτή τη σελίδα περνά αυστηρό έλεγχο τύπων Luau με τους ορισμούς του Roblox API (luau-lsp, 20 Νοεμβρίου 2026). Ο έλεγχος τύπων πιάνει λάθη σε ονόματα API και λάθος τύπους, όχι όμως λάθη στη λογική του παιχνιδιού, γι' αυτό δοκιμάστε τα πάντα στο Studio πριν τη δημοσίευση.

Δοκιμάστε το RoCode στο παιχνίδι σας.

Δωρεάν credits κάθε μέρα, χωρίς κάρτα. Εγκαταστήστε το plugin, περιγράψτε μια λειτουργία και δείτε τι εμφανίζεται στο Studio.