V skratke
Získajte službu cez game:GetService("TweenService"), opíšte pohyb cez TweenInfo.new(time, easingStyle, easingDirection), potom zavolajte TweenService:Create(part, info, { Position = goal }) a na získanom tweene spustite :Play(). Tweenovať môžete akúkoľvek vlastnosť typu number, Vector3, CFrame, Color3, UDim2 a podobných. Ak chcete počkať na koniec, použite tween.Completed:Wait(), a pre nekonečný pohyb tam a späť zadajte v TweenInfo počet opakovaní -1 a zapnite reverses.
- Tweenujte part na serveri, keď ho majú vidieť všetci hráči; na klientovi, keď je efekt potrebný len pre tohto hráča.
- Party, ktoré tweenujete, ukotvite (Anchored), inak bude fyzika tweenu prekážať.
- Model nemá Position ani CFrame na tween: tweenujte NumberValue a model hýbte cez
PivotTo.
Na tejto stránke
Tri riadky, ktoré potrebuje každý tween
Vložte Part do Workspace, zaškrtnite Anchored, potom naň nabehnite kurzorom, kliknite na + a vložte Script. Tento skript zdvihne part o 10 studov za 2 sekundy:
-- Script vnútri Part.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 sekundy, predvolený easing
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
Cieľ je tabuľka názvov vlastností a hodnôt, na ktorých majú skončiť. Naraz môžete tweenovať viac vlastností: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Tween začína od hodnôt, ktoré platia v momente volania Play, preto vždy zadávate len koniec.
| Typ | Tweenuje sa plynulo? | Príklady |
|---|---|---|
| number | Áno | Transparency, Reflectance, Value pri NumberValue |
| Vector3, CFrame | Áno | Position, Size, CFrame, Orientation |
| Color3 | Áno | Color |
| UDim2, Vector2 | Áno | Size a Position pri GUI |
| boolean, EnumItem | Prepne sa na konci | CanCollide, Material |
| string, Instance | Nie | Vyhodí chybu cannot be tweened due to type mismatch |
Krok 1: všetky nastavenia TweenInfo
TweenInfo.new prijíma až šesť hodnôt v tomto poradí. Posledné môžete vynechať.
| Hodnota | Predvolene | Čo robí |
|---|---|---|
time | 1 | Sekundy na jedno prehratie. |
easingStyle | Quad | Tvar pohybu: Linear (stála rýchlosť), Sine, Quad, Cubic, Back (s prestrelením), Bounce, Elastic, Exponential. |
easingDirection | Out | Out začne rýchlo a spomalí; In začne pomaly; InOut robí oboje. |
repeatCount | 0 | Koľkokrát zopakovať po prvom prehratí. -1 opakuje donekonečna. |
reverses | false | Vracať sa na začiatok po každom prehratí. |
delayTime | 0 | Koľko sekúnd čakať pred štartom. |
-- Script vnútri Part s názvom Platform.
-- Donekonečna jazdí tam a späť o 12 studov, plynulo na oboch koncoch.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- sekundy každým smerom
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- opakovať donekonečna
true -- zakaždým sa vrátiť
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Ak má plošina voziť hráčov, ktorí na nej stoja, majte na pamäti: ukotvený part s tweenom sa pod nimi hýbe, ale neodnesie ich so sebou. Tento prípad rozoberá návod na pohyblivú plošinu.
Krok 2: otáčanie, veľkosť a miznutie
Ak chcete part otočiť, tweenujte CFrame na aktuálny CFrame vynásobený otočením. Tween Orientation funguje tiež, ale s CFrame sa part otáča na mieste. Tu sa stena po spustení skriptu otočí, potom sa rozplynie a zmenší a po skončení tweenu sa odstráni:
-- Script vnútri Part s názvom FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- otočenie o štvrť otáčky okolo vlastnej zvislej osi 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ž keď sa otočenie skončí
-- potom naraz rozplynieme 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 sa spustí s PlaybackState: Completed, ak tween dosiahol cieľ, alebo Cancelled, ak ho zastavil tween:Cancel(). Nečakajte na Completed pri tweene, ktorý sa opakuje donekonečna: nikdy neskončí.
Krok 3: vznášajúci sa a otáčajúci sa predmet
Dva zacyklené tweeny na rôznych vlastnostiach bežia naraz. Tween celej otáčky o 360 stupňov cez CFrame nerobí nič, pretože začiatok a koniec sú to isté otočenie, preto otáčanie tweenuje NumberValue od 0 do 360 a podľa neho nastavuje CFrame. Vložte tento Script do ukotveného partu:
-- Script vnútri Part s názvom Gem. Donekonečna sa vznáša hore-dole a otáča sa.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- studov nad miestom, kam ste ho položili
local FLOAT_SECONDS = 1.2 -- každým smerom
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áčanie používa Linear easing, takže sa točí stálou rýchlosťou, a každý cyklus začína znova od 0, čo je ten istý uhol ako 360, takže nenastane trhnutie. Návod na zbieranie mincí zapája takéto predmety do hry.
Krok 4: tween celého modelu
Model nemá vlastnosť Position ani CFrame, preto TweenService:Create(model, ...) nemá čím hýbať. Namiesto toho tweenujte NumberValue od 0 do 1 a model hýbte cez PivotTo, ktorý presúva všetky party v ňom spolu:
-- Script vnútri Model s názvom Elevator.
-- Posúva celý model o 20 studov hore a späť, všetky party spolu.
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()
Ukotvite všetky party modelu. Dvojka na konci TweenInfo je oneskorenie pred každým prehratím, preto výťah postojí hore aj dole. Návod na dvere rovnakým spôsobom otvára dvere z viacerých partov.
Server alebo klient?
Tween spustený v serverovom Scripte mení part na serveri a nové hodnoty sa replikujú všetkým hráčom, preto ho vidia všetci. Tween v LocalScripte mení part len na obrazovke tohto hráča.
| Spúšťajte v | Kedy | Príklad |
|---|---|---|
| Serverovom Scripte | Zmena je dôležitá pre hru alebo pre všetkých. | Dvere, pohyblivé prekážky, vysúvací most |
| LocalScripte | Vidieť to má len tento hráč, alebo ide čisto o vizuálny efekt. | Predmet, ktorý sa rozplynie hráčovi, ktorý ho zdvihol, UI |
Replikácia posiela aktualizácie mnohokrát za sekundu, preto serverové tweeny väčšine hráčov pripadajú plynulé, ale veľmi rýchle alebo veľmi početné serverové tweeny môžu na pomalom pripojení vyzerať menej plynulo. Pre veľa dekoratívneho pohybu (stovky otáčajúcich sa mincí) spúšťajte tweeny v LocalScripte na každom klientovi.
Časté chyby a riešenia
Pred stlačením Play otvorte okno Output (menu Window, potom Output).
Part sa vôbec nehýbe
Skontrolujte, či ste na tweene zavolali :Play(), či je názov vlastnosti v cieli napísaný presne (Position, nie position) a či ide o Script na mieste, kde sa skripty spúšťajú (vnútri partu vo Workspace alebo v ServerScriptService).
Part počas tweenu padá alebo sa trasie
Nie je ukotvený, preto gravitácia a zrážky tweenu prekážajú. Zaškrtnite Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Hodnota cieľa má zlý typ, napríklad číslo pre vlastnosť typu Vector3. Pozrite si stránku chyby (po anglicky).
Unable to cast to Dictionary alebo Unable to cast value to Object
Argumenty sú v zlom poradí alebo majú zlý typ. Poradie je vždy Create(instance, tweenInfo, goalTable). Pozrite si Unable to cast value to Object (po anglicky).
Urobiť s RoCode
Ak sa vám nechce písať tweeny ručne, RoCode ich môže postaviť vo vašom otvorenom place. RoCode je nezávislý AI agent pre Roblox Studio, nie od Robloxu: zmenu opíšete vo webovom chate a jeho plugin pre Studio vytvorí skripty vo vašom Exploreri, takže vkladať kód nemusíte.
Urob, aby sa model mosta vo Workspace odsunul o 15 studov nabok, keď sa začne kolo, cez tween NumberValue a PivotTo, a zároveň rozplyň červené party bariér za 1 sekundu.
- Môže pred písaním nájsť správne party a modely cez Search Game
- Píše Script cez Create Script a má za úlohu overiť kompiláciu cez Check Script
- Pred každou dávkou zmien aj po nej vytvorí bod na vrátenie, takže Ctrl+Z vracia po jednej dávke
S pluginom 3.9 alebo novším môže RoCode spustiť krátky playtest a prečítať chyby, ale pohyb sa najľahšie posúdi vlastnými očami, preto stlačte Play a pozrite sa. Ako sa RoCode pripája k Studiu.
Časté otázky
Ako používať TweenService v Robloxe?
Získajte službu, vytvorte TweenInfo, zavolajte TweenService:Create(object, info, { Property = goal }) a na výsledku spustite :Play(). V prvej časti je príklad na tri riadky.
Ako zacykliť tween navždy?
Odovzdajte -1 ako štvrtú hodnotu do TweenInfo.new (repeatCount) a true ako piatu, ak má chodiť tam a späť.
Ako počkať na koniec tweenu?
Zavolajte tween.Completed:Wait() po tween:Play() alebo pripojte funkciu k tween.Completed.
Dá sa tweenovať Model?
Priamo nie. Tweenujte NumberValue od 0 do 1 a pri každej zmene volajte model:PivotTo(start:Lerp(goal, value)), ako v kroku 4.
Ako zastaviť tween?
Zavolajte tween:Cancel(), aby ste ho zastavili a part nechali tam, kde je, alebo tween:Pause(), aby ste neskôr pokračovali cez Play().
Zdroje a ďalšie čítanie
- Roblox Creator Docs: TweenService (po anglicky). Create, ktoré typy sa tweenujú a zrušenie
- Roblox Creator Docs: TweenInfo (po anglicky)
- Roblox Creator Docs: Tween (po anglicky). Play, Pause, Cancel a Completed
- Roblox Creator Docs: UI animation and tweens (po anglicky). štýly a smery easingu na príklade UI
- Roblox Creator Docs: PVInstance:PivotTo (po anglicky)
Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.