要点
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でモデルを動かします。
どのトゥイーンにも必要な3行
Workspace に Part を入れて Anchored にチェックを入れ、パーツにカーソルを合わせて + を押し、Script を入れます。このスクリプトはパーツを2秒で10スタッド持ち上げます:
-- Part の中の Script。
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2秒、イージングは初期設定
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、NumberValue の Value |
| Vector3, CFrame | はい | Position、Size、CFrame、Orientation |
| Color3 | はい | Color |
| UDim2, Vector2 | はい | GUI の Size と Position |
| boolean, EnumItem | 最後に切り替わる | CanCollide、Material |
| string, Instance | いいえ | cannot be tweened due to type mismatch エラーになります |
ステップ1:TweenInfo のすべての設定
TweenInfo.new は最大6つの値をこの順番で受け取ります。後ろのほうは省略できます。
| 値 | 初期値 | 働き |
|---|---|---|
time | 1 | 1回の再生にかかる秒数。 |
easingStyle | Quad | 動きの形:Linear(一定の速さ)、Sine、Quad、Cubic、Back(行き過ぎて戻る)、Bounce、Elastic、Exponential。 |
easingDirection | Out | Out は速く始まってゆっくりになり、In はゆっくり始まり、InOut はその両方です。 |
repeatCount | 0 | 最初の再生のあと何回繰り返すか。-1 で無限に繰り返します。 |
reverses | false | 再生のたびに始めの位置へ戻るかどうか。 |
delayTime | 0 | 開始前に何秒待つか。 |
-- Platform という名前の Part の中の Script。
-- 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 ならパーツがその場で回ります。この例では、スクリプトが始まると壁が回転し、次に透明になりながら小さくなり、トゥイーンが終わったら削除されます:
-- FadingWall という名前の Part の中の Script。
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- 自分の縦軸を中心に1秒で4分の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、tween:Cancel() で止められたら Cancelled です。無限に繰り返すトゥイーンの Completed を待ってはいけません。終わることがないからです。
ステップ3:浮かびながら回るアイテム
別々のプロパティにかけた2つのループトゥイーンは同時に進みます。CFrame で360度の1回転をトゥイーンしても何も起きません。始まりと終わりが同じ回転だからです。そこで回転は NumberValue を0から360へトゥイーンし、その値から CFrame を設定します。この Script を Anchored のパーツに入れてください:
-- Gem という名前の Part の中の Script。無限に上下に浮かびながら回転します。
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- 置いた位置から何スタッド上か
local FLOAT_SECONDS = 1.2 -- 片道
local SPIN_SECONDS = 3 -- 1回転
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 イージングを使うので一定の速さで回ります。毎回のループは0から始まり直しますが、0は360と同じ角度なのでカクつきません。コイン集めのガイドでは、こうしたアイテムをゲームに組み込んでいます。
ステップ4:モデル全体をトゥイーンする
Model には Position や CFrame プロパティがないので、TweenService:Create(model, ...) には動かすものがありません。代わりに NumberValue を0から1へトゥイーンし、PivotTo でモデルを動かします。PivotTo は中のすべてのパーツをまとめて動かします:
-- Elevator という名前の Model の中の Script。
-- モデル全体を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 の最後の2は毎回の再生前の待ち時間なので、エレベーターは上と下で止まります。ドアのガイドでは、同じ方法で複数のパーツでできたドアを開けています。
サーバーとクライアント、どちらで?
サーバーの Script で始めたトゥイーンはサーバー上でパーツを変え、新しい値がすべてのプレイヤーにレプリケートされるので、全員に見えます。LocalScript のトゥイーンは、そのプレイヤーの画面の中だけでパーツを変えます。
| 実行する場所 | 使う場面 | 例 |
|---|---|---|
| サーバーの Script | ゲームにとって、または全員にとって大事な変化。 | ドア、動く障害物、開く橋 |
| LocalScript | そのプレイヤーだけが見ればよい、または純粋に見た目だけの効果。 | 拾ったプレイヤーの画面で消えていくアイテム、UI |
レプリケーションは1秒に何度も更新を送るので、サーバーのトゥイーンはほとんどのプレイヤーにはなめらかに見えます。ただし、とても速いトゥイーンや大量のサーバートゥイーンは、遅い回線ではなめらかさが落ちることがあります。飾りの動きが大量にある場合(何百枚もの回るコインなど)は、各クライアントの LocalScript でトゥイーンを実行してください。
よくあるエラーと対処法
Play を押す前に Output ウィンドウ(Window メニューから Output)を開いておいてください。
パーツがまったく動かない
トゥイーンの :Play() を呼んだか、目標のプロパティ名が正確か(position ではなく Position)、そしてスクリプトが動く場所(Workspace のパーツの中か ServerScriptService)にある Script かを確認してください。
トゥイーン中にパーツが落ちる、または震える
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 製ではない独立した Roblox Studio 向けの AI エージェントです。ウェブチャットで変更内容を説明すると、Studio プラグインがあなたの Explorer にスクリプトを作るので、コードを貼り付ける必要はありません。
ラウンドが始まったら、Workspace にある橋のモデルが NumberValue のトゥイーンと PivotTo を使って横に15スタッド動くようにして。同時に、赤いバリアのパーツを1秒で透明にして。
- 何かを書く前に、Search Game で目的のパーツやモデルを探せます
- Create Script で Script を書き、Check Script でコンパイルを確認するよう指示されています
- 変更のまとまりごとに前後へ取り消しポイントを置くので、Ctrl+Z で1まとまりずつ戻せます
プラグイン 3.9 以降なら RoCode は短いプレイテストを行ってエラーを読めますが、動きは自分の目で見るのがいちばん確実です。Play を押して見てください。RoCode が Studio につながる仕組み。
よくある質問
Roblox で TweenService はどう使いますか?
サービスを取得し、TweenInfo を作り、TweenService:Create(object, info, { Property = goal }) を呼んで、結果の :Play() を実行します。最初のセクションに3行の例があります。
トゥイーンを永遠にループさせるには?
TweenInfo.new の4番目の値(repeatCount)に -1 を渡し、行ったり来たりさせたいなら5番目に true を渡します。
トゥイーンが終わるのを待つには?
tween:Play() のあとに tween.Completed:Wait() を呼ぶか、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(英語). UI を例にしたイージングのスタイルと方向
- Roblox Creator Docs: PVInstance:PivotTo(英語)
コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。