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
PivotToile hareket ettir.
Bu sayfada
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:
-- 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.
| Tür | Yumuşak tween olur mu? | Örnekler |
|---|---|---|
| number | Evet | Transparency, Reflectance, NumberValue'nun Value'su |
| Vector3, CFrame | Evet | Position, Size, CFrame, Orientation |
| Color3 | Evet | Color |
| UDim2, Vector2 | Evet | GUI'nin Size ve Position'ı |
| boolean, EnumItem | Sonunda değişir | CanCollide, Material |
| string, Instance | Hayır | cannot 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.
| Değer | Varsayılan | Ne yapar |
|---|---|---|
time | 1 | Bir oynatmanın saniyesi. |
easingStyle | Quad | Hareketin şekli: Linear (sabit hız), Sine, Quad, Cubic, Back (hedefi aşarak), Bounce, Elastic, Exponential. |
easingDirection | Out | Out hızlı başlar ve yavaşlar; In yavaş başlar; InOut ikisini de yapar. |
repeatCount | 0 | İlk oynatmadan sonra kaç kez tekrarlanacağı. -1 sonsuza kadar tekrarlar. |
reverses | false | Her oynatmadan sonra başa dönmek. |
delayTime | 0 | Başlamadan önce kaç saniye bekleneceği. |
-- 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:
-- 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:
-- 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:
-- 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.
| Şurada başlat | Ne zaman | Örnek |
|---|---|---|
| Sunucu Script'i | Değişiklik oyun ya da herkes için önemli. | Kapılar, hareketli engeller, açılan bir köprü |
| LocalScript | Bunu 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.
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.
- 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
- Roblox Creator Docs: TweenService (İngilizce). Create, hangi türlerin tween'i yapılır ve iptal
- Roblox Creator Docs: TweenInfo (İngilizce)
- Roblox Creator Docs: Tween (İngilizce). Play, Pause, Cancel ve Completed
- Roblox Creator Docs: UI animation and tweens (İngilizce). UI örneğiyle easing stilleri ve yönleri
- Roblox Creator Docs: PVInstance:PivotTo (İngilizce)
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.