チュートリアル · ゲームシステム

Roblox Studio でスクリプトからアニメーションを再生する方法

Roblox でアニメーションを再生するのは、アニメーション自体ではなく、キャラクターの Animator です。このガイドでは、プレイヤーがキーを押したときにアニメーションを再生し、ダンスのオンとオフを切り替え、NPC でアニメーションをループさせ、こぶしが当たるちょうどそのフレームでパンチを当てる方法を紹介します。

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

要点

StarterPlayer > StarterCharacterScripts に LocalScript を置きます。その中でキャラクターの Humanoid とその Animator を見つけ、自分の AnimationId を入れた Animation を作り、animator:LoadAnimation(animation) で読み込みます。そして UserInputService.InputBegan が指定のキーを知らせたら、返ってきたトラックの :Play() を呼びます。プレイヤーが自分のキャラクターでこの方法で再生したアニメーションは、サーバーにいる全員に見えます。

  • アニメーションは、ゲームの所有者(あなたか、あなたのグループ)か Roblox のものである必要があります。他の人がアップロードしたアニメーションは、あなたのゲームでは再生されません。
  • トラックの Priority を Action にしてください。そうしないと、歩きや待機のアニメーションに上書きされることがあります。
  • アニメーションは Animator:LoadAnimation で読み込みます。Humanoid:LoadAnimation は非推奨です。
このページの内容
  1. 仕組み
  2. 1. アニメーション ID
  3. 2. キーで再生
  4. 3. ループするダンス
  5. 4. NPC で再生
  6. 5. アニメーションイベント
  7. Common errors
  8. RoCode で作る
  9. よくある質問
  10. 参考資料

Roblox でアニメーションが再生される仕組み

関わるオブジェクトは4つです。手で作るのはそのうち1つだけで、残りはスクリプトが用意します。

アニメーションを再生するオブジェクト
オブジェクト場所役割
Animationスクリプトが作成アニメーションアセットのアドレスである AnimationId を保持します。それ自体は何も再生しません。
Animatorキャラクターの Humanoid の中(Roblox が追加)アニメーションを読み込み、リグの関節で再生します。
AnimationTrackAnimator:LoadAnimation() の戻り値再生できるコピーです。Play()、Stop()、Looped、Priority、Speed とイベントを持ちます。
アニメーションアセットRoblox 上、Animation Editor から公開キーフレームそのものです。その ID を AnimationId に書きます。

アニメーションはそれぞれ1回だけ読み込み、トラックを保存しておきます。キーを押すたびに LoadAnimation を呼ぶと、そのたびに新しいトラックが作られ、どんどん溜まっていきます。

アニメーションの優先度(低い順)
優先度用途
Core最も低い優先度です。ほかのすべてに上書きされます。
Idleその場で立っている状態。
Movement歩く、走る、ジャンプ。
Actionエモート、攻撃、ツール。スクリプトから再生するアニメーションでは普通これを選びます。
Action2 から Action4別のアクションを上書きする必要があるアクション。たとえば攻撃の上に重ねるスタン。

再生中の2つのトラックが同じ関節を動かすと、その関節では優先度の高いトラックが勝ちます。腕だけを動かす Action の手を振るアニメーションなら、足はそのまま歩き続けられます。

ステップ1:使えるアニメーション ID を用意する

Roblox がゲーム内でアニメーションを再生するのは、そのアニメーションがゲームの所有者か Roblox のものである場合だけです。そのため、Creator Store や動画からコピーした ID のほとんどは使えません。他の人のものなので読み込まれないのです。良い入手先は2つあります。

  1. 自分で作る。Studio で Avatar タブを開いて Animation Editor を選び、リグを選択し(同じタブの Rig Builder でリグを挿入できます)、タイムラインにポーズを置いてから、エディターのメニューで Publish to Roblox を選びます。ゲームを所有しているのと同じアカウントかグループに公開してください。発行された ID をコピーします。
  2. Roblox のアニメーションを使う。Roblox の Animate スクリプトに入っている標準のエモート、たとえば R15 の手を振る動き(507770239)とダンス(507771019)は Roblox のものなので、どのゲームでも動きます。このガイドではすぐに試せるよう、これらを使っています。

