Poradnik · Podstawy skryptowania

TweenService w Roblox: przesuwamy, obracamy i ukrywamy party

Tween płynnie zmienia właściwość od obecnej wartości do celu w zadanym czasie: platforma się przesuwa, kryształ obraca, ściana rozpływa. TweenService sam liczy kroki pośrednie, więc nie musisz pisać pętli, która co klatkę przesuwa part. W tym poradniku: trzy linie, bez których nie obejdzie się żaden tween, co robi każde ustawienie TweenInfo, przesuwanie, obracanie i znikanie partów, pętle, czekanie na koniec tweena i sposób na tween całego modelu (Model).

Zaktualizowano 20 listopada 20265 min czytaniaAutor:

W skrócie

Pobierz serwis przez game:GetService("TweenService"), opisz ruch przez TweenInfo.new(time, easingStyle, easingDirection), potem wywołaj TweenService:Create(part, info, { Position = goal }) i uruchom :Play() na otrzymanym tweenie. Tweenować można każdą właściwość typu number, Vector3, CFrame, Color3, UDim2 i podobnych. Żeby poczekać na koniec, użyj tween.Completed:Wait(), a dla ruchu tam i z powrotem bez końca ustaw w TweenInfo liczbę powtórzeń -1 i włącz reverses.

  • Tweenuj part na serwerze, gdy mają go widzieć wszyscy gracze; na kliencie, gdy efekt jest potrzebny tylko temu graczowi.
  • Kotwicz (Anchored) party, które tweenujesz, inaczej fizyka będzie przeszkadzać tweenowi.
  • Model nie ma Position ani CFrame do tweenowania: tweenuj NumberValue i przesuwaj model przez PivotTo.
Na tej stronie
  1. Jak to działa
  2. 1. TweenInfo
  3. 2. Obrót i znikanie
  4. 3. Pętle
  5. 4. Modele
  6. Serwer czy klient
  7. Common errors
  8. Z RoCode
  9. Najczęstsze pytania
  10. Źródła i dalsza lektura

Trzy linie, których potrzebuje każdy tween

Wstaw Part do Workspace, zaznacz Anchored, potem najedź na niego kursorem, kliknij + i wstaw Script. Ten skrypt podnosi part o 10 studów w 2 sekundy:

Script w Part w Workspace o nazwie Rise
-- Script wewnątrz Part.
local TweenService = game:GetService("TweenService")

local part = script.Parent :: BasePart

local info = TweenInfo.new(2) -- 2 sekundy, domyślny easing
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }

local tween = TweenService:Create(part, info, goal)
tween:Play()

Cel to tabela z nazw właściwości i wartości, na których mają się skończyć. Możesz tweenować kilka właściwości naraz: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Tween zaczyna od wartości, które są w chwili wywołania Play, więc zawsze podajesz tylko koniec.

Co można, a czego nie można tweenować
TypTweenuje się płynnie?Przykłady
numberTakTransparency, Reflectance, Value w NumberValue
Vector3, CFrameTakPosition, Size, CFrame, Orientation
Color3TakColor
UDim2, Vector2TakSize i Position w GUI
boolean, EnumItemPrzełącza się na końcuCanCollide, Material
string, InstanceNieDaje błąd cannot be tweened due to type mismatch

Krok 1: wszystkie ustawienia TweenInfo

TweenInfo.new przyjmuje do sześciu wartości w tej kolejności. Ostatnie można pominąć.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
WartośćDomyślnieCo robi
time1Sekundy na jedno odtworzenie.
easingStyleQuadKształt ruchu: Linear (stała prędkość), Sine, Quad, Cubic, Back (z przelotem), Bounce, Elastic, Exponential.
easingDirectionOutOut zaczyna szybko i zwalnia; In zaczyna wolno; InOut robi jedno i drugie.
repeatCount0Ile razy powtórzyć po pierwszym odtworzeniu. -1 powtarza bez końca.
reversesfalseWracać do początku po każdym odtworzeniu.
delayTime0Ile sekund czekać przed startem.
Script w Part w Workspace o nazwie Platform
-- Script wewnątrz Part o nazwie Platform.
-- Bez końca jeździ tam i z powrotem o 12 studów, płynnie na obu końcach.
local TweenService = game:GetService("TweenService")

