Tóm tắt
Lấy service bằng game:GetService("TweenService"), mô tả chuyển động bằng TweenInfo.new(time, easingStyle, easingDirection), rồi gọi TweenService:Create(part, info, { Position = goal }) và chạy :Play() trên tween nhận được. Bạn có thể tween mọi thuộc tính kiểu number, Vector3, CFrame, Color3, UDim2 và các kiểu tương tự. Để chờ tween kết thúc, dùng tween.Completed:Wait(), còn để đi qua đi lại mãi mãi, đặt số lần lặp là -1 trong TweenInfo và bật reverses.
- Tween part trên server khi mọi người chơi đều cần thấy nó; trên client khi hiệu ứng chỉ dành cho người chơi đó.
- Bật Anchored cho các part bạn tween, nếu không vật lý sẽ cản tween.
- Model không có Position hay CFrame để tween: hãy tween một NumberValue và di chuyển model bằng
PivotTo.
Trong trang này
Ba dòng mà tween nào cũng cần
Chèn một Part vào Workspace, tích Anchored, rồi rê chuột lên nó, nhấn + và chèn một Script. Script này nâng part lên 10 stud trong 2 giây:
-- Script bên trong Part.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 giây, easing mặc định
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
Đích là một bảng gồm tên thuộc tính và giá trị mà chúng phải đạt tới khi kết thúc. Bạn có thể tween nhiều thuộc tính cùng lúc: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Tween bắt đầu từ các giá trị có tại thời điểm gọi Play, nên bạn chỉ cần đặt điểm cuối.
| Kiểu | Tween mượt? | Ví dụ |
|---|---|---|
| number | Có | Transparency, Reflectance, Value của NumberValue |
| Vector3, CFrame | Có | Position, Size, CFrame, Orientation |
| Color3 | Có | Color |
| UDim2, Vector2 | Có | Size và Position của GUI |
| boolean, EnumItem | Đổi ở cuối | CanCollide, Material |
| string, Instance | Không | Gây lỗi cannot be tweened due to type mismatch |
Bước 1: mọi thiết lập của TweenInfo
TweenInfo.new nhận tối đa sáu giá trị theo thứ tự này. Các giá trị cuối có thể bỏ qua.
| Giá trị | Mặc định | Tác dụng |
|---|---|---|
time | 1 | Số giây cho một lần chạy. |
easingStyle | Quad | Dạng chuyển động: Linear (tốc độ không đổi), Sine, Quad, Cubic, Back (vượt quá rồi quay lại), Bounce, Elastic, Exponential. |
easingDirection | Out | Out bắt đầu nhanh rồi chậm dần; In bắt đầu chậm; InOut làm cả hai. |
repeatCount | 0 | Số lần lặp lại sau lần chạy đầu tiên. -1 lặp mãi mãi. |
reverses | false | Quay về điểm đầu sau mỗi lần chạy. |
delayTime | 0 | Số giây chờ trước khi bắt đầu. |
-- Script bên trong Part tên Platform.
-- Đi qua đi lại 12 stud mãi mãi, mượt ở cả hai đầu.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- số giây mỗi chiều
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- lặp mãi mãi
true -- mỗi lần đều quay về
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Nếu nền phải chở người chơi đang đứng trên nó, hãy lưu ý: part anchored có tween di chuyển bên dưới họ nhưng không mang họ theo. Trường hợp này được giải thích trong hướng dẫn nền di chuyển.
Bước 2: xoay, đổi kích thước và làm mờ
Để xoay một part, hãy tween CFrame tới CFrame hiện tại nhân với một phép xoay. Tween Orientation cũng được, nhưng với CFrame thì part xoay tại chỗ. Ở đây, khi script chạy, bức tường xoay, sau đó mờ dần và thu nhỏ, rồi bị xóa khi tween kết thúc:
-- Script bên trong Part tên FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- xoay một phần tư vòng quanh trục đứng của nó trong 1 giây
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- chỉ tiếp tục khi đã xoay xong
-- sau đó đồng thời làm mờ và thu nhỏ
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 kích hoạt kèm một PlaybackState: Completed nếu tween đã tới đích, hoặc Cancelled nếu nó bị tween:Cancel() dừng lại. Đừng chờ Completed của một tween lặp mãi mãi: nó sẽ không bao giờ kết thúc.
Bước 3: vật thể lơ lửng và xoay tròn
Hai tween lặp trên hai thuộc tính khác nhau chạy cùng lúc. Tween một vòng đủ 360 độ bằng CFrame sẽ không làm gì, vì điểm đầu và điểm cuối là cùng một góc xoay, nên phần xoay tween một NumberValue từ 0 tới 360 và đặt CFrame theo nó. Đặt Script này vào một part anchored:
-- Script bên trong Part tên Gem. Lơ lửng lên xuống và xoay tròn mãi mãi.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- số stud cao hơn chỗ bạn đặt nó
local FLOAT_SECONDS = 1.2 -- mỗi chiều
local SPIN_SECONDS = 3 -- một vòng đầy đủ
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()
Phần xoay dùng easing Linear nên quay với tốc độ không đổi, và mỗi vòng bắt đầu lại từ 0, cũng là góc giống 360, nên không bị giật. Hướng dẫn nhặt xu đưa những vật thể như vậy vào game.
Bước 4: tween cả một model
Model không có thuộc tính Position hay CFrame, nên TweenService:Create(model, ...) không có gì để di chuyển. Thay vào đó, hãy tween một NumberValue từ 0 tới 1 và di chuyển model bằng PivotTo, hàm này dời mọi part bên trong nó cùng lúc:
-- Script bên trong Model tên Elevator.
-- Di chuyển cả model lên 20 stud rồi xuống lại, mọi part cùng nhau.
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()
Bật Anchored cho mọi part của model. Số 2 ở cuối TweenInfo là thời gian chờ trước mỗi lần chạy, nên thang máy dừng lại ở trên và ở dưới. Hướng dẫn làm cửa dùng cùng cách này để mở cửa gồm nhiều part.
Server hay client?
Tween chạy trong Script server thay đổi part trên server, và các giá trị mới được sao chép tới mọi người chơi, nên ai cũng thấy. Tween trong LocalScript chỉ thay đổi part trên màn hình của người chơi đó.
| Chạy trong | Khi nào | Ví dụ |
|---|---|---|
| Script server | Thay đổi quan trọng với game hoặc với mọi người. | Cửa, chướng ngại vật di chuyển, cây cầu mở ra |
| LocalScript | Chỉ người chơi này cần thấy, hoặc đó chỉ là hiệu ứng hình ảnh. | Vật phẩm mờ đi với người chơi đã nhặt nó, UI |
Việc sao chép gửi cập nhật nhiều lần mỗi giây, nên với hầu hết người chơi tween trên server trông mượt, nhưng tween server quá nhanh hoặc quá nhiều có thể kém mượt hơn khi kết nối chậm. Với lượng lớn chuyển động trang trí (hàng trăm đồng xu xoay), hãy chạy tween trong LocalScript trên từng client.
Lỗi thường gặp và cách sửa
Mở cửa sổ Output (menu Window, rồi Output) trước khi nhấn Play.
Part hoàn toàn không di chuyển
Kiểm tra bạn đã gọi :Play() trên tween, tên thuộc tính trong đích viết chính xác (Position, không phải position) và đó là một Script ở nơi script được chạy (bên trong part trong Workspace hoặc trong ServerScriptService).
Part rơi xuống hoặc rung trong khi tween
Part chưa anchored, nên trọng lực và va chạm cản tween. Hãy tích Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Giá trị đích sai kiểu, ví dụ một số cho thuộc tính kiểu Vector3. Xem trang lỗi (tiếng Anh).
Unable to cast to Dictionary hoặc Unable to cast value to Object
Các đối số sai thứ tự hoặc sai kiểu. Thứ tự luôn là Create(instance, tweenInfo, goalTable). Xem Unable to cast value to Object (tiếng Anh).
Làm với RoCode
Nếu bạn không muốn tự viết tween, RoCode có thể làm việc này trong place bạn đang mở. RoCode là AI agent độc lập cho Roblox Studio, không phải của Roblox: bạn mô tả thay đổi trong web chat, còn plugin cho Studio của nó tạo script trong Explorer của bạn, nên bạn không cần dán code.
Làm cho model cây cầu trong Workspace trượt sang một bên 15 stud khi vòng chơi bắt đầu, bằng tween NumberValue và PivotTo, đồng thời làm mờ các part chắn màu đỏ trong 1 giây.
- Có thể tìm các part và model cần thiết bằng Search Game trước khi viết gì
- Viết Script bằng Create Script, và nó được dặn kiểm tra biên dịch bằng Check Script
- Đặt điểm hoàn tác trước và sau mỗi nhóm thay đổi, nên Ctrl+Z lùi lại từng nhóm một
Với plugin 3.9 trở lên, RoCode có thể chạy một playtest ngắn và đọc lỗi, nhưng chuyển động thì dễ đánh giá nhất bằng mắt, nên hãy nhấn Play và xem. RoCode kết nối với Studio thế nào.
Câu hỏi thường gặp
Dùng TweenService trong Roblox thế nào?
Lấy service, tạo một TweenInfo, gọi TweenService:Create(object, info, { Property = goal }) và chạy :Play() trên kết quả. Phần đầu tiên có ví dụ ba dòng.
Làm sao cho tween lặp mãi mãi?
Truyền -1 làm giá trị thứ tư trong TweenInfo.new (repeatCount) và true làm giá trị thứ năm nếu nó phải đi qua đi lại.
Làm sao chờ tween kết thúc?
Gọi tween.Completed:Wait() sau tween:Play() hoặc kết nối một hàm với tween.Completed.
Có tween được Model không?
Không tween trực tiếp được. Hãy tween một NumberValue từ 0 tới 1 và mỗi lần nó thay đổi thì gọi model:PivotTo(start:Lerp(goal, value)), như ở bước 4.
Làm sao dừng tween?
Gọi tween:Cancel() để dừng nó và giữ part ở vị trí hiện tại, hoặc tween:Pause() để sau đó tiếp tục bằng Play().
Nguồn và tài liệu đọc thêm
- Roblox Creator Docs: TweenService (tiếng Anh). Create, những kiểu tween được và việc hủy
- Roblox Creator Docs: TweenInfo (tiếng Anh)
- Roblox Creator Docs: Tween (tiếng Anh). Play, Pause, Cancel và Completed
- Roblox Creator Docs: UI animation and tweens (tiếng Anh). các kiểu và hướng easing qua ví dụ UI
- Roblox Creator Docs: PVInstance:PivotTo (tiếng Anh)
Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.