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

TweenService в Roblox: двигаем, вращаем и скрываем парты

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

Обновлено 12 ноября 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, 12 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.

Попробуйте RoCode в своей игре.

Бесплатные кредиты каждый день, без карты. Установите плагин, опишите функцию и проверьте, что появилось в Studio.