ガイド · デバッグ

Roblox Studio のスクリプトエラーを直す方法

Roblox のスクリプトが壊れると、Studio はたいてい Output ウィンドウに、どこで、なぜ壊れたかを書き出します。このガイドでは、そのメッセージの読み方、よくあるエラーの意味とそれぞれの直し方、エラーがまったく出ないのにスクリプトが動かないときに確認すること、そして当てずっぽうではなく原因を見つけるための手順を紹介します。

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

要点

Window メニューか Script タブから Output ウィンドウを開き、Play を押して、最初の赤いエラーをクリックします。Studio はスクリプトを、失敗した行の位置で開きます。メッセージは何がおかしかったかを教えてくれます。attempt to index nil with 'Humanoid' は、.Humanoid の直前の値が nil だったという意味です。その値がない原因を直して、もう一度ゲームを実行してください。

  • リストの最初のエラーから始めてください。その下のエラーは、ただの連鎖であることがよくあります。
  • ゲーム中によく出るエラーの原因は3つにまとまります。値が nil である、名前のつづりが違うかまだ読み込まれていない、またはコードが違う側(サーバーかクライアント)で動いている、のどれかです。
  • エラーがまったく出ない場合は、たいていコードがそもそも実行されていません。スクリプトの種類、Explorer での置き場所、Enabled プロパティ、そして待っているイベントが本当に発火しているかを確認してください。
  • 目的の行で値が実際に何になっているかを知るには、ラベル付きの print で出力するか、その行にブレークポイントを置きます。
このページの内容
  1. Output を読む
  2. デバッグの手順
  3. よくあるエラー
  4. エラーなしで何も起きない
  5. デバッグツール
  6. RoCode で
  7. よくある質問
  8. 参考資料

Output を開いてエラーを読む方法

イメージガイドのキルブロックの例(早送り):壊れた行がエラーを出し、Stop、修正、もう一度のプレイテストのあと、パーツはエラーなしで落ちます。

Output ウィンドウは、Roblox がスクリプトのエラー、エンジンの警告、コードが出力したものすべてを知らせる場所です。いつも開いているとは限らないので、テストの前に開いてください。まだ一度もスクリプトを実行したことがないなら、初心者向けスクリプトのガイドが、Output を開いてスクリプトから最初の1行を出力するところから始めています。

  1. Studio の Window メニュー、または Script タブのボタンから Output を開きます。
  2. Ctrl+K(Mac では ⌘K)で古いメッセージを消し、今回のテストの分だけが見えるようにします。
  3. Play(F5)を押し、ゲームが壊れる操作をします。
  4. 最初の赤い行を探します。エラーは赤です。Infinite yield possible などの警告はオレンジ色で表示されます。

ゲーム中のエラーは Output ではこのように見えます。Output の表示設定によっては、各行に時刻、Client や Server のラベル、スクリプト名も付きます。

Output(例)
ServerScriptService.CoinPad:14: attempt to index nil with 'Coins'
Stack Begin
Script 'ServerScriptService.CoinPad', Line 14 - function award
Script 'ServerScriptService.CoinPad', Line 27
Stack End
  • ServerScriptService.CoinPad は Explorer でのスクリプトの場所です。ServerScriptService の中にある CoinPad という名前のスクリプトです。
  • :14 はエラーが起きた行です。
  • 行番号のあとのメッセージが、何がおかしかったかを示します。それぞれ下のよくあるエラーの一覧で解説しています。
  • Stack Begin と Stack End の間のスタックは、ここに至るまでの呼び出しを新しい順に示します。27行目から呼ばれた関数 award の中の14行目、という意味です。

赤いエラーをクリックすると、Studio はそのスクリプトを開き、カーソルを該当の行に置きます。ソロテストでは、サーバーと自分のクライアントのメッセージが1つの Output に出ます。サーバーのものは緑、クライアントのものは青で示されます。上部のフィルターで、メッセージの種類(Error、Warning)、コンテキスト(Client、Server)、テキストで一覧を絞り込めます。

どんなスクリプトにも使えるデバッグの手順

