Tutorial · Asas skrip

TweenService Roblox: gerak, putar dan hilangkan part

Tween menukar sesuatu sifat dengan lancar daripada nilai semasa kepada sasaran dalam masa yang ditetapkan: platform menggelongsor, kristal berputar, dinding pudar. TweenService mengira sendiri langkah perantaraan, jadi anda tidak perlu menulis gelung yang menggerakkan part setiap bingkai. Dalam panduan ini: tiga baris yang diperlukan oleh setiap tween, apa yang dibuat oleh setiap tetapan TweenInfo, menggerak, memutar dan memudarkan part, gelung, menunggu tween tamat dan cara untuk tween seluruh model (Model).

Dikemas kini 20 November 20265 minit bacaanDitulis oleh

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
  1. Cara ia berfungsi
  2. 1. TweenInfo
  3. 2. Putaran dan pudar
  4. 3. Gelung
  5. 4. Model
  6. Pelayan atau client
  7. Common errors
  8. Dengan RoCode
  9. Soalan lazim
  10. Sumber dan bacaan lanjut

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 dalam part dalam Workspace bernama Rise
-- 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.

Apa yang boleh dan tidak boleh ditween
JenisDitween dengan lancar?Contoh
numberYaTransparency, Reflectance, Value pada NumberValue
Vector3, CFrameYaPosition, Size, CFrame, Orientation
Color3YaColor
UDim2, Vector2YaSize dan Position pada GUI
boolean, EnumItemBertukar di penghujungCanCollide, Material
string, InstanceTidakMemberi 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.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
NilaiLalaiApa yang dibuat
time1Saat untuk satu kali main.
easingStyleQuadBentuk gerakan: Linear (kelajuan tetap), Sine, Quad, Cubic, Back (terlajak sedikit), Bounce, Elastic, Exponential.
easingDirectionOutOut bermula laju dan menjadi perlahan; In bermula perlahan; InOut membuat kedua-duanya.
repeatCount0Berapa kali diulang selepas main pertama. -1 mengulang tanpa henti.
reversesfalseKembali ke permulaan selepas setiap kali main.
delayTime0Berapa saat menunggu sebelum bermula.
Script dalam part dalam Workspace bernama Platform
-- 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 dalam part dalam Workspace bernama FadingWall
-- 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 dalam part dalam Workspace bernama FloatingGem
-- 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 dalam model dalam Workspace bernama Elevator
-- 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.

Di mana untuk menjalankan tween
Jalankan dalamBilaContoh
Script pelayanPerubahan itu penting untuk permainan atau untuk semua orang.Pintu, halangan bergerak, jambatan yang terbuka
LocalScriptHanya 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.

Anda tulis

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.

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

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.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.