Ve zkratce
Získejte službu přes game:GetService("TweenService"), popište pohyb přes TweenInfo.new(time, easingStyle, easingDirection), pak zavolejte TweenService:Create(part, info, { Position = goal }) a u získaného tweenu spusťte :Play(). Tweenovat lze jakoukoli vlastnost typu number, Vector3, CFrame, Color3, UDim2 a podobných. Na konec počkáte přes tween.Completed:Wait() a pro pohyb tam a zpět donekonečna nastavte v TweenInfo počet opakování -1 a zapněte reverses.
- Tweenujte part na serveru, když ho mají vidět všichni hráči; na klientovi, když je efekt potřeba jen pro tohoto hráče.
- Party, které tweenujete, ukotvěte (Anchored), jinak bude tweenu překážet fyzika.
- Model nemá Position ani CFrame k tweenování: tweenujte NumberValue a model posouvejte přes
PivotTo.
Na této stránce
Tři řádky, které potřebuje každý tween
Vložte Part do Workspace, zaškrtněte Anchored, pak na něj najeďte, klikněte na + a vložte Script. Tento skript zvedne part o 10 studů za 2 sekundy:
-- Script uvnitř Partu.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 sekundy, výchozí easing
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
Cíl je tabulka názvů vlastností a hodnot, na kterých mají skončit. Tweenovat lze několik vlastností naráz: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Tween začíná od hodnot, které platí ve chvíli volání Play, takže vždy zadáváte jen konec.
| Typ | Tweenuje se plynule? | Příklady |
|---|---|---|
| number | Ano | Transparency, Reflectance, Value u NumberValue |
| Vector3, CFrame | Ano | Position, Size, CFrame, Orientation |
| Color3 | Ano | Color |
| UDim2, Vector2 | Ano | Size a Position u GUI |
| boolean, EnumItem | Přepne se na konci | CanCollide, Material |
| string, Instance | Ne | Vyhodí chybu cannot be tweened due to type mismatch |
Krok 1: všechna nastavení TweenInfo
TweenInfo.new přijímá až šest hodnot v tomto pořadí. Poslední z nich lze vynechat.
| Hodnota | Výchozí | Co dělá |
|---|---|---|
time | 1 | Sekundy na jedno přehrání. |
easingStyle | Quad | Tvar pohybu: Linear (stálá rychlost), Sine, Quad, Cubic, Back (s přestřelením), Bounce, Elastic, Exponential. |
easingDirection | Out | Out začne rychle a zpomalí; In začne pomalu; InOut dělá obojí. |
repeatCount | 0 | Kolikrát opakovat po prvním přehrání. -1 opakuje donekonečna. |
reverses | false | Vracet se na začátek po každém přehrání. |
delayTime | 0 | Kolik sekund čekat před startem. |
-- Script uvnitř Partu s názvem Platform.
-- Donekonečna jezdí tam a zpět o 12 studů, plynule na obou koncích.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- sekundy na každou stranu
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- opakovat donekonečna
true -- pokaždé se vrátit
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Pokud má plošina vozit hráče, kteří na ní stojí, počítejte s tím, že ukotvený part s tweenem se pod nimi pohybuje, ale neveze je s sebou. Tento případ rozebírá návod k pohyblivé plošině.
Krok 2: otáčení, velikost a mizení
Pokud chcete part otočit, tweenujte CFrame na současný CFrame vynásobený rotací. Tween Orientation funguje také, ale s CFrame se part otočí na místě. Tady se zeď po spuštění skriptu otočí, pak zprůhlední a zmenší a po skončení tweenu se smaže:
-- Script uvnitř Partu s názvem FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- otočení o čtvrt otáčky kolem vlastní svislé osy za 1 sekundu
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- pokračujeme, až když otočení skončí
-- pak současně zprůhledníme a zmenšíme
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 se spustí s PlaybackState: Completed, pokud tween došel k cíli, nebo Cancelled, pokud ho zastavil tween:Cancel(). Nečekejte na Completed u tweenu, který se opakuje donekonečna: nikdy neskončí.
Krok 3: vznášející se a otáčející se předmět
Dva zacyklené tweeny na různých vlastnostech běží současně. Tween celé otáčky o 360 stupňů přes CFrame nic neudělá, protože začátek a konec jsou stejná rotace, proto otáčení tweenuje NumberValue od 0 do 360 a podle něj nastavuje CFrame. Dejte tento Script do ukotveného partu:
-- Script uvnitř Partu s názvem Gem. Donekonečna se vznáší nahoru a dolů a otáčí se.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- studů nad místem, kam jste ho postavili
local FLOAT_SECONDS = 1.2 -- na každou stranu
local SPIN_SECONDS = 3 -- jedna celá otáčka
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()
Otáčení používá Linear easing, takže se točí stálou rychlostí, a každý cyklus začíná znovu od 0, což je stejný úhel jako 360, takže nedojde k trhnutí. Návod ke sbírání mincí takové předměty zabudovává do hry.
Krok 4: tween celého modelu
Model nemá vlastnost Position ani CFrame, takže TweenService:Create(model, ...) nemá čím pohnout. Místo toho tweenujte NumberValue od 0 do 1 a model posouvejte přes PivotTo, který přesune všechny party v něm dohromady:
-- Script uvnitř Modelu s názvem Elevator.
-- Posouvá celý model o 20 studů nahoru a zpět, všechny party dohromady.
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()
Ukotvěte všechny party modelu. Dvojka na konci TweenInfo je prodleva před každým přehráním, takže výtah stojí nahoře i dole. Návod ke dveřím stejným způsobem otevírá dveře z několika partů.
Server, nebo klient?
Tween spuštěný v serverovém Scriptu mění part na serveru a nové hodnoty se replikují všem hráčům, takže ho vidí všichni. Tween v LocalScriptu mění part jen na obrazovce tohoto hráče.
| Spouštějte v | Kdy | Příklad |
|---|---|---|
| Serverovém Scriptu | Změna je důležitá pro hru nebo pro všechny. | Dveře, pohyblivé překážky, vysouvací most |
| LocalScriptu | Vidět to má jen tento hráč, nebo jde čistě o vizuální efekt. | Předmět, který zmizí hráči, jenž ho sebral, UI |
Replikace posílá aktualizace mnohokrát za sekundu, takže serverové tweeny působí na většinu hráčů plynule, ale velmi rychlé nebo velmi početné serverové tweeny mohou na pomalém připojení vypadat méně plynule. Pro velké množství dekorativního pohybu (stovky otáčejících se mincí) spouštějte tweeny v LocalScriptu na každém klientovi.
Časté chyby a řešení
Před stisknutím Play otevřete okno Output (nabídka Window, pak Output).
Part se vůbec nepohne
Ověřte, že jste u tweenu zavolali :Play(), že název vlastnosti v cíli je napsaný přesně (Position, ne position) a že je to Script na místě, kde se skripty spouštějí (uvnitř partu ve Workspace nebo ve ServerScriptService).
Part během tweenu padá nebo se třese
Není ukotvený, takže tweenu překáží gravitace a kolize. Zaškrtněte Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Hodnota cíle má špatný typ, například číslo pro vlastnost typu Vector3. Viz stránku chyby (anglicky).
Unable to cast to Dictionary nebo Unable to cast value to Object
Argumenty jsou ve špatném pořadí nebo mají špatný typ. Pořadí je vždy Create(instance, tweenInfo, goalTable). Viz Unable to cast value to Object (anglicky).
Udělat s RoCode
Pokud se vám nechce psát tweeny ručně, RoCode je může postavit ve vašem otevřeném place. RoCode je nezávislý AI agent pro Roblox Studio, ne od Robloxu: změnu popíšete ve webovém chatu a jeho plugin pro Studio vytvoří skripty ve vašem Exploreru, takže kód vkládat nemusíte.
Udělej, aby model mostu ve Workspace odjel o 15 studů stranou, když začne kolo, přes tween NumberValue a PivotTo, a současně nech červené party bariér zmizet za 1 sekundu.
- Může najít potřebné party a modely přes Search Game, než cokoli napíše
- Píše Script přes Create Script a má pokyn ověřit kompilaci přes Check Script
- Před každou dávkou změn a po ní nastaví bod pro vrácení, takže Ctrl+Z vrací po jedné dávce
S pluginem 3.9 nebo novějším může RoCode spustit krátký playtest a přečíst chyby, ale pohyb se nejlépe posoudí vlastníma očima, takže stiskněte Play a podívejte se. Jak se RoCode připojuje ke Studiu.
Časté otázky
Jak používat TweenService v Robloxu?
Získejte službu, vytvořte TweenInfo, zavolejte TweenService:Create(object, info, { Property = goal }) a u výsledku spusťte :Play(). V prvním oddílu je příklad ze tří řádků.
Jak zacyklit tween navždy?
Předejte -1 jako čtvrtou hodnotu do TweenInfo.new (repeatCount) a true jako pátou, pokud má chodit tam a zpět.
Jak počkat na konec tweenu?
Zavolejte tween.Completed:Wait() po tween:Play() nebo připojte funkci k tween.Completed.
Dá se tweenovat Model?
Přímo ne. Tweenujte NumberValue od 0 do 1 a při každé změně volejte model:PivotTo(start:Lerp(goal, value)), jako v kroku 4.
Jak zastavit tween?
Zavolejte tween:Cancel(), abyste ho zastavili a nechali part tam, kde je, nebo tween:Pause(), abyste později pokračovali přes Play().
Zdroje a další čtení
- Roblox Creator Docs: TweenService (anglicky). Create, které typy se tweenují a zrušení
- Roblox Creator Docs: TweenInfo (anglicky)
- Roblox Creator Docs: Tween (anglicky). Play, Pause, Cancel a Completed
- Roblox Creator Docs: UI animation and tweens (anglicky). styly a směry easingu na příkladu UI
- Roblox Creator Docs: PVInstance:PivotTo (anglicky)
Jak byl kód ověřen: každý skript na této stránce prochází přísnou kontrolou typů Luau s definicemi Roblox API (luau-lsp, 20. listopadu 2026). Kontrola typů zachytí chyby v názvech API a špatné typy, ale ne chyby v herní logice, proto vše otestujte ve Studiu před publikováním.