当てずっぽうで一度にいくつも変えるのは、スクリプトを直すいちばん遅い方法です。この手順なら、エラーメッセージがあってもなくても、一歩ずつ問題を絞り込めます。

  1. 問題を再現する。Output を消して Play を押し、ゲームが壊れる操作をそのとおりに行います。何を期待して、代わりに何が起きたかを書き留めます。
  2. 最初のエラーを取り上げる。最初の新しい赤い行を読みます。スクリプトのパス、行番号、メッセージです。エラーがない場合はエラーなしで何もしないスクリプトのセクションへ進みます。
  3. その行へ移動する。エラーをクリックします。行全体を読み、その中のどの値が nil か、つづりが違うか、型が違う可能性があるかを考えます。
  4. 推測ではなく値を確かめる。その行のすぐ上に print を足すか、その行にブレークポイントを置いて Watch ウィンドウで値を見ます。typeof(x) で、数値、文字列、Instance、nil のどれかがわかります。
  5. 手がかりを逆にたどる。値がおかしければ、それがどこで決まったかを探します。何も見つけられなかった FindFirstChild、何も返さなかった関数、呼び出し側が渡さなかった引数などです。
  6. 原因を直す。変更は一度に1つ。名前を直す、オブジェクトを待つ、コードを正しい側へ移すなどしてから、もう一度ゲームを実行します。行を pcall で包んで黙らせないでください。それではバグが隠れるだけで、直りません。
  7. 確認する。手順1を繰り返します。エラーが消え、機能が期待どおりに動くはずです。ほかのプレイヤーに関わる場合は、Server & Clients モードでクライアント2つでもテストしてください。
  8. 後片付けをする。デバッグ用の print を消すか無効にして、次の問題を見つけやすくしておきます。

Roblox のよくあるスクリプトエラーと直し方

どのメッセージも決まった型にあなたの名前を当てはめて作られているので、エラーの文面そのものがいちばんのヒントです。下の引用符の中の名前、たとえば 'Health' や "Workspace" は例です。

Output によく出るエラー。メッセージを選ぶと詳しい説明が開きます。
Output の表示意味よくある直し方
attempt to index nil with 'Health'.Health の前の値が nil でした。なぜ nil なのかを調べ、使う前に if で確認します。
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild が5秒待っても、オブジェクトが現れません。名前かパスを直す、誰かがそのオブジェクトを作っているか確認する、またはタイムアウトを付けます。
Bridge is not a valid member of Workspace "Workspace"その正確な名前の子オブジェクトやプロパティが、今そこにありません。つづりと大文字小文字を Explorer と見比べます。クライアントでは WaitForChild を使います。
attempt to call a nil value関数ではないものを呼び出しました。関数名と、呼び出しより上で宣言されているかを確認します。
attempt to perform arithmetic (add) on Instance and number数値ではないもので計算しました。値オブジェクトには .Value、テキストには tonumber を使います。
attempt to concatenate string with nil.. がテキストを nil やオブジェクトとつなごうとしました。tostring()、.Name、または文字列補間を使います。
Expected 'end' (to close 'function' at line 3), got <eof>構文エラーです。スクリプトはまったく実行されません。Script Editor で赤い下線が引かれた部分を直します。
Requested module experienced an error while loadingModuleScript 自体が実行中にエラーで止まりました。Output の少し上に出ているモジュール自身のエラーを直します。
Argument 1 missing or nilRoblox の関数が、値が必要な場所で nil を受け取りました。その引数がどこから来るはずだったかをたどります。
FireServer can only be called from the clientRemoteEvent を違う側から呼びました。サーバーは FireClient、LocalScript は FireServer を使います。
データストアのエラー 403、StudioAccessToApisNotAllowedStudio がこのゲームのデータストアを使うことを許可されていません。ゲームを公開し、Studio Access to API Services を有効にします。

ここに挙げたメッセージにも、それ以外にも、原因ごとに、それを起こすコードと直し方をまとめた専用のページがあります。Roblox Studio のエラーメッセージを見てください。たとえば attempt to index nil、Infinite yield possible、is not a valid member of などです。

attempt to index nil with 'X'

