チュートリアル · スクリプトの基本

Roblox の TweenService:パーツを動かす、回す、消す

トゥイーンは、プロパティを今の値から目標の値まで、決めた時間をかけてなめらかに変えます。床がすべるように動き、クリスタルが回り、壁がすっと消えていきます。途中の計算は TweenService が自分で行うので、毎フレームパーツを動かすループを書く必要はありません。このガイドでは、どのトゥイーンにも欠かせない3行、TweenInfo の各設定の意味、パーツの移動、回転、フェードアウト、ループ、トゥイーンの終了を待つ方法、そしてモデル(Model)全体をトゥイーンするコツを紹介します。

更新日 2026年11月20日読了時間 約3分執筆

要点

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. 参考資料

どのトゥイーンにも必要な3行

Workspace に Part を入れて Anchored にチェックを入れ、パーツにカーソルを合わせて + を押し、Script を入れます。このスクリプトはパーツを2秒で10スタッド持ち上げます:

Script 場所: Workspace のパーツ 名前: Rise
-- 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つの値をこの順番で受け取ります。後ろのほうは省略できます。

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
値初期値働き
time11回の再生にかかる秒数。
easingStyleQuad動きの形:Linear(一定の速さ)、Sine、Quad、Cubic、Back(行き過ぎて戻る)、Bounce、Elastic、Exponential。
easingDirectionOutOut は速く始まってゆっくりになり、In はゆっくり始まり、InOut はその両方です。
repeatCount0最初の再生のあと何回繰り返すか。-1 で無限に繰り返します。
reversesfalse再生のたびに始めの位置へ戻るかどうか。
delayTime0開始前に何秒待つか。
Script 場所: Workspace のパーツ 名前: Platform
-- 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 ならパーツがその場で回ります。この例では、スクリプトが始まると壁が回転し、次に透明になりながら小さくなり、トゥイーンが終わったら削除されます:

Script 場所: Workspace のパーツ 名前: FadingWall
-- 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 のパーツに入れてください:

Script 場所: Workspace のパーツ 名前: FloatingGem
-- 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 は中のすべてのパーツをまとめて動かします:

Script 場所: Workspace のモデル 名前: Elevator
-- 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秒で透明にして。

RoCode の作業
  • 何かを書く前に、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 API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。

RoCode を自分のゲームで試してみましょう。

毎日無料のクレジット付き、カード不要です。プラグインを入れて、作りたい機能を説明し、Studio に反映された内容を確認してください。