Туториал · Основи на скриптирането

TweenService в Roblox: местим, въртим и скриваме партове

Туинът плавно променя свойство от текущата му стойност до целта за зададено време: платформа се плъзга, кристал се върти, стена избледнява. TweenService сам изчислява междинните стъпки, затова не ти трябва цикъл, който мести парта всеки кадър. В това ръководство: трите реда, без които не минава нито един туин, какво прави всяка настройка на TweenInfo, движение, въртене и избледняване на партове, цикли, изчакване на края на туина и трик за туин на цял модел (Model).

Обновено 20 ноември 2026 г.6 мин четенеАвтор:

Накратко

Вземи услугата с 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.
На тази страница
  1. Как работи
  2. 1. TweenInfo
  3. 2. Въртене и избледняване
  4. 3. Цикли
  5. 4. Модели
  6. Сървър или клиент
  7. Common errors
  8. С RoCode
  9. Често задавани въпроси
  10. Източници и какво да прочетеш

Трите реда, които трябват на всеки туин

Вмъкни Part в Workspace, отметни Anchored, после задръж курсора върху него, натисни + и вмъкни Script. Този скрипт вдига парта с 10 стъда за 2 секунди:

Script в парт в Workspace с име Rise
-- 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 приема до шест стойности в този ред. Последните може да не ги посочваш.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
СтойностПо подразбиранеКакво прави
time1Секунди за едно изпълнение.
easingStyleQuadФормата на движението: Linear (постоянна скорост), Sine, Quad, Cubic, Back (с прелитане), Bounce, Elastic, Exponential.
easingDirectionOutOut започва бързо и забавя; In започва бавно; InOut прави и двете.
repeatCount0Колко пъти да се повтори след първото изпълнение. -1 повтаря безкрайно.
reversesfalseДали да се връща в началото след всяко изпълнение.
delayTime0Колко секунди да чака преди старта.
Script в парт в Workspace с име Platform
-- 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 в парт в Workspace с име FadingWall
-- 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 в парт в Workspace с име FloatingGem
-- 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 в модел в Workspace с име Elevator
-- 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 секунда.

RoCode прави
  • Може да намери нужните партове и модели чрез 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().

Източници и какво да прочетеш

Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.

Пробвай RoCode в своята игра.

Безплатни кредити всеки ден, без карта. Инсталирай плъгина, опиши функцията и виж какво се е появило в Studio.