Tutorial · Dasar scripting

Tutorial TweenService: gerakkan, putar dan pudarkan part

Tween mengubah sebuah properti secara mulus dari nilainya sekarang ke nilai tujuan dalam waktu tertentu: platform bergeser, permata berputar, dinding memudar. TweenService mengerjakan langkah-langkah di antaranya untukmu, jadi kamu tidak perlu menulis loop yang menggeser part setiap frame. Panduan ini membahas tiga baris yang dibutuhkan setiap tween, fungsi setiap pengaturan TweenInfo, menggerakkan, memutar dan memudarkan part, loop, menunggu tween selesai, dan trik untuk men-tween seluruh Model.

Diperbarui 12 November 20265 menit bacaDitulis oleh

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
  1. Cara kerjanya
  2. 1. TweenInfo
  3. 2. Putar dan pudarkan
  4. 3. Loop
  5. 4. Model
  6. Server atau client
  7. Error umum
  8. Dengan RoCode
  9. Pertanyaan umum
  10. Sumber dan bacaan lanjutan

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 Part di Workspace bernama Rise
-- 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.

Yang bisa dan tidak bisa di-tween
TipeBisa di-tween mulus?Contoh
numberYaTransparency, Reflectance, Value milik NumberValue
Vector3, CFrameYaPosition, Size, CFrame, Orientation
Color3YaColor
UDim2, Vector2YaSize dan Position GUI
boolean, EnumItemBerganti di akhirCanCollide, Material
string, InstanceTidakMenghasilkan 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.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
NilaiDefaultFungsinya
time1Detik untuk satu kali putar.
easingStyleQuadBentuk gerakannya: Linear (kecepatan konstan), Sine, Quad, Cubic, Back (melewati sedikit), Bounce, Elastic, Exponential.
easingDirectionOutOut mulai cepat lalu melambat; In mulai pelan; InOut melakukan keduanya.
repeatCount0Putaran tambahan setelah yang pertama. -1 mengulang selamanya.
reversesfalseKembali ke awal setelah setiap putaran.
delayTime0Detik menunggu sebelum mulai.
Script di Part di Workspace bernama Platform
-- 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 Part di Workspace bernama FadingWall
-- 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 Part di Workspace bernama FloatingGem
-- 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 Model di Workspace bernama Elevator
-- 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.

Di mana menjalankan tween
Jalankan diKapanContoh
Script serverPerubahannya penting untuk game atau untuk semua orang.Pintu, rintangan yang bergerak, jembatan yang terbuka
LocalScriptHanya 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.

Kamu ketik

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.

RoCode mengerjakan
  • 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

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.

Coba RoCode di game kamu sendiri.

Kredit gratis setiap hari, tanpa kartu. Pasang plugin-nya, jelaskan fiturnya, lalu cek hasilnya di Studio.