インデックスとは、ドットや角かっこで何かを読むことです:part.Position、player.Character、list[1]。このエラーは、左側にあったものが nil だったことを示し、引用符の中の名前はそこから読もうとしたものです。つまり player.Character.Humanoid という行で attempt to index nil with 'Humanoid' が出たら、player.Character が nil だったということです。キーが数値なら、メッセージは with number で終わります。

値が nil になるよくある原因:

  • FindFirstChild、FindFirstChildOfClass、FindFirstAncestor が何も見つけられなかった。名前が違うか、オブジェクトがまだないためです。
  • サーバーの Script で Players.LocalPlayer を使った。これは LocalScript と、それらが require する ModuleScript にしかなく、サーバーでは常に nil です。代わりに、PlayerAdded や RemoteEvent のハンドラーが渡してくれる player を使います。
  • キャラクターがスポーンする前や、リスポーン中に player.Character を読んだ。
  • テーブルの項目が設定されていなかった。たとえば、そのプレイヤーのデータが読み込まれる前の playerData[player] や、呼んだ関数が何も返さなかった場合です。

典型的なのはキルブロックです。壊れたバージョンは、パーツに触れたものはすべてキャラクターの一部だと決めつけていますが、捨てられたツール、Anchored でないパーツ、アクセサリーではそうなりません。

Script 場所: Workspace の Part 名前: KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- 壊れたバージョン:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- 触れたパーツがキャラクターの体の一部でないと、FindFirstChild が
	-- nil を返し、Output にこう表示されます:
	--   attempt to index nil with 'Health'

	-- 修正版:使う前に各ステップを確認する
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

hit.Parent.Humanoid と書くと、別のメッセージ Humanoid is not a valid member of ... になります。これは下で解説しています。FindFirstAncestorOfClass("Model") は、触れたパーツがキャラクターのアクセサリーや手に持ったツールの中にある場合でもキャラクターを見つけるので、手に持ったツールがブロックに当たった場合も数えられます。

このエラーを直すパターンは、値を取得し、確認し、それから使うことです。サーバーでは、なくても不思議でないものには FindFirstChild と if の確認が合います。LocalScript では、サーバーが作るものには WaitForChild を使います。スクリプトが動き出したあとに現れることがあるからです。

Infinite yield possible on ...

WaitForChild("Name") は、その名前の子オブジェクトが現れるまでスクリプトを一時停止します。タイムアウトを指定せずに5秒以上待つと、Roblox はこの警告を出します。これはエラーではなく警告です。スクリプトはまだ待っていて、オブジェクトが現れるまでこの行より後は何も実行されません。そして現れないこともあります。よくある原因:

  • 名前か親が違う。WaitForChild("leaderStats") では leaderstats フォルダーは永遠に見つかりません。
  • 誰もそのオブジェクトを作っていない。作るはずのサーバースクリプトが無効になっている、場所が違う、またはその前にエラーで止まっている。Output でもっと前のエラーを探してください。
  • LocalScript が ServerStorage や ServerScriptService の中のものを待っている。これらの中身はプレイヤーに送られないので、待ちは終わりません。
  • 子オブジェクトではなくプロパティを待っている。よくある例が player:WaitForChild("Character") です。Character は Player のプロパティで、中にあるオブジェクトではありません。
  • インスタンスのストリーミング(Workspace.StreamingEnabled)が有効で、パーツがプレイヤーから遠すぎるため、まだそのクライアントに送られていない。
LocalScript 場所: StarterPlayerScripts 名前: DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- 壊れたバージョン:
--   local character = player:WaitForChild("Character")
-- Character は Player のプロパティで子オブジェクトではないので、Output はこう警告します:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- タイムアウトを付けると、WaitForChild は永遠に待たずに nil を返す
	local humanoid = character:WaitForChild("Humanoid", 10)
	if not (humanoid and humanoid:IsA("Humanoid")) then
		warn(`[DeathMessage] no Humanoid in {character:GetFullName()} after 10 seconds`)
		return
	end
	humanoid.Died:Connect(function()
		print(`[DeathMessage] {player.Name} died`)
	end)
end