ID は "rbxassetid://" の後に番号を付けて書きます。たとえば "rbxassetid://507770239" です。

ステップ2:キーを押したらアニメーションを再生する

  1. Explorer で StarterPlayer を開き、StarterCharacterScripts にカーソルを合わせて + をクリックし、LocalScript を挿入します。
  2. 名前を EmoteOnKey に変え、下のコードを貼り付けます。
  3. Play を押してから E を押します。キャラクターが手を振ります。
LocalScript 場所: StarterCharacterScripts 名前: EmoteOnKey
-- StarterPlayer > StarterCharacterScripts にある EmoteOnKey という名前の LocalScript。
-- E を押すと自分のキャラクターでアニメーションを再生します。サーバーにいる全員に見えます。
local UserInputService = game:GetService("UserInputService")

local ANIMATION_ID = "rbxassetid://507770239" -- Roblox 公式の R15 の手を振るアニメーション。ここに自分のアニメーションの ID を入れます
local KEY = Enum.KeyCode.E
local COOLDOWN_SECONDS = 1

local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local animator = humanoid:WaitForChild("Animator") :: Animator

local animation = Instance.new("Animation")
animation.AnimationId = ANIMATION_ID
local track = animator:LoadAnimation(animation)
track.Priority = Enum.AnimationPriority.Action -- 歩きや待機より上なので、足は歩き続け、腕は手を振ります

local lastPlayed = -math.huge

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	-- プレイヤーがチャットやテキストボックスに入力している間、gameProcessed は true になります
	if gameProcessed or input.KeyCode ~= KEY then
		return
	end
	if humanoid.Health <= 0 or os.clock() - lastPlayed < COOLDOWN_SECONDS then
		return
	end
	lastPlayed = os.clock()
	track:Play(0.1) -- 0.1 秒かけてなめらかに始めます
end)

StarterCharacterScripts のスクリプトはキャラクターが出現するたびにキャラクターの中へコピーされます。そのため script.Parent はキャラクターで、リスポーンのたびにトラックが読み込み直されます。

gameProcessed は、キー入力を先に Roblox が処理したとき、たとえばプレイヤーがチャットに入力している間に true になります。このチェックがあるので、誰かが E の文字を打つたびにエモートが発動することはありません。

手を振る動きは、あなただけでなく全員に見えます。Roblox は、プレイヤーが自分のキャラクターで再生したアニメーションを、その Animator をサーバーが作成していればレプリケートします。Roblox が各キャラクターに入れる Animator はまさにそのように作られています。だから、このスクリプトには RemoteEvent が必要ありません。

ステップ3:ループするアニメーションのオンとオフを切り替える

ダンスや座る動きは、プレイヤーが止めるまで続けたいものです。Looped を true にして、キーを押すたびに同じトラックを開始または停止します。このバージョンでは、プレイヤーが歩き出したときにもダンスを止めます。

LocalScript 場所: StarterCharacterScripts 名前: DanceToggle
-- StarterPlayer > StarterCharacterScripts にある DanceToggle という名前の LocalScript。
-- G を押すとループするダンスが始まり、もう一度 G を押す(または歩く)と止まります。
local UserInputService = game:GetService("UserInputService")

local DANCE_ID = "rbxassetid://507771019" -- Roblox 公式の R15 のダンス。ここに自分のアニメーションの ID を入れます
local KEY = Enum.KeyCode.G

local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local animator = humanoid:WaitForChild("Animator") :: Animator

