Накратко
Вземи услугата с game:GetService("TweenService"), опиши движението с TweenInfo.new(time, easingStyle, easingDirection), после извикай TweenService:Create(part, info, { Position = goal }) и пусни :Play() на получения туин. Можеш да туинваш всяко свойство от тип number, Vector3, CFrame, Color3, UDim2 и подобни. За да изчакаш края, използвай tween.Completed:Wait(), а за безкрайно движение напред и назад задай в TweenInfo брой повторения -1 и включи reverses.
- Туинвай парта на сървъра, когато трябва да го виждат всички играчи; на клиента, когато ефектът е нужен само за този играч.
- Направи Anchored партовете, които туинваш, иначе физиката ще пречи на туина.
- Model няма Position или CFrame за туин: туинвай NumberValue и мести модела с
PivotTo.
На тази страница
Трите реда, които трябват на всеки туин
Вмъкни Part в Workspace, отметни Anchored, после задръж курсора върху него, натисни + и вмъкни Script. Този скрипт вдига парта с 10 стъда за 2 секунди:
-- Script в Part.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 секунди, easing по подразбиране
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
Целта е таблица с имена на свойства и стойностите, на които трябва да завършат. Можеш да туинваш няколко свойства наведнъж: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Туинът тръгва от стойностите, които има в момента на извикване на Play, затова винаги задаваш само края.
| Тип | Туинва ли се плавно? | Примери |
|---|---|---|
| number | Да | Transparency, Reflectance, Value на NumberValue |
| Vector3, CFrame | Да | Position, Size, CFrame, Orientation |
| Color3 | Да | Color |
| UDim2, Vector2 | Да | Size и Position на GUI |
| boolean, EnumItem | Превключва се в края | CanCollide, Material |
| string, Instance | Не | Дава грешка cannot be tweened due to type mismatch |
Стъпка 1: всички настройки на TweenInfo
TweenInfo.new приема до шест стойности в този ред. Последните може да не ги посочваш.
| Стойност | По подразбиране | Какво прави |
|---|---|---|
time | 1 | Секунди за едно изпълнение. |
easingStyle | Quad | Формата на движението: Linear (постоянна скорост), Sine, Quad, Cubic, Back (с прелитане), Bounce, Elastic, Exponential. |
easingDirection | Out | Out започва бързо и забавя; In започва бавно; InOut прави и двете. |
repeatCount | 0 | Колко пъти да се повтори след първото изпълнение. -1 повтаря безкрайно. |
reverses | false | Дали да се връща в началото след всяко изпълнение. |
delayTime | 0 | Колко секунди да чака преди старта. |
-- Script в Part с име Platform.
-- Безкрайно се движи напред и назад на 12 стъда, плавно в двата края.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- секунди във всяка посока
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- повтаряй безкрайно
true -- всеки път се връщай
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Ако платформата трябва да вози играчите, които стоят на нея, имай предвид: Anchored парт с туин се движи под тях, но не ги отнася със себе си. Този случай е разгледан в ръководството за движеща се платформа.
Стъпка 2: въртене, размер и избледняване
За да завъртиш парт, туинвай CFrame към текущия CFrame, умножен по завъртане. Туин на Orientation също работи, но с CFrame партът се завърта на място. Тук при старта на скрипта стената се завърта, после избледнява и се смалява, а след края на туина се изтрива:
-- Script в Part с име FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- завъртане на четвърт оборот около собствената вертикална ос за 1 секунда
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- продължаваме, чак когато завъртането свърши
-- после едновременно избледняваме и смаляваме
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 се задейства с PlaybackState: Completed, ако туинът е стигнал целта, или Cancelled, ако го е спрял tween:Cancel(). Не чакай Completed на туин, който се повтаря безкрайно: той никога няма да свърши.
Стъпка 3: предмет, който се рее и върти
Два зациклени туина на различни свойства вървят едновременно. Туин на пълен оборот от 360 градуса чрез CFrame не прави нищо, защото началото и краят са едно и също завъртане, затова въртенето туинва NumberValue от 0 до 360 и задава CFrame според него. Сложи този Script в Anchored парт:
-- Script в Part с име Gem. Безкрайно се рее нагоре-надолу и се върти.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- стъда над мястото, където си го поставил
local FLOAT_SECONDS = 1.2 -- във всяка посока
local SPIN_SECONDS = 3 -- един пълен оборот
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()
Въртенето използва Linear easing, затова се върти с постоянна скорост, а всеки цикъл започва отново от 0, което е същият ъгъл като 360, така че няма подскачане. Ръководството за събиране на монети вгражда такива предмети в игра.
Стъпка 4: туин на цял модел
Model няма свойство Position или CFrame, затова TweenService:Create(model, ...) няма какво да мести. Вместо това туинвай NumberValue от 0 до 1 и мести модела с PivotTo, който премества всички партове в него заедно:
-- Script в Model с име Elevator.
-- Мести целия модел с 20 стъда нагоре и обратно, всички партове заедно.
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()
Направи Anchored всички партове на модела. Двойката в края на TweenInfo е паузата преди всяко изпълнение, затова асансьорът спира горе и долу. Ръководството за врати по същия начин отваря врати от няколко парта.
Сървър или клиент?
Туин, пуснат в сървърен Script, променя парта на сървъра и новите стойности се репликират до всички играчи, затова го виждат всички. Туин в LocalScript променя парта само на екрана на този играч.
| Пускай в | Кога | Пример |
|---|---|---|
| Сървърен Script | Промяната е важна за играта или за всички. | Врати, движещи се препятствия, мост, който се разтваря |
| LocalScript | Трябва да го вижда само този играч или е чисто визуален ефект. | Предмет, който избледнява при играча, който го е взел, UI |
Репликацията изпраща обновления много пъти в секунда, затова сървърните туини изглеждат плавни за повечето играчи, но много бързи или много на брой сървърни туини може да изглеждат по-малко плавни при бавна връзка. За много декоративно движение (стотици въртящи се монети) пускай туините в LocalScript на всеки клиент.
Чести грешки и решения
Отвори прозореца Output (меню Window, после Output), преди да натиснеш Play.
Партът изобщо не се движи
Провери дали си извикал :Play() на туина, дали името на свойството в целта е написано точно (Position, а не position) и дали това е Script на място, където скриптовете се изпълняват (в парт в Workspace или в ServerScriptService).
Партът пада или трепери по време на туина
Не е Anchored, затова гравитацията и сблъсъците пречат на туина. Отметни Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Стойността на целта е от грешен тип, например число за свойство от тип Vector3. Виж страницата за грешката (на английски).
Unable to cast to Dictionary или Unable to cast value to Object
Аргументите не са в правилния ред или са от грешен тип. Редът винаги е Create(instance, tweenInfo, goalTable). Виж Unable to cast value to Object (на английски).
Направи го с RoCode
Ако не ти се пишат туини на ръка, RoCode може да ги изгради в плейса, който имаш отворен. RoCode е независим ИИ агент за Roblox Studio, не от Roblox: описваш промяната в уеб чата, а неговият плъгин за Studio създава скриптовете в твоя Explorer, така че не трябва да поставяш код.
Направи така, че моделът на моста в Workspace да се отмества на 15 стъда встрани, когато започне рунд, чрез туин на NumberValue и PivotTo, и едновременно избледнявай червените партове бариери за 1 секунда.
- Може да намери нужните партове и модели чрез Search Game, преди да напише нещо
- Пише Script чрез Create Script и му е казано да проверява компилацията чрез Check Script
- Поставя точка за отмяна преди и след всяка група промени, затова Ctrl+Z връща назад по една група
С плъгин 3.9 или по-нов RoCode може да пусне кратък плейтест и да прочете грешките, но движението е най-лесно да се оцени с очите, затова натисни Play и виж. Как RoCode се свързва със Studio.
Често задавани въпроси
Как се използва TweenService в Roblox?
Вземи услугата, създай TweenInfo, извикай TweenService:Create(object, info, { Property = goal }) и пусни :Play() на резултата. В първия раздел има пример от три реда.
Как да зациклиш туин завинаги?
Подай -1 като четвърта стойност в TweenInfo.new (repeatCount) и true като пета, ако трябва да ходи напред и назад.
Как да изчакаш края на туин?
Извикай tween.Completed:Wait() след tween:Play() или свържи функция към tween.Completed.
Може ли да се туинва Model?
Директно не. Туинвай NumberValue от 0 до 1 и при всяка промяна извиквай model:PivotTo(start:Lerp(goal, value)), както в стъпка 4.
Как да спреш туин?
Извикай tween:Cancel(), за да го спреш и да оставиш парта там, където е, или tween:Pause(), за да продължиш после с Play().
Източници и какво да прочетеш
- Roblox Creator Docs: TweenService (на английски). Create, кои типове се туинват и отмяна
- Roblox Creator Docs: TweenInfo (на английски)
- Roblox Creator Docs: Tween (на английски). Play, Pause, Cancel и Completed
- Roblox Creator Docs: UI animation and tweens (на английски). стилове и посоки на easing с пример от UI
- Roblox Creator Docs: PVInstance:PivotTo (на английски)
Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.