Ringkasnya
Dapatkan servis melalui game:GetService("TweenService"), terangkan pergerakan dengan TweenInfo.new(time, easingStyle, easingDirection), kemudian panggil TweenService:Create(part, info, { Position = goal }) dan jalankan :Play() pada tween yang dihasilkan. Anda boleh tween sebarang sifat jenis number, Vector3, CFrame, Color3, UDim2 dan yang serupa. Untuk menunggu sehingga tamat, gunakan tween.Completed:Wait(), dan untuk gerakan pergi balik tanpa henti, tetapkan bilangan ulangan -1 dalam TweenInfo dan hidupkan reverses.
- Tween part pada pelayan apabila semua pemain perlu melihatnya; pada client apabila kesan itu hanya untuk pemain tersebut.
- Tandakan Anchored pada part yang anda tween, jika tidak fizik akan mengganggu tween.
- Model tiada Position atau CFrame untuk ditween: tween NumberValue dan gerakkan model melalui
PivotTo.
Di halaman ini
Tiga baris yang diperlukan oleh setiap tween
Masukkan Part ke dalam Workspace, tandakan Anchored, kemudian halakan tetikus padanya, tekan + dan masukkan Script. Skrip ini menaikkan part sebanyak 10 stud dalam 2 saat:
-- Script di dalam Part.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 saat, easing lalai
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
Sasaran ialah jadual nama sifat dan nilai yang patut dicapai di penghujungnya. Anda boleh tween beberapa sifat sekali gus: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Tween bermula daripada nilai yang ada ketika Play dipanggil, jadi anda hanya menetapkan penghujungnya.
| Jenis | Ditween dengan lancar? | Contoh |
|---|---|---|
| number | Ya | Transparency, Reflectance, Value pada NumberValue |
| Vector3, CFrame | Ya | Position, Size, CFrame, Orientation |
| Color3 | Ya | Color |
| UDim2, Vector2 | Ya | Size dan Position pada GUI |
| boolean, EnumItem | Bertukar di penghujung | CanCollide, Material |
| string, Instance | Tidak | Memberi ralat cannot be tweened due to type mismatch |
Langkah 1: semua tetapan TweenInfo
TweenInfo.new menerima sehingga enam nilai mengikut susunan ini. Nilai di hujung boleh ditinggalkan.
| Nilai | Lalai | Apa yang dibuat |
|---|---|---|
time | 1 | Saat untuk satu kali main. |
easingStyle | Quad | Bentuk gerakan: Linear (kelajuan tetap), Sine, Quad, Cubic, Back (terlajak sedikit), Bounce, Elastic, Exponential. |
easingDirection | Out | Out bermula laju dan menjadi perlahan; In bermula perlahan; InOut membuat kedua-duanya. |
repeatCount | 0 | Berapa kali diulang selepas main pertama. -1 mengulang tanpa henti. |
reverses | false | Kembali ke permulaan selepas setiap kali main. |
delayTime | 0 | Berapa saat menunggu sebelum bermula. |
-- Script di dalam Part bernama Platform.
-- Bergerak pergi balik sejauh 12 stud tanpa henti, lancar di kedua-dua hujung.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- saat bagi setiap arah
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- ulang tanpa henti
true -- kembali setiap kali
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Jika platform perlu membawa pemain yang berdiri di atasnya, ambil perhatian: part Anchored yang ditween bergerak di bawah mereka tetapi tidak membawa mereka bersama. Kes ini diterangkan dalam panduan platform bergerak.
Langkah 2: putaran, saiz dan pudar
Untuk memutar part, tween CFrame kepada CFrame semasa yang didarab dengan putaran. Tween Orientation juga berfungsi, tetapi dengan CFrame part berputar di tempatnya. Di sini dinding berputar apabila skrip bermula, kemudian pudar dan mengecil, dan dipadam selepas tween tamat:
-- Script di dalam Part bernama FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- putar suku pusingan pada paksi menegaknya sendiri dalam 1 saat
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- teruskan hanya apabila putaran sudah tamat
-- kemudian pudarkan dan kecilkan serentak
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 dicetuskan dengan PlaybackState: Completed jika tween sampai ke sasaran, atau Cancelled jika ia dihentikan oleh tween:Cancel(). Jangan tunggu Completed pada tween yang berulang tanpa henti: ia tidak akan tamat.
Langkah 3: objek terapung dan berputar
Dua tween bergelung pada sifat berbeza berjalan serentak. Tween satu pusingan penuh 360 darjah melalui CFrame tidak membuat apa-apa, kerana permulaan dan penghujung ialah putaran yang sama, jadi putaran ini tween NumberValue dari 0 hingga 360 dan menetapkan CFrame berdasarkannya. Letakkan Script ini dalam part Anchored:
-- Script di dalam Part bernama Gem. Terapung naik turun dan berputar tanpa henti.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- stud di atas tempat anda meletakkannya
local FLOAT_SECONDS = 1.2 -- bagi setiap arah
local SPIN_SECONDS = 3 -- satu pusingan penuh
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()
Putaran menggunakan easing Linear, jadi ia berputar pada kelajuan tetap, dan setiap kitaran bermula semula dari 0, iaitu sudut yang sama dengan 360, jadi tiada sentakan. Panduan mengutip syiling memasukkan objek seperti ini ke dalam permainan.
Langkah 4: tween seluruh model
Model tiada sifat Position atau CFrame, jadi TweenService:Create(model, ...) tiada apa untuk digerakkan. Sebaliknya, tween NumberValue dari 0 hingga 1 dan gerakkan model melalui PivotTo, yang mengalihkan semua part di dalamnya bersama-sama:
-- Script di dalam Model bernama Elevator.
-- Menggerakkan seluruh model 20 stud ke atas dan kembali, semua part bersama.
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()
Tandakan Anchored pada semua part model. Angka 2 di hujung TweenInfo ialah kelewatan sebelum setiap kali main, jadi lif berhenti seketika di atas dan di bawah. Panduan pintu membuka pintu yang terdiri daripada beberapa part dengan cara yang sama.
Pelayan atau client?
Tween yang dijalankan dalam Script pelayan menukar part pada pelayan, dan nilai baharu direplikasi kepada semua pemain, jadi semua orang melihatnya. Tween dalam LocalScript menukar part hanya pada skrin pemain tersebut.
| Jalankan dalam | Bila | Contoh |
|---|---|---|
| Script pelayan | Perubahan itu penting untuk permainan atau untuk semua orang. | Pintu, halangan bergerak, jambatan yang terbuka |
| LocalScript | Hanya pemain ini yang perlu melihatnya, atau ia kesan visual semata-mata. | Objek yang pudar bagi pemain yang mengambilnya, UI |
Replikasi menghantar kemas kini banyak kali sesaat, jadi tween pelayan kelihatan lancar bagi kebanyakan pemain, tetapi tween pelayan yang sangat laju atau sangat banyak boleh kelihatan kurang lancar pada sambungan yang perlahan. Untuk banyak gerakan hiasan (ratusan syiling berputar), jalankan tween dalam LocalScript pada setiap client.
Ralat biasa dan cara membaikinya
Buka tetingkap Output (menu Window, kemudian Output) sebelum menekan Play.
Part langsung tidak bergerak
Pastikan anda memanggil :Play() pada tween, nama sifat dalam sasaran dieja dengan tepat (Position, bukan position) dan ia ialah Script di tempat skrip dijalankan (di dalam part dalam Workspace atau dalam ServerScriptService).
Part jatuh atau bergegar semasa tween
Ia tidak Anchored, jadi graviti dan perlanggaran mengganggu tween. Tandakan Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Nilai sasaran bukan jenis yang betul, contohnya nombor untuk sifat jenis Vector3. Lihat halaman ralat (dalam bahasa Inggeris).
Unable to cast to Dictionary atau Unable to cast value to Object
Argumen tidak mengikut susunan atau bukan jenis yang betul. Susunannya sentiasa Create(instance, tweenInfo, goalTable). Lihat Unable to cast value to Object (dalam bahasa Inggeris).
Buat dengan RoCode
Jika anda tidak mahu menulis tween sendiri, RoCode boleh membinanya dalam place yang sedang anda buka. RoCode ialah ejen AI bebas untuk Roblox Studio, bukan daripada Roblox: anda terangkan perubahan dalam chat web, dan plugin Studionya mencipta skrip dalam Explorer anda, jadi anda tidak perlu menampal kod.
Buat model jambatan dalam Workspace bergerak 15 stud ke tepi apabila pusingan bermula, menggunakan tween NumberValue dan PivotTo, dan pada masa yang sama pudarkan part penghadang merah dalam 1 saat.
- Boleh mencari part dan model yang berkaitan melalui Search Game sebelum menulis apa-apa
- Menulis Script melalui Create Script, dan diarahkan untuk menyemak kompilasi melalui Check Script
- Meletakkan titik undo sebelum dan selepas setiap kumpulan perubahan, jadi Ctrl+Z membatalkan satu kumpulan pada satu masa
Dengan plugin 3.9 atau lebih baharu, RoCode boleh menjalankan playtest pendek dan membaca ralat, tetapi gerakan paling mudah dinilai dengan mata sendiri, jadi tekan Play dan lihat. Cara RoCode bersambung ke Studio.
Soalan lazim
Bagaimana menggunakan TweenService dalam Roblox?
Dapatkan servis, cipta TweenInfo, panggil TweenService:Create(object, info, { Property = goal }) dan jalankan :Play() pada hasilnya. Bahagian pertama ada contoh tiga baris.
Bagaimana membuat tween bergelung selama-lamanya?
Berikan -1 sebagai nilai keempat dalam TweenInfo.new (repeatCount) dan true sebagai nilai kelima jika ia perlu bergerak pergi balik.
Bagaimana menunggu tween tamat?
Panggil tween.Completed:Wait() selepas tween:Play() atau sambungkan fungsi kepada tween.Completed.
Bolehkah Model ditween?
Tidak secara terus. Tween NumberValue dari 0 hingga 1 dan pada setiap perubahan panggil model:PivotTo(start:Lerp(goal, value)), seperti dalam langkah 4.
Bagaimana menghentikan tween?
Panggil tween:Cancel() untuk menghentikannya dan membiarkan part di tempatnya, atau tween:Pause() untuk menyambungnya kemudian dengan Play().
Sumber dan bacaan lanjut
- Roblox Creator Docs: TweenService (dalam bahasa Inggeris). Create, jenis yang boleh ditween dan pembatalan
- Roblox Creator Docs: TweenInfo (dalam bahasa Inggeris)
- Roblox Creator Docs: Tween (dalam bahasa Inggeris). Play, Pause, Cancel dan Completed
- Roblox Creator Docs: UI animation and tweens (dalam bahasa Inggeris). gaya dan arah easing menggunakan contoh UI
- Roblox Creator Docs: PVInstance:PivotTo (dalam bahasa Inggeris)
Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.