-- すでに存在しているかもしれないキャラクターを処理し、そのあと毎回のリスポーンを処理する
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

WaitForChild の2番目の引数の数値は、秒単位のタイムアウトです。こうするとスクリプトは黙って止まったままにならず、warn で問題を知らせてきれいに終われます。

X is not a valid member of Y

その瞬間に存在しない子オブジェクトやプロパティにドットでアクセスしました。たとえば、Workspace に Bridge という名前のパーツがないのに workspace.Bridge と書いた場合です。メッセージは、まず求めたもの、次に探した先のオブジェクトのクラスとフルパスを示します。確認するのは3つです:

  • つづりと大文字小文字が Explorer と完全に一致しているか。フォルダーの名前はすべて小文字の leaderstats で、humanoid は Humanoid ではありません。
  • プロパティ名はアメリカ式のつづりです。part.Colour は Colour is not a valid member of Part "Workspace.Part" で失敗します。プロパティ名は Color です。
  • オブジェクトが読み込まれているか。クライアントでは、サーバーが作るオブジェクトが LocalScript の開始後に届くことがあるので、そこでは WaitForChild を使います。
LocalScript 場所: StarterPlayerScripts 名前: CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- 壊れたバージョン:
--   local coins = player.leaderstats.Coins
-- leaderstats はサーバーが作るので、このクライアントに届くのは
-- このスクリプトの開始後かもしれません。その場合 Output にこう表示されます:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- サーバーが Coins を IntValue として作る

print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
	print(`[CoinsWatcher] coins changed to {newValue}`)
end)

ここでは、リーダーボードのガイドのように、Coins という名前の IntValue を持つ leaderstats を作るサーバースクリプトが必要です。

attempt to call a nil value

コードが nil のものの後ろにかっこを付けたので、実行するものがありませんでした。よくある原因:

  • 関数名のつづりや大文字小文字が違う。モジュールは Format.clock を宣言しているのに、呼び出し側が Format.Clock(95) と書いている。
  • local function を、宣言より上の行で呼んでいる。その時点では名前がまだないので、宣言を上へ移します。
  • ModuleScript が、返すテーブルに関数を追加していない。

似た2つのメッセージも同じ間違いを指しています。テーブルに存在しないメソッドをコロンで呼ぶと attempt to call missing method 'Kill' of table になります。Roblox のオブジェクトのメソッドのつづり間違い、たとえば part:Destory() では Destory is not a valid member of Part "Workspace.Part" になります。

attempt to perform arithmetic (add) on ...

Luau が計算(add、sub、mul、div など)をしようとしたのに、片方が数値ではありませんでした。メッセージの最後の型名が、どのケースかを教えてくれます:

  • on Instance and number:値オブジェクトの数値ではなく、オブジェクトそのもので計算しました。coins + 10 は coins.Value + 10 にします。
  • on nil and number:変数やテーブルの項目が設定されていません。初期値を与えるか、値がないことが本当にゼロを意味する場所では (x or 0) と書きます。
  • on string and number:数値ではないテキストで、TextBox から来ることが多いです。tonumber(text) で変換し、結果が nil でないか確認します。"5" のように数字が書かれたテキストは自動で変換されます。

比較も同じように attempt to compare nil < number で失敗します。Luau は a > b を b < a に書き換えるので、メッセージの順番がコードと逆になることがあります。

Script 場所: ServerScriptService 名前: CoinDrip
local Players = game:GetService("Players")

local REWARD = 5
local INTERVAL_SECONDS = 60

local function addCoins(player: Player, amount: number)
	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	if not (coins and coins:IsA("IntValue")) then
		-- 黙らずに、なぜ何も起きなかったかを書き出す
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- 壊れたバージョン:
	--   coins = coins + amount
	-- coins は IntValue オブジェクトで、その数値ではないので、Output にこう表示されます:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- 1分ごとに、サーバーにいる全プレイヤーに少しコインを配る
while true do
	task.wait(INTERVAL_SECONDS)
	for _, player in Players:GetPlayers() do
		addCoins(player, REWARD)
	end
end

attempt to concatenate string with nil

