Singkatnya
Ambil service-nya dengan game:GetService("TweenService"), jelaskan gerakannya dengan TweenInfo.new(time, easingStyle, easingDirection), lalu panggil TweenService:Create(part, info, { Position = goal }) dan :Play() tween yang dikembalikannya. Properti apa pun bertipe number, Vector3, CFrame, Color3, UDim2 atau sejenisnya bisa di-tween. Pakai tween.Completed:Wait() untuk menunggunya, dan beri TweenInfo jumlah ulang -1 dengan reverses menyala untuk loop bolak-balik.
- Tween part di server kalau setiap pemain harus melihatnya; di client untuk efek yang hanya dibutuhkan pemain itu.
- Anchor part yang kamu tween, kalau tidak fisika akan melawan tween-nya.
- Model tidak punya Position atau CFrame untuk di-tween: tween sebuah NumberValue dan gerakkan model-nya dengan
PivotTo.
Di halaman ini
Tiga baris yang dibutuhkan setiap tween
Sisipkan Part di Workspace, centang Anchored, lalu arahkan kursor ke part itu, klik + dan sisipkan Script. Script ini menggerakkan part 10 stud ke atas dalam 2 detik:
-- Script di dalam Part.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 detik, easing default
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
Goal adalah table berisi nama properti dan nilai akhirnya. Kamu bisa men-tween beberapa properti sekaligus: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Tween mulai dari nilai apa pun yang ada saat kamu memanggil Play, jadi kamu cukup memberikan nilai akhirnya.
| Tipe | Bisa di-tween mulus? | Contoh |
|---|---|---|
| number | Ya | Transparency, Reflectance, Value milik NumberValue |
| Vector3, CFrame | Ya | Position, Size, CFrame, Orientation |
| Color3 | Ya | Color |
| UDim2, Vector2 | Ya | Size dan Position GUI |
| boolean, EnumItem | Berganti di akhir | CanCollide, Material |
| string, Instance | Tidak | Menghasilkan error cannot be tweened due to type mismatch |
Langkah 1: Semua pengaturan TweenInfo
TweenInfo.new menerima sampai enam nilai, dengan urutan ini. Kamu boleh tidak mengisi nilai-nilai di bagian akhir.
| Nilai | Default | Fungsinya |
|---|---|---|
time | 1 | Detik untuk satu kali putar. |
easingStyle | Quad | Bentuk gerakannya: Linear (kecepatan konstan), Sine, Quad, Cubic, Back (melewati sedikit), Bounce, Elastic, Exponential. |
easingDirection | Out | Out mulai cepat lalu melambat; In mulai pelan; InOut melakukan keduanya. |
repeatCount | 0 | Putaran tambahan setelah yang pertama. -1 mengulang selamanya. |
reverses | false | Kembali ke awal setelah setiap putaran. |
delayTime | 0 | Detik menunggu sebelum mulai. |
-- Script di dalam Part bernama Platform.
-- Bergeser bolak-balik 12 stud selamanya, dengan easing di kedua ujung.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- detik untuk setiap arah
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- ulang selamanya
true -- kembali setiap kali
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Untuk platform yang harus membawa pemain yang berdiri di atasnya, part anchored yang di-tween bergerak di bawah mereka tapi tidak membawa mereka ikut. Panduan moving platform (dalam bahasa Inggris) membahas kasus itu.
Langkah 2: Putar, ubah ukuran dan pudarkan
Untuk memutar, tween CFrame ke CFrame saat ini dikali sebuah rotasi. Men-tween Orientation juga bisa, tapi CFrame menjaga part tetap di tempatnya selagi berputar. Di sini sebuah dinding memudar dan mengecil saat script berjalan, lalu dihapus setelah tween-nya selesai:
-- Script di dalam Part bernama FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- putar seperempat putaran di sumbu atas part itu sendiri dalam 1 detik
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- lanjut hanya setelah tween-nya selesai
-- lalu pudarkan dan kecilkan pada saat yang sama
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 terjadi dengan sebuah PlaybackState: Completed kalau tween sampai ke tujuannya, atau Cancelled kalau tween:Cancel() menghentikannya. Jangan menunggu Completed pada tween yang mengulang selamanya: tween itu tidak pernah selesai.
Langkah 3: Pickup yang melayang dan berputar
Dua tween berulang pada properti yang berbeda berjalan berdampingan. Men-tween 360 derajat penuh dengan CFrame tidak berbuat apa-apa, karena awal dan akhirnya adalah rotasi yang sama, jadi putarannya men-tween sebuah NumberValue dari 0 sampai 360 dan mengatur CFrame dari nilai itu. Taruh Script ini di dalam part yang di-anchor:
-- Script di dalam Part bernama Gem. Melayang naik turun dan berputar selamanya.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- stud di atas tempat kamu menaruhnya
local FLOAT_SECONDS = 1.2 -- untuk setiap arah
local SPIN_SECONDS = 3 -- satu putaran 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()
Putarannya memakai easing Linear supaya berputar dengan kecepatan tetap, dan mulai lagi dari 0 di setiap loop, yang merupakan sudut yang sama dengan 360, jadi tidak ada lompatan. Panduan coin collect (dalam bahasa Inggris) memasukkan pickup seperti ini ke dalam game.
Langkah 4: Tween seluruh Model
Model tidak punya properti Position atau CFrame, jadi TweenService:Create(model, ...) tidak punya apa pun untuk digerakkan. Sebagai gantinya, tween sebuah NumberValue dari 0 sampai 1 dan gerakkan model dengan PivotTo, yang menggerakkan setiap part di dalamnya bersama-sama:
-- Script di dalam Model bernama Elevator.
-- Menggerakkan seluruh model 20 stud ke atas dan kembali, semua part bersama-sama.
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()
Anchor setiap part di model itu. Angka 2 di akhir TweenInfo adalah jeda sebelum setiap putaran, jadi elevator menunggu di atas dan di bawah. Panduan pintu memakai pola yang sama untuk mengayunkan pintu yang terdiri dari beberapa part.
Server atau client?
Tween yang dijalankan di Script server mengubah part di server, dan nilai barunya direplikasi ke setiap pemain, jadi semua orang melihatnya. Tween di LocalScript mengubah part hanya di layar pemain itu.
| Jalankan di | Kapan | Contoh |
|---|---|---|
| Script server | Perubahannya penting untuk game atau untuk semua orang. | Pintu, rintangan yang bergerak, jembatan yang terbuka |
| LocalScript | Hanya pemain ini yang perlu melihatnya, atau murni efek visual. | Pickup yang memudar untuk pemain yang mengambilnya, UI |
Replikasi mengirim update berkali-kali per detik, jadi tween server terlihat mulus bagi kebanyakan pemain, tapi tween server yang sangat cepat atau sangat banyak bisa terlihat kurang mulus di koneksi lambat. Untuk banyak gerakan dekoratif (ratusan coin yang berputar), jalankan tween-nya di LocalScript di setiap client.
Error umum dan cara memperbaikinya
Buka jendela Output (menu Window, lalu Output) sebelum kamu menekan Play.
Part-nya sama sekali tidak bergerak
Cek bahwa kamu memanggil :Play() pada tween-nya, bahwa nama properti tujuannya dieja persis (Position, bukan position), dan bahwa script-nya adalah Script di tempat script berjalan (di dalam part di Workspace, atau ServerScriptService).
Part-nya jatuh atau bergetar selama tween
Part-nya tidak di-anchor, jadi gravitasi dan tabrakan melawan tween-nya. Centang Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Nilai tujuannya bertipe salah, misalnya number untuk properti Vector3. Lihat halaman error-nya (dalam bahasa Inggris).
Unable to cast to Dictionary atau Unable to cast value to Object
Argumennya salah urutan atau salah tipe. Urutannya selalu Create(instance, tweenInfo, goalTable). Lihat Unable to cast value to Object (dalam bahasa Inggris).
Buat dengan RoCode
Kalau kamu tidak mau menulis tween secara manual, RoCode bisa membuatnya di place yang sedang kamu buka. RoCode adalah agen AI independen untuk Roblox Studio, bukan buatan Roblox: kamu menjelaskan perubahannya di web chat, dan plugin Studio-nya membuat script di Explorer kamu, jadi tidak ada kode yang perlu ditempel.
Buat model jembatan di Workspace bergeser 15 stud ke samping saat ronde dimulai, memakai tween NumberValue dan PivotTo, dan pudarkan part pembatas merah dalam 1 detik pada saat yang sama.
- Bisa menemukan part dan model yang kamu maksud dengan Search Game sebelum menulis apa pun
- Menulis Script dengan Create Script dan diperintahkan untuk mengecek compile-nya dengan Check Script
- Memasang titik undo sebelum dan sesudah setiap batch perubahan, jadi Ctrl+Z mundur satu batch setiap kali
Dengan plugin 3.9 atau lebih baru RoCode bisa menjalankan playtest singkat dan membaca error-nya, tapi gerakan paling mudah dinilai dengan mata sendiri, jadi tekan Play dan lihat hasilnya. Cara RoCode tersambung ke Studio.
Pertanyaan umum
Bagaimana cara memakai TweenService di Roblox?
Ambil service-nya, buat TweenInfo, panggil TweenService:Create(object, info, { Property = goal }) dan :Play() hasilnya. Bagian pertama berisi contoh tiga baris.
Bagaimana cara membuat tween berulang selamanya?
Berikan -1 sebagai nilai keempat TweenInfo.new (repeatCount), dan true sebagai nilai kelima kalau tween harus bolak-balik.
Bagaimana cara menunggu tween selesai?
Panggil tween.Completed:Wait() setelah tween:Play(), atau sambungkan function ke tween.Completed.
Bisakah aku men-tween Model?
Tidak secara langsung. Tween sebuah NumberValue dari 0 sampai 1 dan panggil model:PivotTo(start:Lerp(goal, value)) saat nilainya berubah, seperti di Langkah 4.
Bagaimana cara menghentikan tween?
Panggil tween:Cancel() untuk berhenti dan membiarkan part di posisinya, atau tween:Pause() untuk melanjutkannya nanti dengan Play().
Sumber dan bacaan lanjutan
- Roblox Creator Docs: TweenService (dalam bahasa Inggris). Create, tipe yang bisa di-tween dan pembatalan
- Roblox Creator Docs: TweenInfo (dalam bahasa Inggris)
- Roblox Creator Docs: Tween (dalam bahasa Inggris). Play, Pause, Cancel dan Completed
- Roblox Creator Docs: UI animation and tweens (dalam bahasa Inggris). easing style dan direction, diperlihatkan pada UI
- Roblox Creator Docs: PVInstance:PivotTo (dalam bahasa Inggris)
Cara kode ini dicek: setiap skrip di halaman ini lolos pemeriksa tipe strict Luau dengan definisi API Roblox (luau-lsp, 12 November 2026). Pemeriksaan tipe menangkap nama API yang salah ketik dan tipe yang keliru, bukan logika game, jadi uji dulu di Studio sebelum dipublikasikan.