Návod · Základy skriptovania

TweenService v Robloxe: hýbeme, otáčame a skrývame party

Tween plynulo mení vlastnosť od aktuálnej hodnoty po cieľ za zadaný čas: plošina sa posúva, kryštál sa otáča, stena sa rozplynie. TweenService si medzikroky počíta sám, takže nemusíte písať slučku, ktorá posúva part každý snímok. V tomto návode: tri riadky, bez ktorých sa nezaobíde žiadny tween, čo robí každé nastavenie TweenInfo, pohyb, otáčanie a miznutie partov, slučky, čakanie na koniec tweenu a trik na tween celého modelu (Model).

Aktualizované 20. novembra 20265 min čítaniaAutor:

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
  1. Ako to funguje
  2. 1. TweenInfo
  3. 2. Otáčanie a miznutie
  4. 3. Slučky
  5. 4. Modely
  6. Server alebo klient
  7. Common errors
  8. S RoCode
  9. Časté otázky
  10. Zdroje a ďalšie čítanie

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 v parte vo Workspace s názvom Rise
-- 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.

Čo sa dá a čo sa nedá tweenovať
TypTweenuje sa plynulo?Príklady
numberÁnoTransparency, Reflectance, Value pri NumberValue
Vector3, CFrameÁnoPosition, Size, CFrame, Orientation
Color3ÁnoColor
UDim2, Vector2ÁnoSize a Position pri GUI
boolean, EnumItemPrepne sa na konciCanCollide, Material
string, InstanceNieVyhodí 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ť.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
HodnotaPredvoleneČo robí
time1Sekundy na jedno prehratie.
easingStyleQuadTvar pohybu: Linear (stála rýchlosť), Sine, Quad, Cubic, Back (s prestrelením), Bounce, Elastic, Exponential.
easingDirectionOutOut začne rýchlo a spomalí; In začne pomaly; InOut robí oboje.
repeatCount0Koľkokrát zopakovať po prvom prehratí. -1 opakuje donekonečna.
reversesfalseVracať sa na začiatok po každom prehratí.
delayTime0Koľko sekúnd čakať pred štartom.
Script v parte vo Workspace s názvom Platform
-- 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 v parte vo Workspace s názvom FadingWall
-- 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 v parte vo Workspace s názvom FloatingGem
-- 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 v modeli vo Workspace s názvom Elevator
-- 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.

Kde spustiť tween
Spúšťajte vKedyPríklad
Serverovom ScripteZmena je dôležitá pre hru alebo pre všetkých.Dvere, pohyblivé prekážky, vysúvací most
LocalScripteVidieť 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.

Napíšete

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.

RoCode urobí
  • 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

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.

Vyskúšajte RoCode vo svojej hre.

Kredity zadarmo každý deň, bez karty. Nainštalujte plugin, opíšte funkciu a pozrite sa, čo sa objaví v Studiu.