.. 演算子がつなげるのは文字列と数値だけです。nil とはつなげず、オブジェクトともつなげません。"Hi " .. player は attempt to concatenate string with Instance になります。player.Name を使うか、値を tostring() で包むか、バッククォートを使った文字列補間 print(`Coins: {coins}`) を使ってください。文字列補間ならスクリプトを止めずに nil と出力します。

Expected 'end' などの構文エラー

Expected で始まるメッセージは構文エラーです。コードが正しい Luau になっていないので Roblox はコンパイルできず、そのスクリプトは1行も実行されません。エラーより上の行もです。Script Editor は入力中にその場で赤い下線を引くので、Play を押す前に直せます。

  • Expected 'end' (to close 'function' at line 3), got <eof>:3行目で始まる function、if、for、while に対応する end がありません。メッセージの前の行番号はファイルの終わりを指していることが多いので、かっこの中に書かれた行を見てください。
  • Expected 'then' when parsing if statement, got '=':条件の中に = が1つだけあります。比較には == が必要です。
  • Expected ')' (to close '(' at line 1), got 'local':かっこが閉じられていません。
  • Expected <eof>, got 'end':end が1つ多すぎます。

インデントがそろっていれば、足りない end や余分な end はすぐに見つかります。各ブロックが、それを閉じる end と同じ高さにそろうからです。

Requested module experienced an error while loading

ModuleScript を最初に require() すると、そのコードが実行されます。モジュールが実行中にエラーで止まると、それを読み込んだスクリプトにこのメッセージが出ます。本当の問題は、Output の1、2行上に出ているモジュール自身のエラーです。そちらを直してください。似た2つのメッセージ:

  • Module code did not return exactly one value:モジュールが return で終わっていません。ModuleScript は nil ではない値を1つ返す必要があり、ふつうは自分のテーブルを返します。
  • Requested module was required recursively:2つのモジュールがお互いを require しています。共通部分を、両方が require する3つ目のモジュールに切り出してください。
ModuleScript 場所: ReplicatedStorage 名前: Format
local Format = {}