local animation = Instance.new("Animation")
animation.AnimationId = DANCE_ID
local track = animator:LoadAnimation(animation)
track.Priority = Enum.AnimationPriority.Action
track.Looped = true

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	if gameProcessed or input.KeyCode ~= KEY then
		return
	end
	if track.IsPlaying then
		track:Stop(0.2)
	else
		track:Play(0.2)
	end
end)

-- プレイヤーが歩き出したらダンスを止めます
humanoid.Running:Connect(function(speed: number)
	if speed > 0.5 and track.IsPlaying then
		track:Stop(0.2)
	end
end)

Play と Stop に渡す数値は、なめらかに切り替わるまでの秒数です。短い切り替え時間を入れると、キャラクターがポーズからポーズへ急に跳ぶのではなく、ダンスがなめらかに始まり、なめらかに終わります。

ステップ4:NPC でアニメーションを再生する

NPC はどのプレイヤーのものでもないので、そのアニメーションはサーバーが再生します。NPC のモデルの中に Script(LocalScript ではありません)を置いてください。Rig Builder で作ったリグには、すでに Humanoid、HumanoidRootPart、Animator があります。

Script 場所: NPC のモデル 名前: NpcAnimation
-- NPC のモデルの中にある NpcAnimation という名前の Script。NPC には Humanoid と HumanoidRootPart が必要です。
-- サーバーから NPC でループするアニメーションを再生するので、すべてのプレイヤーに見えます。
local ANIMATION_ID = "rbxassetid://507771019" -- Roblox 公式の R15 のダンス。ここに自分のアニメーションの ID を入れます

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid

-- リグから作った NPC には普通すでに Animator があります。なければ作成します
local animator = humanoid:FindFirstChildOfClass("Animator")
if not animator then
	local newAnimator = Instance.new("Animator")
	newAnimator.Parent = humanoid
	animator = newAnimator
end
assert(animator, "the NPC has no Animator")

local animation = Instance.new("Animation")
animation.AnimationId = ANIMATION_ID
local track = animator:LoadAnimation(animation)
track.Looped = true
track:Play()

ステップ5:アニメーションの特定の瞬間に処理を結びつける

パンチのダメージは、キーを押したときではなく、こぶしが当たったときに与えたいものです。Animation Editor でその瞬間のタイムラインを右クリックし、Hit という名前の animation event を追加してから、アニメーションを公開し直します。コードでは、track:GetMarkerReachedSignal("Hit") がそのフレームで発火します。

LocalScript 場所: StarterCharacterScripts 名前: PunchOnClick
-- StarterPlayer > StarterCharacterScripts にある PunchOnClick という名前の LocalScript。
-- クリックでパンチのアニメーションを再生し、こぶしが当たった瞬間をサーバーに知らせます。
-- そのために、Animation Editor で追加するアニメーションイベント "Hit" を使います。
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")

local PUNCH_ID = "rbxassetid://0" -- 当たる瞬間に "Hit" イベントを入れた自分のパンチのアニメーション
local COOLDOWN_SECONDS = 0.6

local punchHit = ReplicatedStorage:WaitForChild("PunchHit") :: RemoteEvent
local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local animator = humanoid:WaitForChild("Animator") :: Animator

local animation = Instance.new("Animation")
animation.AnimationId = PUNCH_ID
local track = animator:LoadAnimation(animation)
track.Priority = Enum.AnimationPriority.Action

track:GetMarkerReachedSignal("Hit"):Connect(function()
	punchHit:FireServer() -- サーバーは距離とクールダウンを確認してからダメージを与えます
end)

local lastPunch = -math.huge
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	if gameProcessed or input.UserInputType ~= Enum.UserInputType.MouseButton1 then
		return
	end
	if os.clock() - lastPunch < COOLDOWN_SECONDS then
		return
	end
	lastPunch = os.clock()
	track:Play(0.05)
end)

このスクリプトには、ReplicatedStorage にある PunchHit という名前の RemoteEvent と、rbxassetid://0 の代わりに、Hit イベントを入れた自分のパンチのアニメーションが必要です。

