Eğitim · Script temelleri

Roblox TweenService: part'ları hareket ettir, döndür ve soldur

Bir tween bir özelliği şu anki değerinden hedefe belirli bir sürede yumuşakça değiştirir: platform kayar, kristal döner, duvar solar. Ara adımları TweenService kendisi hesaplar, yani part'ı her karede kaydıran bir döngü yazman gerekmez. Bu rehberde: her tween'in ihtiyaç duyduğu üç satır, TweenInfo'nun her ayarının ne yaptığı, part'ları hareket ettirmek, döndürmek ve soldurmak, döngüler, bir tween'in bitmesini beklemek ve bütün bir modelin (Model) tween'i için bir yöntem.

Güncellendi: 20 Kasım 20265 dk okumaYazan:

Kısaca

Servisi game:GetService("TweenService") ile al, hareketi TweenInfo.new(time, easingStyle, easingDirection) ile tanımla, sonra TweenService:Create(part, info, { Position = goal })'u çağır ve dönen tween'de :Play()'i çalıştır. number, Vector3, CFrame, Color3, UDim2 ve benzeri türdeki her özelliğin tween'ini yapabilirsin. Bitişi beklemek için tween.Completed:Wait() kullan, sonsuz ileri geri hareket için de TweenInfo'da tekrar sayısını -1 yap ve reverses'i aç.

  • Part'ı tüm oyuncuların görmesi gerekiyorsa tween'i sunucuda yap; efekt sadece o oyuncu içinse client'ta.
  • Tween yaptığın part'ları Anchored yap, yoksa fizik tween'e karışır.
  • Model'in tween yapılacak bir Position'ı ya da CFrame'i yok: bir NumberValue'nun tween'ini yap ve modeli PivotTo ile hareket ettir.
Bu sayfada
  1. Nasıl çalışır
  2. 1. TweenInfo
  3. 2. Döndürme ve soldurma
  4. 3. Döngüler
  5. 4. Modeller
  6. Sunucu ya da client
  7. Common errors
  8. RoCode ile
  9. Sık sorulan sorular
  10. Kaynaklar ve ek okumalar

Her tween'in ihtiyaç duyduğu üç satır

Workspace'e bir Part ekle, Anchored'ı işaretle, sonra fareyle üzerine gel, +'ya tıkla ve bir Script ekle. Bu script part'ı 2 saniyede 10 stud yukarı kaldırır:

Script konum: Workspace'teki bir part'ın içi adı: Rise
-- Bir Part'ın içindeki Script.
local TweenService = game:GetService("TweenService")

local part = script.Parent :: BasePart

local info = TweenInfo.new(2) -- 2 saniye, varsayılan easing
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }

local tween = TweenService:Create(part, info, goal)
tween:Play()

Hedef, özellik adlarından ve onların varacağı değerlerden oluşan bir tablodur. Birkaç özelliğin tween'ini aynı anda yapabilirsin: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Tween Play çağrıldığı andaki değerlerden başlar, yani her zaman sadece sonu belirlersin.

Neyin tween'i yapılır, neyin yapılmaz
TürYumuşak tween olur mu?Örnekler
numberEvetTransparency, Reflectance, NumberValue'nun Value'su
Vector3, CFrameEvetPosition, Size, CFrame, Orientation
Color3EvetColor
UDim2, Vector2EvetGUI'nin Size ve Position'ı
boolean, EnumItemSonunda değişirCanCollide, Material
string, InstanceHayırcannot be tweened due to type mismatch hatası verir

Adım 1: TweenInfo'nun tüm ayarları

TweenInfo.new bu sırayla altı değere kadar alır. Sondakileri yazmayabilirsin.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
DeğerVarsayılanNe yapar
time1Bir oynatmanın saniyesi.
easingStyleQuadHareketin şekli: Linear (sabit hız), Sine, Quad, Cubic, Back (hedefi aşarak), Bounce, Elastic, Exponential.
easingDirectionOutOut hızlı başlar ve yavaşlar; In yavaş başlar; InOut ikisini de yapar.
repeatCount0İlk oynatmadan sonra kaç kez tekrarlanacağı. -1 sonsuza kadar tekrarlar.
reversesfalseHer oynatmadan sonra başa dönmek.
delayTime0Başlamadan önce kaç saniye bekleneceği.
Script konum: Workspace'teki bir part'ın içi adı: Platform
-- Platform adlı bir Part'ın içindeki Script.
-- 12 stud ileri geri sonsuza kadar gider, iki uçta da yumuşakça.
local TweenService = game:GetService("TweenService")