-- 秒数を分と秒に変換する:95 は "1:35" になる
function Format.clock(seconds: number): string
	local whole = math.max(0, math.floor(seconds))
	return string.format("%d:%02d", whole // 60, whole % 60)
end

-- モジュールは最後に自分のテーブルを返す必要がある。この行がないと、
-- このモジュールを require するたびにこう失敗する: Module code did not return exactly one value
return Format

スクリプトは local Format = require(ReplicatedStorage:WaitForChild("Format")) で読み込み、そのあと Format.clock(95) を呼びます。Format.Clock(95) と書くと attempt to call a nil value エラーになります。

Argument 1 missing or nil

Roblox の関数が、必要な引数で nil を受け取りました。数字はどの引数かを示します。itemName が nil だと、workspace:FindFirstChild(itemName) はこのように失敗します。バグがこの行にあることはまれです。値が来るはずだった場所にあります。つづりを間違えた変数、設定されなかった属性、クライアントが送らなかった RemoteEvent の引数などです。RemoteEvent の引数はプレイヤーの端末から届くので、サーバーは使う前に確認する必要があります。その方法は RemoteEvent のガイドで紹介しています。

FireServer can only be called from the client

RemoteEvent には向きがあります。LocalScript が FireServer を呼び、サーバーの Script が OnServerEvent で受け取ります。サーバーの Script が FireClient か FireAllClients を呼び、LocalScript が OnClientEvent で受け取ります。違う側からメソッドを呼ぶと、このエラーか、その逆の FireClient can only be called from the server になります。たいていは、コードを正しい種類のスクリプトへ移せば直ります。Script、LocalScript、ModuleScript を見てください。

Studio でのデータストアのエラー 403

Studio でのデータストアの呼び出しは、許可するまでエラーコード 403(StudioAccessToApisNotAllowed)で失敗します。プレイスを公開し、File、Experience Settings、Security を開いて Enable Studio Access to API Services を有効にし、保存します。すると Studio は本番のゲームと同じデータストアを使うようになるので、Roblox は、すでに遊ばれているゲームではなく別のテスト用コピーでこれを行うよう勧めています。データストアの呼び出しは、コードの外の理由で失敗することがあるので、すべて pcall で包んでください。安全な保存方法は DataStore のチュートリアルで解説しています。

エラーは出ないのにスクリプトが何もしない

黙っているスクリプトは、たいていそもそも実行されていないか、まだ何かを待っているか、違う側で実行されています。コードを変える前に、最初の行を print(script:GetFullName(), "started") にしてゲームを実行してください。この行が Output に出てこなければ、問題はスクリプトに書かれた内容ではなく、置き場所か設定にあります。

スクリプトがエラーなしで何もしない理由
確認すること何がおかしいか直し方
スクリプトの種類と場所LocalScript が実行されるのは、StarterPlayerScripts、StarterCharacterScripts、StarterGui、StarterPack、ReplicatedFirst に置いたときだけです(Starter コンテナからはプレイヤーのコピーとして実行されます)。Workspace、ServerScriptService、ReplicatedStorage に置くと、決して実行されません。RunContext が初期設定の Script は、Workspace か ServerScriptService でだけ実行されます。移動するか、別の種類のスクリプトを使います。UI と操作のコードは LocalScript に、ゲームのルールは ServerScriptService の Script に書きます。
EnabledEnabled のチェックが外れたスクリプトは実行されません。スクリプトを選び、Properties ウィンドウで Enabled にチェックを入れます。
RunContextScript の RunContext は、どこで実行されるかを決めます。初期設定の Legacy は、Workspace か ServerScriptService からサーバーで実行されます。Server はサーバーで、Client は各プレイヤーの端末で、たとえば ReplicatedStorage から実行されます。意図して設定してください。Roblox のドキュメントは、Client の Script は ReplicatedStorage か ReplicatedFirst に、LocalScript は Starter コンテナに置くよう勧めています。
イベントが発火しないTouched は物理的な動きでのみ発火し、2つのパーツの少なくとも一方が Anchored でないことと、両方の CanTouch が必要です。PlayerAdded は、イベントに接続した時点ですでにサーバーにいたプレイヤーには発火しません。RemoteEvent のハンドラーは、相手側がイベントを呼ばなければ実行されません。ハンドラーの中に print を置いて、実行されているかを確実に確かめ、それから呼び出すはずの側を直します。
ループや待ちの後のコードwhile true do ループの下の行は、ループが終わらないので決して実行されません。オブジェクトを見つけられない WaitForChild の下の行も実行されません。イベントはループの前に接続するか、ループを task.spawn で開始します。待ちにはタイムアウトを付けます。
黙って抜ける確認if not coins then return end のようなガードは、オブジェクトがないときに黙って関数を止めます。return の前に、詳しい内容を書いた warn を足します。
Output のフィルターOutput はメッセージの種類、Client か Server、テキストで絞り込めます。外し忘れたフィルターが、探しているエラーを隠していることがあります。フィルターを解除し、検索欄を空にします。
自分にしか見えない変更を LocalScript が行ったので、そのプレイヤーにしか見えません。サーバーやほかのプレイヤーには見えません。変更はサーバーで行います。スクリプトがどこで実行されるかを見てください。

PlayerAdded のケースには多くの人がつまずきます。Studio のテストでは、サーバーが始まるとほぼ同時に参加するからです。Connect の行より上で何かが待っていると、たとえば WaitForChild、task.wait、待ちを含むモジュールの require があると、接続ができる前に参加してしまうことがあります。新しく来たプレイヤーと、すでにいるプレイヤーの両方を処理してください:

Script 場所: ServerScriptService 名前: Welcome
local Players = game:GetService("Players")

local function onPlayerAdded(player: Player)
	print(`[Welcome] {player.Name} joined`)
end

Players.PlayerAdded:Connect(onPlayerAdded)

-- 上の行が実行されたときにすでにいたプレイヤーには、
-- このスクリプトの PlayerAdded は発火しないので、今ここで処理する
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Roblox Studio のデバッグツール

print は Output に1行を書き、warn は警告を書きます。「そもそも実行された?」「この値は何?」という疑問に答えるいちばん速い方法です。裸の print(x) はあとで見つけにくいので、ラベルと大事な詳細を添えてください。typeof(x) は値の種類(数値、文字列、Instance、nil)を、GetFullName() はそれがどのオブジェクトかを示します。

Script 場所: ServerScriptService 名前: ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- 終わったら false にする
local TAG = "[ShopServer]"

local function debugPrint(...: any)
	if DEBUG then
		print(TAG, ...)
	end
end

Players.PlayerAdded:Connect(function(player: Player)
	debugPrint("joined:", player.Name, player.UserId)

	local leaderstats = player:WaitForChild("leaderstats", 10)
	if not leaderstats then
		warn(TAG, "no leaderstats for", player.Name, "after 10 seconds")
		return
	end

	local coins = leaderstats:FindFirstChild("Coins")
	-- typeof と ClassName で、値が実際に何なのかがわかる
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

Output の検索欄はテキストで絞り込むので、[ShopServer] のような決まったラベルを付けておけば、そのシステムの行だけを表示できます。コードがどうやってその行に来たかを知りたいときは、debug.traceback() が現在の呼び出しスタックを文字列で返します。

ブレークポイントとステップ実行

ブレークポイントはゲームをその行で一時停止させるので、その瞬間のすべてを調べられます。Script Editor で行番号の右の余白をクリックし(赤い丸が出ます)、プレイテストを始めます。実行がその行に来るとゲームが一時停止し、黄色の矢印が次の行を示します。そこからはステップ実行のボタンでコードを進めます:

  • Step Over(F10)は今の行を実行し、次の行で止まります。
  • Step Into(F11)は、その行で呼ばれている関数の中に入ります。
  • Step Out(Shift+F11)は今の関数を最後まで実行し、それを呼んだコードで止まります。
  • Resume Scripts は次のブレークポイントまで続けます。

余白を右クリックすると、便利な種類がさらに2つあります。条件付きブレークポイントは、amount < 0 のような式が真のときだけ一時停止します。Logpoint は一時停止せずに Output にメッセージを出すので、スクリプトを変えずに値を記録できます。

Watch と Call Stack

ゲームが一時停止している間は、Script Editor で変数にカーソルを合わせると値が見えます。Watch ウィンドウの Variables タブはスコープ内のすべての変数を表示し、My Watches タブでは coins.Value + amount のような好きな式を入力して今の値を見られます。Call Stack ウィンドウは、一時停止した行に来るまでにどの関数がどの関数を呼んだかを示します。どちらも Script タブか Window メニューから開けます。

Script Analysis と strict モード

Script Editor は入力中にその場で問題に下線を引き、Script タブの Analysis ボタンで開く Script Analysis ウィンドウは、すべてのスクリプトのエラーと警告を表示します。構文エラーや未知の名前を Play の前に見つけてくれます。スクリプトの1行目に --!strict を書くと Luau の厳格な型チェックが有効になり、プロパティのつづり間違い、引数の型の間違い、nil になりうる値も知らせてくれます。ただし、実行中のゲームは見えません。Workspace にないパーツは Output でしかわかりません。

Command bar

Command bar(Script タブ、または Ctrl+9、Mac では ⌘9)は Luau をすぐに実行します。ゲームの実行中なら、ちょっとした質問をするのに便利です。print(workspace:FindFirstChild("Bridge")) でそのパーツがあるかがわかり、print(#game:GetService("Players"):GetPlayers()) でプレイヤーの数を数えられます。編集モードでは Command bar のコードが本当にプレイスを変えるので、オブジェクトを動かしたり消したりするものには注意してください。

公開中のゲームの Developer Console

Studio の Output は Studio の中でしか使えません。公開中のゲームでは、F9 を押すかチャットに /console と入力して Developer Console を開きます。その Log には自分の端末からの出力が表示され、ゲームの所有者か、編集権限のあるグループのメンバーならサーバーの出力も表示されます。

Roblox に組み込まれた Assistant も、個々のメッセージについて手伝ってくれます。Roblox 自身のガイドは、Output のエラーを貼り付けて Assistant に解説を頼むよう勧めています。Assistant が応答しなくなった、または上限に達したと表示される場合は、Assistant の上限とエラーを見てください。

RoCode でエラーを直す

RoCode は独立した Roblox Studio 向けの AI エージェントです。ウェブチャットで問題を説明すると、Studio プラグインが開いているプレイスを読んで編集します。エラーについては、あなたがすでに実行したプレイテストをもとに、上の手順のうち読み取りの部分を引き受けられます。

あなたの入力

Play を押したけど、ショップのボタンをクリックしても何も起きない。Output には attempt to index nil with 'Coins' と出てる。原因を見つけて直して。

RoCode の作業
  • Check Output ツールで Studio の Output を読みます。最後のプレイテストの Server と Client の行も、あなたが Stop を押したあとでも読めます
  • Read Script でエラーのスクリプトを開いてその行のまわりのコードを読み、Search Scripts で、足りない値がどこで作られるはずだったかを探せます
  • Edit Script でピンポイントの修正(そのスクリプト内の正確な検索と置換)を行い、そのあと Check Script を実行します。これは Studio の中でスクリプトをコンパイルするもので、型チェックやリンターの実行、コードの実行はしません
  • 変更をまとまりごとに Studio へ送り、まとまりの一つひとつが Studio の取り消し履歴の取り消しポイントになります

もう一度 Play を押してショップのボタンをクリックし、直ったことを自分で確かめてください。プラグイン 3.9 以降の RoCode は短いプレイテストを行ってエラーを読めます。プラグイン 3.9.15 以降ではテスト用キャラクターが画面のボタンを押せますが、確認するのは自分でテストすると決めたことだけで、コンパイルチェックではゲームのロジックが正しいかはわかりません。エラーの読み取りはどのビルドにも含まれています。ゲーム全体のビルド、チェック、テストのサイクルでは、システムを1つ作るたびにこの確認を繰り返します。RoCode が Studio につながる仕組み。

よくある質問

エラーがないのに Roblox のスクリプトが動かないのはなぜですか?

たいていは、スクリプトがそもそも実行されていない(スクリプトの種類やコンテナが違う、Enabled がオフ)、まだ何かを待っている、または待っているイベントが発火しないかのどれかです。最初の行の print で、どれなのかがわかります。上のチェックリストを見てください。

Roblox の "attempt to index nil" はどういう意味ですか?

ドットやコロンの前の値が nil だったので、Roblox が中を見られなかったという意味です。player.Character.Humanoid という行で attempt to index nil with 'Humanoid' が出たら、player.Character が nil だった、つまり存在しないか、まだ読み込まれていなかったということです。使う前に if で値を確認し、LocalScript ではサーバーが作るオブジェクトを WaitForChild で待ってください。原因について詳しく。

Roblox の "infinite yield possible" はどういう意味ですか?

WaitForChild が、現れない子オブジェクトを5秒以上待っていて、まだ待ち続けているという意味です。名前や親が違うか、誰もそのオブジェクトを作っていないことがよくあります。原因について詳しく。

Output ウィンドウが空、または表示されないのはなぜですか?

Window メニューか Script タブから開いてください。開いているのにテスト中も空のままなら、フィルターと検索欄を解除し、何かを出力するはずのスクリプトが実行されているかを確認してください。

Roblox にスクリプトのエラーチェック機能はありますか?

はい、Studio に組み込まれています。Script Editor が入力中に問題に下線を引き、Script Analysis ウィンドウがそれを一覧にします。見つかるのは構文エラーと型のエラーで、存在しないオブジェクトやゲームロジックの誤りは見つかりません。それはコードを実行して初めてわかります。

エラーを出さないために、コードを pcall で包むべきですか?

コードの外の理由で失敗しうる呼び出し、たとえばデータストア、HTTP、MarketplaceService へのリクエストだけです。nil のエラーを pcall で包むとメッセージは消えますが、機能はやはり動きません。

公開中のゲームでスクリプトのエラーを見るには?

ゲーム中に F9 を押すか、チャットに /console と入力して Developer Console を開きます。自分の端末からのエラーが表示され、ゲームの所有者か、編集できるグループのメンバーならサーバーからのエラーも表示されます。

参考資料

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

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

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