Tutoriál · Základy skriptování

TweenService v Robloxu: posouváme, otáčíme a skrýváme party

Tween plynule mění vlastnost ze současné hodnoty na cílovou za zadaný čas: plošina klouže, krystal se otáčí, zeď mizí. TweenService si mezikroky spočítá sám, takže nemusíte psát smyčku, která part posouvá každý snímek. V tomto návodu: tři řádky, bez kterých se neobejde žádný tween, co dělá každé nastavení TweenInfo, posun, otáčení a mizení partů, smyčky, čekání na konec tweenu a trik pro tween celého modelu (Model).

Aktualizováno 20. listopadu 20265 min čteníAutor:

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
  1. Jak to funguje
  2. 1. TweenInfo
  3. 2. Otáčení a mizení
  4. 3. Smyčky
  5. 4. Modely
  6. Server, nebo klient
  7. Common errors
  8. S RoCode
  9. Časté otázky
  10. Zdroje a další čtení

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 v partu ve Workspace s názvem Rise
-- 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.

Co lze a co nelze tweenovat
TypTweenuje se plynule?Příklady
numberAnoTransparency, Reflectance, Value u NumberValue
Vector3, CFrameAnoPosition, Size, CFrame, Orientation
Color3AnoColor
UDim2, Vector2AnoSize a Position u GUI
boolean, EnumItemPřepne se na konciCanCollide, Material
string, InstanceNeVyhodí 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.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
HodnotaVýchozíCo dělá
time1Sekundy na jedno přehrání.
easingStyleQuadTvar pohybu: Linear (stálá rychlost), Sine, Quad, Cubic, Back (s přestřelením), Bounce, Elastic, Exponential.
easingDirectionOutOut začne rychle a zpomalí; In začne pomalu; InOut dělá obojí.
repeatCount0Kolikrát opakovat po prvním přehrání. -1 opakuje donekonečna.
reversesfalseVracet se na začátek po každém přehrání.
delayTime0Kolik sekund čekat před startem.
Script v partu ve Workspace s názvem Platform
-- 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 v partu ve Workspace s názvem FadingWall
-- 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 v partu ve Workspace s názvem FloatingGem
-- 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 v modelu ve Workspace s názvem Elevator
-- 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.

Kde tween spouštět
Spouštějte vKdyPříklad
Serverovém ScriptuZměna je důležitá pro hru nebo pro všechny.Dveře, pohyblivé překážky, vysouvací most
LocalScriptuVidě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.

Napíšete

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.

RoCode udělá
  • 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í

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.

Vyzkoušejte RoCode ve své hře.

Kredity zdarma každý den, bez karty. Nainstalujte plugin, popište funkci a podívejte se, co se objeví ve Studiu.