クライアントは「パンチが当たった」と知らせるだけです。PunchHit.OnServerEvent を受け取るサーバーの Script が、近くに誰かいたか、どれだけダメージを与えるかを、独自のクールダウン付きで判断します。こうすれば、イベントを手動で発火させるプレイヤーがマップの端から端まで殴れることはありません。RemoteEvent のガイドで、こうしたリクエストをサーバーで確認する方法を紹介しています。

よくあるエラーと対処法

まず Output ウィンドウを開いてください(Window メニューから Output)。アニメーションの問題の多くは、そこに1行のメッセージを出します。

何も起きず、Output にアニメーションを読み込めなかったと表示される

アニメーションの所有者がゲームの所有者ではなく、他の人です。Animation Editor から、ゲームを所有しているアカウントかグループに自分のコピーを公開し、その ID を使ってください。

アニメーションは再生されるが、腕しか動かない、または途中までのように見える

優先度の高い別のトラックが同じ関節を動かしています。トラックの Priority を Action(またはそれ以上)にするか、Animation Editor からその優先度でアニメーションを公開してください。

何も起きず、エラーも出ない

リグの種類を確認してください。R15 のアニメーションは R6 のキャラクターでは何もしません。また、スクリプトが StarterCharacterScripts にある LocalScript かどうかも確認してください。Workspace にある LocalScript は実行されません。

NPC がアニメーションしない

パーツが Anchored になっているか、Humanoid に Animator がありません。Anchored にするのは HumanoidRootPart だけにしてください。ステップ4のスクリプトは、Animator がなければ作成します。

他のプレイヤーに自分のアニメーションが見えない

プレイヤーが所有していないキャラクターでアニメーションを再生したか、LocalScript から作った Animator で再生しています。自分のキャラクターのアニメーションは LocalScript から、それ以外(NPC、他のプレイヤー)はすべてサーバーの Script から再生してください。

RoCode で作る

RoCode は、プラグインを通じて Roblox Studio の中で動く AI エージェントです。動きを説明すると、いま開いているプレイスにスクリプトを書きます。

あなたの入力

E で手を振るエモートと、G でオンとオフを切り替えられるダンスを追加して、近づいてきたプレイヤーにショップの NPC が手を振るようにして。

RoCode の作業
  • LocalScript と NPC 用の Script を書き、それぞれあるべき場所に置きます
  • 手を振る、パンチ、ダンスのような簡単な動きならコードの中で直接組み立てられるので、アニメーションをアップロードする必要はありません
  • 作業を終える前に、書いたスクリプトを Studio の中でチェックします

それでも Play を押して、動きが思いどおりに見えるかを確認する必要があります。RoCode が Studio に接続する仕組み。

よくある質問

見つけたアニメーション ID なら何でも使えますか?

いいえ。アニメーションが再生されるのは、その所有者がゲームの所有者である場合か、Roblox が所有している場合だけです。自分のアニメーションか、Roblox の標準アニメーションを使ってください。

LocalScript から再生したアニメーションは他のプレイヤーに見えますか?

はい。プレイヤーが自分のキャラクターで、Roblox がキャラクターに与える Animator を通じて再生していれば見えます。NPC のアニメーションはサーバーの Script から再生する必要があります。

Roblox でアニメーションをループさせるには?

再生する前に track.Looped = true を設定するか、公開する前に Animation Editor で Loop をオンにします。

アニメーションを止めるには?

再生したトラックの track:Stop() を呼びます。track:Stop(0.2) のように数値を渡すと、その秒数でなめらかにフェードアウトします。

なぜ Humanoid:LoadAnimation ではなく Animator を使うのですか?

Humanoid:LoadAnimation は非推奨です。Animator:LoadAnimation は同じことをするもので、Roblox のドキュメントが説明しているのもこちらです。

参考資料

コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。

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

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