local platform = script.Parent :: BasePart

local info = TweenInfo.new(
	3, -- her yön için saniye
	Enum.EasingStyle.Sine,
	Enum.EasingDirection.InOut,
	-1, -- sonsuza kadar tekrarla
	true -- her seferinde geri dön
)

TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()

Platformun üstünde duran oyuncuları taşıması gerekiyorsa şunu bil: tween yapılan anchored bir part onların altında hareket eder ama onları beraberinde götürmez. Bu durum hareketli platform rehberinde anlatılıyor.

Adım 2: döndürme, boyut ve soldurma

Bir part'ı döndürmek için CFrame'in tween'ini, şu anki CFrame'in bir dönüşle çarpımına doğru yap. Orientation tween'i de çalışır ama CFrame ile part yerinde döner. Burada duvar script çalışınca döner, sonra solar ve küçülür, tween bitince de silinir:

Script konum: Workspace'teki bir part'ın içi adı: FadingWall
-- FadingWall adlı bir Part'ın içindeki Script.
local TweenService = game:GetService("TweenService")

local wall = script.Parent :: BasePart

-- 1 saniyede kendi dikey ekseni etrafında çeyrek tur dönüş
local turn = TweenService:Create(wall, TweenInfo.new(1), {
	CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- sadece dönüş bitince devam et

-- sonra aynı anda soldur ve küçült
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 bir PlaybackState ile tetiklenir: tween hedefe ulaştıysa Completed, tween:Cancel() onu durdurduysa Cancelled. Sonsuza kadar tekrarlanan bir tween'in Completed'ını bekleme: o asla bitmez.

Adım 3: süzülen ve dönen bir eşya

Farklı özelliklerdeki iki döngülü tween aynı anda çalışır. CFrame ile 360 derecelik tam bir turun tween'i hiçbir şey yapmaz, çünkü başlangıç ve bitiş aynı dönüştür; bu yüzden dönüş bir NumberValue'yu 0'dan 360'a tween'ler ve CFrame'i ona göre ayarlar. Bu Script'i anchored bir part'ın içine koy:

Script konum: Workspace'teki bir part'ın içi adı: FloatingGem
-- Gem adlı bir Part'ın içindeki Script. Sonsuza kadar aşağı yukarı süzülür ve döner.
local TweenService = game:GetService("TweenService")

local FLOAT_HEIGHT = 1.5 -- onu koyduğun yerden kaç stud yukarı
local FLOAT_SECONDS = 1.2 -- her yön için
local SPIN_SECONDS = 3 -- bir tam tur

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()

Dönüş Linear easing kullanır, bu yüzden sabit hızla döner ve her döngü yeniden 0'dan başlar; bu da 360 ile aynı açı, yani sıçrama olmaz. Coin toplama rehberi bu tür eşyaları oyuna yerleştiriyor.

Adım 4: bütün bir modelin tween'i

Model'in Position ya da CFrame özelliği yok, bu yüzden TweenService:Create(model, ...)'un hareket ettirecek bir şeyi yok. Onun yerine bir NumberValue'yu 0'dan 1'e tween'le ve modeli içindeki tüm part'ları birlikte taşıyan PivotTo ile hareket ettir:

Script konum: Workspace'teki bir modelin içi adı: Elevator
-- Elevator adlı bir Model'in içindeki Script.
-- Tüm modeli 20 stud yukarı ve geri götürür, tüm part'lar birlikte.
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()

Modelin tüm part'larını Anchored yap. TweenInfo'nun sonundaki 2 her oynatmadan önceki gecikmedir, bu yüzden asansör yukarıda ve aşağıda bekler. Kapı rehberi birden çok part'tan oluşan kapıları aynı yöntemle açıyor.

Sunucu mu, client mı?

Bir sunucu Script'inde başlatılan tween part'ı sunucuda değiştirir ve yeni değerler tüm oyunculara replicate edilir, yani herkes görür. Bir LocalScript'teki tween part'ı sadece o oyuncunun ekranında değiştirir.

Tween nerede başlatılır
Şurada başlatNe zamanÖrnek
Sunucu Script'iDeğişiklik oyun ya da herkes için önemli.Kapılar, hareketli engeller, açılan bir köprü
LocalScriptBunu sadece o oyuncu görmeli ya da tamamen görsel bir efekt.Onu alan oyuncu için solan bir eşya, UI

Replication güncellemeleri saniyede birçok kez gönderir, bu yüzden sunucu tween'leri çoğu oyuncuya yumuşak görünür, ama çok hızlı ya da çok sayıda sunucu tween'i yavaş bir bağlantıda daha az yumuşak görünebilir. Çok sayıda dekoratif hareket için (yüzlerce dönen coin) tween'leri her client'ta bir LocalScript'te çalıştır.

Sık yapılan hatalar ve çözümleri

Play'e basmadan önce Output penceresini aç (Window menüsü, sonra Output).

Part hiç hareket etmiyor

Tween'de :Play()'i çağırdığını, hedefteki özellik adının tam doğru yazıldığını (position değil Position) ve bunun scriptlerin çalıştığı bir yerde bir Script olduğunu (Workspace'teki bir part'ın içinde ya da ServerScriptService'te) kontrol et.

Part tween sırasında düşüyor ya da titriyor

Anchored değil, bu yüzden yerçekimi ve çarpışmalar tween'e karışıyor. Anchored'ı işaretle.

TweenService:Create property cannot be tweened due to type mismatch

Hedef değer yanlış türde, örneğin Vector3 türündeki bir özellik için bir sayı. Hata sayfasına bak (İngilizce).

Unable to cast to Dictionary ya da Unable to cast value to Object

Argümanlar yanlış sırada ya da yanlış türde. Sıra her zaman Create(instance, tweenInfo, goalTable). Unable to cast value to Object sayfasına bak (İngilizce).

RoCode ile yap

Tween'leri elle yazmak istemiyorsan RoCode onları açık olan place'inde kurabilir. RoCode Roblox Studio için bağımsız bir yapay zeka ajanı, Roblox'un değil: değişikliği bir web chat'inde anlatırsın, Studio plugin'i de scriptleri Explorer'ında oluşturur, yani kod yapıştırman gerekmez.

Sen yazarsın

Workspace'teki köprü modeli raund başlayınca bir NumberValue tween'i ve PivotTo ile 15 stud yana kaysın, aynı anda kırmızı bariyer part'ları da 1 saniyede solsun.

RoCode yapar
  • Bir şey yazmadan önce gereken part'ları ve modelleri Search Game ile bulabilir
  • Script'i Create Script ile yazar ve derlendiğini Check Script ile kontrol etmesi söylenmiştir
  • Her değişiklik grubundan önce ve sonra bir geri alma noktası koyar, böylece Ctrl+Z her seferinde bir grubu geri alır

Plugin 3.9 ya da üstüyle RoCode kısa bir test yapıp hataları okuyabilir, ama hareketi en kolay kendi gözünle değerlendirirsin, o yüzden Play'e bas ve izle. RoCode Studio'ya nasıl bağlanır.

Sık sorulan sorular

Roblox'ta TweenService nasıl kullanılır?

Servisi al, bir TweenInfo oluştur, TweenService:Create(object, info, { Property = goal })'u çağır ve sonuçta :Play()'i çalıştır. İlk bölümde üç satırlık bir örnek var.

Bir tween sonsuza kadar nasıl döngüye alınır?

TweenInfo.new'a dördüncü değer olarak -1 (repeatCount), ileri geri gitmesi gerekiyorsa beşinci değer olarak da true ver.

Bir tween'in bitmesini nasıl beklerim?

tween:Play()'den sonra tween.Completed:Wait()'i çağır ya da tween.Completed'a bir fonksiyon bağla.

Bir Model'in tween'i yapılabilir mi?

Doğrudan hayır. Bir NumberValue'yu 0'dan 1'e tween'le ve her değişimde model:PivotTo(start:Lerp(goal, value))'u çağır, 4. adımdaki gibi.

Bir tween nasıl durdurulur?

Onu durdurup part'ı olduğu yerde bırakmak için tween:Cancel()'ı, sonra Play() ile devam etmek için de tween:Pause()'u çağır.

Kaynaklar ve ek okumalar

Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.