Hướng dẫn · Cơ bản về scripting

TweenService trong Roblox: di chuyển, xoay và làm mờ part

Tween thay đổi một thuộc tính một cách mượt mà từ giá trị hiện tại tới giá trị đích trong khoảng thời gian bạn đặt: nền trượt đi, viên pha lê xoay tròn, bức tường mờ dần. TweenService tự tính các bước ở giữa, nên bạn không cần viết vòng lặp dịch part mỗi khung hình. Trong hướng dẫn này: ba dòng mà tween nào cũng cần, từng thiết lập của TweenInfo làm gì, di chuyển, xoay và làm mờ part, vòng lặp, chờ tween kết thúc và mẹo tween cả một model (Model).

Cập nhật ngày 20 tháng 11, 20266 phút đọcTác giả:

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
  1. Cách hoạt động
  2. 1. TweenInfo
  3. 2. Xoay và làm mờ
  4. 3. Vòng lặp
  5. 4. Model
  6. Server hay client
  7. Common errors
  8. Với RoCode
  9. Câu hỏi thường gặp
  10. Nguồn và tài liệu đọc thêm

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 trong một part trong Workspace tên là Rise
-- 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.

Thứ gì tween được và thứ gì không
KiểuTween mượt?Ví dụ
numberCóTransparency, Reflectance, Value của NumberValue
Vector3, CFrameCóPosition, Size, CFrame, Orientation
Color3CóColor
UDim2, Vector2CóSize và Position của GUI
boolean, EnumItemĐổi ở cuốiCanCollide, Material
string, InstanceKhôngGâ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.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
Giá trịMặc địnhTác dụng
time1Số giây cho một lần chạy.
easingStyleQuadDạ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.
easingDirectionOutOut bắt đầu nhanh rồi chậm dần; In bắt đầu chậm; InOut làm cả hai.
repeatCount0Số lần lặp lại sau lần chạy đầu tiên. -1 lặp mãi mãi.
reversesfalseQuay về điểm đầu sau mỗi lần chạy.
delayTime0Số giây chờ trước khi bắt đầu.
Script trong một part trong Workspace tên là Platform
-- 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 trong một part trong Workspace tên là FadingWall
-- 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 trong một part trong Workspace tên là FloatingGem
-- 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 trong một model trong Workspace tên là Elevator
-- 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 tween ở đâu
Chạy trongKhi nàoVí dụ
Script serverThay đổ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
LocalScriptChỉ 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.

Bạn gõ

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.

RoCode làm
  • 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

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.

Thử RoCode trong chính game của bạn.

Mỗi ngày có credit miễn phí, không cần thẻ. Cài plugin, mô tả tính năng và xem kết quả xuất hiện trong Studio.