local platform = script.Parent :: BasePart

local info = TweenInfo.new(
	3, -- sekundy w każdą stronę
	Enum.EasingStyle.Sine,
	Enum.EasingDirection.InOut,
	-1, -- powtarzaj bez końca
	true -- za każdym razem wracaj
)

TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()

Jeśli platforma ma wozić stojących na niej graczy, pamiętaj: zakotwiczony part z tweenem porusza się pod nimi, ale nie zabiera ich ze sobą. Ten przypadek omawia poradnik o ruchomej platformie.

Krok 2: obrót, rozmiar i znikanie

Żeby obrócić part, tweenuj CFrame do obecnego CFrame pomnożonego przez obrót. Tween Orientation też działa, ale z CFrame part obraca się w miejscu. Tutaj ściana po uruchomieniu skryptu obraca się, potem rozpływa i zmniejsza, a po końcu tweena jest usuwana:

Script w Part w Workspace o nazwie FadingWall
-- Script wewnątrz Part o nazwie FadingWall.
local TweenService = game:GetService("TweenService")

local wall = script.Parent :: BasePart

-- obrót o ćwierć obrotu wokół własnej osi pionowej w 1 sekundę
local turn = TweenService:Create(wall, TweenInfo.new(1), {
	CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- idziemy dalej dopiero, gdy obrót się skończył

-- potem jednocześnie rozpuszczamy i zmniejszamy
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 odpala się z PlaybackState: Completed, jeśli tween dotarł do celu, albo Cancelled, jeśli zatrzymał go tween:Cancel(). Nie czekaj na Completed tweena, który powtarza się bez końca: nigdy się nie skończy.

Krok 3: unoszący się i obracający przedmiot

Dwa zapętlone tweeny na różnych właściwościach działają jednocześnie. Tween pełnego obrotu o 360 stopni przez CFrame nic nie robi, bo początek i koniec to ten sam obrót, więc obrót tweenuje NumberValue od 0 do 360 i ustawia według niego CFrame. Włóż ten Script do zakotwiczonego partu:

Script w Part w Workspace o nazwie FloatingGem
-- Script wewnątrz Part o nazwie Gem. Bez końca unosi się w górę i w dół i obraca.
local TweenService = game:GetService("TweenService")

local FLOAT_HEIGHT = 1.5 -- studów wyżej niż miejsce, w którym go postawiłeś
local FLOAT_SECONDS = 1.2 -- w każdą stronę
local SPIN_SECONDS = 3 -- jeden pełny obrót

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()

Obrót używa Linear easing, więc kręci się ze stałą prędkością, a każdy cykl zaczyna się znowu od 0, czyli tego samego kąta co 360, więc nie ma szarpnięcia. Poradnik o zbieraniu monet wbudowuje takie przedmioty w grę.

Krok 4: tween całego modelu

Model nie ma właściwości Position ani CFrame, więc TweenService:Create(model, ...) nie ma czego przesuwać. Zamiast tego tweenuj NumberValue od 0 do 1 i przesuwaj model przez PivotTo, który przenosi wszystkie party w środku razem:

Script w Model w Workspace o nazwie Elevator
-- Script wewnątrz Model o nazwie Elevator.
-- Przesuwa cały model o 20 studów w górę i z powrotem, wszystkie party razem.
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()

Zakotwicz wszystkie party modelu. Dwójka na końcu TweenInfo to opóźnienie przed każdym odtworzeniem, więc winda stoi na górze i na dole. Poradnik o drzwiach w ten sam sposób otwiera drzwi z kilku partów.

Serwer czy klient?

Tween uruchomiony w serwerowym Script zmienia part na serwerze, a nowe wartości replikują się do wszystkich graczy, więc widzą go wszyscy. Tween w LocalScript zmienia part tylko na ekranie tego gracza.

Gdzie uruchamiać tween
Uruchamiaj wKiedyPrzykład
Serwerowym ScriptZmiana ma znaczenie dla gry albo dla wszystkich.Drzwi, ruchome przeszkody, rozkładający się most
LocalScriptWidzieć to ma tylko ten gracz albo to czysto wizualny efekt.Przedmiot, który znika u gracza, który go podniósł, UI

Replikacja wysyła aktualizacje wiele razy na sekundę, więc serwerowe tweeny większości graczy wydają się płynne, ale bardzo szybkie albo bardzo liczne serwerowe tweeny mogą wyglądać mniej płynnie przy wolnym łączu. Przy dużej ilości dekoracyjnego ruchu (setki obracających się monet) uruchamiaj tweeny w LocalScript na każdym kliencie.

Częste błędy i rozwiązania

Otwórz okno Output (menu Window, potem Output) przed kliknięciem Play.

Part w ogóle się nie rusza

Sprawdź, czy wywołałeś na tweenie :Play(), czy nazwa właściwości w celu jest napisana dokładnie (Position, a nie position) i czy to Script w miejscu, gdzie skrypty się uruchamiają (wewnątrz partu w Workspace albo w ServerScriptService).

Part spada albo trzęsie się podczas tweena

Nie jest zakotwiczony, więc grawitacja i kolizje przeszkadzają tweenowi. Zaznacz Anchored.

TweenService:Create property cannot be tweened due to type mismatch

Wartość celu ma zły typ, na przykład liczba dla właściwości typu Vector3. Zobacz stronę błędu (po angielsku).

Unable to cast to Dictionary albo Unable to cast value to Object

Argumenty są w złej kolejności albo mają zły typ. Kolejność to zawsze Create(instance, tweenInfo, goalTable). Zobacz Unable to cast value to Object (po angielsku).

Zrób to z RoCode

Jeśli nie chce ci się pisać tweenów ręcznie, RoCode może je zbudować w grze, którą masz otwartą. RoCode to niezależny agent AI do Roblox Studio, nie robi go Roblox: opisujesz zmianę na czacie w przeglądarce, a jego plugin do Studio tworzy skrypty w twoim Explorerze, więc nie musisz wklejać kodu.

Ty piszesz

Spraw, żeby model mostu w Workspace odjeżdżał o 15 studów w bok, gdy zaczyna się runda, przez tween NumberValue i PivotTo, a jednocześnie rozpuszczaj czerwone party-bariery w 1 sekundę.

RoCode robi
  • Może znaleźć potrzebne party i modele przez Search Game, zanim cokolwiek napisze
  • Pisze Script przez Create Script i ma polecone sprawdzić kompilację przez Check Script
  • Stawia punkt cofania przed i po każdej paczce zmian, więc Ctrl+Z cofa po jednej paczce

Z pluginem 3.9 lub nowszym RoCode może uruchomić krótki playtest i przeczytać błędy, ale ruch najłatwiej ocenić własnymi oczami, więc kliknij Play i popatrz. Jak RoCode łączy się ze Studio.

Najczęstsze pytania

Jak używać TweenService w Roblox?

Pobierz serwis, utwórz TweenInfo, wywołaj TweenService:Create(object, info, { Property = goal }) i uruchom :Play() na wyniku. W pierwszej sekcji jest przykład z trzech linii.

Jak zapętlić tween na zawsze?

Przekaż -1 jako czwartą wartość w TweenInfo.new (repeatCount) i true jako piątą, jeśli ma chodzić tam i z powrotem.

Jak poczekać na koniec tweena?

Wywołaj tween.Completed:Wait() po tween:Play() albo podłącz funkcję do tween.Completed.

Czy można tweenować Model?

Bezpośrednio nie. Tweenuj NumberValue od 0 do 1 i przy każdej zmianie wywołuj model:PivotTo(start:Lerp(goal, value)), jak w kroku 4.

Jak zatrzymać tween?

Wywołaj tween:Cancel(), żeby go zatrzymać i zostawić part tam, gdzie jest, albo tween:Pause(), żeby potem kontynuować przez Play().

Źródła i dalsza lektura

Jak sprawdziliśmy kod: każdy skrypt na tej stronie przechodzi ścisłe sprawdzanie typów Luau z definicjami API Robloxa (luau-lsp, 20 listopada 2026). Sprawdzanie typów wyłapuje źle wpisane API i błędne typy, ale nie logikę gry, więc przetestuj go w Studio przed publikacją.

Wypróbuj RoCode we własnej grze.

Darmowe kredyty codziennie, bez karty. Zainstaluj plugin, opisz funkcję i sprawdź, co pojawi się w Studio.