Коротко
Получите сервис через 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()
Если платформа должна везти стоящих на ней игроков, учтите: анкерный парт с твином двигается под ними, но не уносит их с собой. Этот случай разобран в гайде по движущейся платформе.
Шаг 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 в анкерный парт:
-- 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()
Анкерьте все парты модели. Двойка в конце 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 секунду.
- Может найти нужные парты и модели через 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, 12 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.