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

TweenService у Roblox: рухаємо, обертаємо й ховаємо парти

Твін плавно змінює властивість від поточного значення до цілі за заданий час: платформа ковзає, кристал обертається, стіна розчиняється. TweenService сам рахує проміжні кроки, тож вам не потрібно писати цикл, який зсуває парт щокадру. У цьому гайді: три рядки, без яких не обходиться жоден твін, що робить кожне налаштування TweenInfo, рух, обертання й зникнення партів, цикли, очікування кінця твіна та прийом для твіна цілої моделі (Model).

Оновлено 20 листопада 2026 р.5 хв читанняАвтор:

Коротко

Отримайте сервіс через 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()

Якщо платформа має везти гравців, які на ній стоять, врахуйте: анкерний парт із твіном рухається під ними, але не несе їх із собою. Цей випадок розібрано в гайді про рухому платформу.

Крок 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 в анкерний парт:

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

Зробіть анкерними всі парти моделі. Двійка в кінці TweenInfo це затримка перед кожним програванням, тому ліфт стоїть нагорі й унизу. Гайд про двері так само відчиняє двері з кількох партів.

Сервер чи клієнт?

Твін, запущений у серверному Script, змінює парт на сервері, і нові значення реплікуються всім гравцям, тому його бачать усі. Твін у LocalScript змінює парт лише на екрані цього гравця.

Де запускати твін
Запускайте вКолиПриклад
Серверному ScriptЗміна важлива для гри або для всіх.Двері, рухомі перешкоди, міст, що розкривається
LocalScriptБачити це має лише цей гравець, або це суто візуальний ефект.Предмет, що розчиняється в гравця, який його підібрав, UI

Реплікація надсилає оновлення багато разів на секунду, тому серверні твіни більшості гравців здаються плавними, але дуже швидкі або дуже численні серверні твіни можуть виглядати менш плавно на повільному з'єднанні. Для великої кількості декоративного руху (сотні монет, що обертаються) запускайте твіни в LocalScript на кожному клієнті.

Поширені помилки та рішення

Відкрийте вікно Output (меню Window, потім Output) до натискання Play.

Парт узагалі не рухається

Перевірте, що ви викликали в твіна :Play(), що ім'я властивості в цілі написане точно (Position, а не position) і що це Script у місці, де скрипти запускаються (всередині парта у Workspace або в ServerScriptService).

Парт падає або трясеться під час твіна

Він не анкерний, тому гравітація й зіткнення заважають твіну. Позначте 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.