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

Roblox Studio でスクリプトを書く方法:初心者向けガイド

Roblox Studio でのスクリプト、つまりプログラミングとは、Roblox 版の Lua 言語である Luau を、プレイスに追加したスクリプトの中に書くことです。このガイドは空の Baseplate から始めます。Output ウィンドウを開き、最初のスクリプトを書き、コードからパーツを変え、パッドに乗ったプレイヤーに反応し、LocalScript を試します。その途中で、変数、関数、条件、ループ、イベントを理解していきます。

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

要点

Roblox Studio でスクリプトを書くには、Explorer で ServerScriptService にカーソルを合わせ、+ を押して Script を挿入します。Studio がそれを Script Editor で開きます。たとえば print("Hello") のような Luau を書き、Play(F5)を押して、結果を Output ウィンドウ(Window メニューまたは Script タブ)で読みます。Script はサーバーで実行され、全員に対して変更を加えます。StarterPlayerScripts の LocalScript は、1人のプレイヤーの端末で実行されます。

  • まず4つの考え方を覚えましょう。変数(local coins = 3)、関数(local function name() ... end)、if 条件、イベント(part.Touched:Connect(...))です。このガイドの4つのスクリプトは、これにループとテーブルを加えたものでできています。
  • wait() ではなく task.wait() を使ってください。Roblox のリファレンスでは、グローバルの wait() は非推奨で task.wait() に置き換えられたとされています。
  • Output ウィンドウの表示設定で Show Context をオンにすると、各行が Server と Client のどちらから来たかがわかります。
このページの内容
  1. 始める前に
  2. 1. 最初のスクリプト
  3. 2. パーツを変える
  4. 3. イベント
  5. 4. 最初の LocalScript
  6. 5. テスト
  7. スクリプトを置く場所
  8. エラーの読み方
  9. 古いチュートリアル
  10. 練習
  11. 次に学ぶこと
  12. Common errors
  13. RoCode で
  14. よくある質問
  15. 参考資料

始める前に: Studio、Baseplate、Output ウィンドウ

イラスト1回のプレイテストで4つのスクリプトが動きます。ColourChanger パーツは毎秒色が変わり、Pad に乗ると全プレイヤーに対して2秒間黄色になって Output にあなたの名前が出て、E を押すとこの画面でだけ Pad が透けます。

必要なのは Roblox Studio と Roblox アカウントだけで、コードエディターもプラグインもいりません。このガイドのスクリプトはすべて、Studio の Script Editor で入力します。

  1. Windows と Mac 向けの Roblox の無料アプリ Roblox Studio をインストールし、Roblox アカウントでログインします。
  2. Studio を開きます。スタートページにテンプレートがあるので、Baseplate を選びます。4x4 のグリッド模様の床と、プレイ時にアバターが現れる場所である SpawnLocation が用意されます。
  3. Explorer と Properties のウィンドウが見えなければ、Window メニューか Home タブから開きます。Explorer はプレイスのすべてのオブジェクトを一覧にし、Properties は選択中のオブジェクトの設定を表示します。
  4. Window メニューか Script タブから Output を開きます。スクリプトのメッセージやエラーはここに出ます。
  5. Output ウィンドウの表示設定で、各メッセージに Client か Server の印を付ける Show Context と、どのスクリプトの何行目から来たかを表示する Show Source をオンにします。
これから書く4つのスクリプト
スクリプト種類置く場所学べること
FirstScriptScriptServerScriptService変数、関数、if 条件、ループ、テーブル
ColourChangerScriptWorkspace の Part の中プロパティの変更、script.Parent、待ち時間のあるループ
TouchPadScriptPad という名前の Part の中イベント、パーツに触れたプレイヤーの特定、debounce
MyFirstLocalScriptLocalScriptStarterPlayer の中の StarterPlayerScripts1人のプレイヤーの端末で動くコード、キー入力、その端末に残るもの
最後の Explorer(このガイドのオブジェクトのみ)
Workspace
  Baseplate Part
  SpawnLocation SpawnLocation
  Part Part new
    ColourChanger Script new
  Pad Part new
    TouchPad Script new
ServerScriptService
  FirstScript Script new
StarterPlayer
  StarterPlayerScripts
    MyFirstLocalScript LocalScript new

ステップ1: 最初のスクリプトを書く

  1. Explorer で ServerScriptService にカーソルを合わせ、+ を押して Script を選びます(ショートカットは Ctrl+I、Mac では ⌘I)。Studio がスクリプトを作り、Script Editor で開きます。
  2. 新しいスクリプトを右クリックして Rename を選び、FirstScript と名前を付けます。名前はスクリプトの動作を変えませんが、どのスクリプトが何を表示したかがわかります。
  3. 新しいスクリプトは print("Hello world!") の1行から始まります。それを消して、下のコードを貼り付けます。
  4. 左側のリストで Test を選んだ状態で Play(F5)を押します。Studio がプレイテストを始め、アバターを SpawnLocation に置きます。
  5. Output の行を読んだら、Stop(Shift+F5)を押します。Stop はすべてのオブジェクトを Play を押す前の状態にも戻すので、プレイ中に動かしたり色を変えたりしたものは元に戻ります。
Script 場所: ServerScriptService 名前: FirstScript
-- ServerScriptService の Script、名前は FirstScript。
-- 最初の Luau: 変数、関数、if 条件、ループ、テーブル。
-- Play(F5)を押して、結果を Output ウィンドウで読みます。

-- 変数とは値を保存する名前です
local gameName = "Coin Run"
local coinsToWin = 3

-- 関数とは、何度でも実行できる名前付きのコードのまとまりです。
-- name と goal はその引数で、return は呼び出し元に値を返します。
local function describe(name: string, goal: number): string
	return `{name}: collect {goal} coins to win`
end

print(describe(gameName, coinsToWin)) --> Coin Run: collect 3 coins to win

-- if 条件は、条件が真のときだけコードを実行します
if coinsToWin > 5 then
	print("That is a long game")
elseif coinsToWin > 1 then
	print("That is a short game")
else
	print("One coin and you win")
end

-- for ループはコードを決まった回数繰り返します
for count = 1, coinsToWin do
	print("Coin number", count)
end

-- テーブルは値のリストを保存し、このループはそれを順番にたどります
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
	print(position, colour) --> 1 Red、次に 2 Green、次に 3 Blue
end

行の中で -- より後ろはすべてコメントです。Luau はそこを読み飛ばすので、自分用のメモを残せます。--> のコメントは、その行が何を表示するかを示しています。

Output には、Studio 自体のメッセージに混じって次の8行が出るはずです。print に複数の値を渡すと、間にスペースが入ります。Show Context と Show Source をオンにしていれば、各行には Server と、FirstScript と行番号の印も付きます。

Output(期待される結果)
Coin Run: collect 3 coins to win
That is a short game
Coin number 1
Coin number 2
Coin number 3
1 Red
2 Green
3 Blue

各行を、それを表示したコードと照らし合わせてみてください。あとでエラーメッセージでも同じことをするので、この習慣が役に立ちます。

FirstScript は Roblox のオブジェクトを使わない純粋な Luau だけなので、ブラウザで使える無料の Luau プレイグラウンドでも動きます。そこで値を変えてもう一度実行し、何が変わるか見てみましょう。

FirstScript の各部分の役割
コード考え方意味
local gameName = "Coin Run"変数値を保存する名前です。local は、このスクリプトか、それが書かれたブロックの中でしか使えないという意味です。引用符で囲んだテキストは文字列、3 は数値です。名前は大文字と小文字を区別するので、coinsToWin と CoinsToWin は別の変数です。
local function describe(name: string, goal: number): string関数何度でも実行できる名前付きのコードのまとまりです。name と goal はその引数で、呼び出すたびに渡される値です。: string と : number は省略可能な型注釈です。Luau はこれを使って Script Editor でミスを警告しますが、なくてもコードは同じように動きます。
return戻り値関数を呼び出したコードに値を返します。print(describe(gameName, coinsToWin)) は describe が返したものを表示します。
`{name}: collect {goal} coins to win`文字列補間バッククォートで囲んだテキストには値を入れられます。Luau は {name} と {goal} をその時点の値に置き換えます。
if、elseif、else、endif 条件Luau は条件を上から順に調べ、最初に真になったものだけを実行します。coinsToWin は 3 で、5 より大きくはありませんが 1 より大きいので、「That is a short game」だけが表示されます。
for count = 1, coinsToWin do数値の for ループ1 から coinsToWin までの各数値について中のコードを1回ずつ実行し、count は 1、次に 2、次に 3 になります。
{ "Red", "Green", "Blue" } と for position, colour in colours doテーブルとループリストのようなテーブルで、Luau ではこれを配列と呼びます。位置は 0 ではなく 1 から始まります。ループは各要素をたどり、その位置と値を渡します。

function、if、for、while で始まるブロックは、どれも end で閉じます。end が1つ抜けているだけでスクリプト全体が動かなくなります。エラーの読み方のセクションで、どんなメッセージが出るかを示します。

ステップ2: スクリプトからパーツを変える

スクリプトが役に立つのは、ワールドの中の何かを変えるときです。Properties ウィンドウに見える設定、たとえばパーツの Color、Transparency、Anchored はプロパティで、スクリプトからも設定できます。

  1. Home タブで Part を押します。Studio が Workspace にブロックを追加します。名前は何でもかまいません。
  2. Explorer で新しいパーツにカーソルを合わせ、+ を押して Script を挿入します。名前を ColourChanger に変え、中身を下のコードに置き換えます。
  3. Play を押します。パーツが1秒ごとに赤、青、緑と変わり、また最初に戻ります。
Script 場所: Workspace の任意のパーツ 名前: ColourChanger
-- Workspace の Part の中の Script、名前は ColourChanger。
-- スクリプトは Properties ウィンドウに見えるのと同じプロパティを変えます。
-- このスクリプトは、全プレイヤーに対して、自分のパーツの色を毎秒変えます。

local part = script.Parent :: BasePart -- このスクリプトが入っているパーツ

local colours = {
	Color3.fromRGB(255, 85, 85), -- 赤
	Color3.fromRGB(85, 170, 255), -- 青
	Color3.fromRGB(85, 255, 127), -- 緑
}

part.Anchored = true -- 固定したパーツは置いた場所から動かない

local index = 1
while true do
	part.Color = colours[index]
	index = index % #colours + 1 -- 1、2、3、そしてまた 1
	task.wait(1) -- 1秒待つ(古い wait() は非推奨)
end
  • script.Parent はスクリプトが入っているオブジェクトで、ここではパーツです。スクリプトを別のパーツにドラッグすると、そちらを変えるようになります。
  • :: BasePart は型キャストです。親がパーツであることを Script Editor に伝え、使っているプロパティをチェックさせます。Luau は型を警告とヒントにしか使わないので、キャストしてもその行の動作は変わりません。
  • part.Color と part.Anchored は Properties ウィンドウのものと同じプロパティで、名前も同じです。Roblox はアメリカ式のつづりを使うので、スクリプト名が ColourChanger でもプロパティは Color です。
  • Anchored = true はパーツをその場に留めます。Roblox のリファレンスでは、固定されたパーツは重力、衝突、その他の物理演算で動くことはないとされています。
  • colours[index] はリストの要素を1つ読み出します。#colours はリストの長さで 3、% は割り算の余りなので、index % #colours + 1 は 1、2、3、1、2、3 と数えます。
  • while true do は永遠に繰り返すので、中の task.wait(1) がとても重要です。Roblox のドキュメントでは、無限ループには必ず task.wait() のような待ち時間を入れるよう書かれています。入れないとゲームが固まり、Studio がクラッシュします。

ColourChanger は Script なのでサーバーで動き、全プレイヤーが同じ色を同時に見ます。ステップ4では別の種類のスクリプトを扱います。

ステップ3: イベントでプレイヤーに反応する

ゲームのコードの大部分は、何かが起きるのを待っています。プレイヤーが参加した、パーツに触れた、ボタンが押された、などです。Roblox ではこれをイベントと呼びます。イベントが発生したときにコードを実行するには、イベントに関数を接続します。

  1. もう1つ Part を挿入し、名前を正確に Pad(P は大文字)に変えます。フォルダーやモデルの中ではなく、Workspace の直下に置いてください。ステップ4の LocalScript がそこを探すからです。
  2. 乗れる平らな台にします。たとえば Properties ウィンドウで Size を 6, 1, 6 にします。SpawnLocation の近くの床に置き、動かないように Anchored にチェックを入れます。
  3. Pad にカーソルを合わせ、+ を押して Script を挿入し、名前を TouchPad に変えて、下のコードを貼り付けます。
  4. Play を押してパッドに乗ります。パッドが2秒間黄色になり、Output にあなたの名前が出ます。
Script 場所: Workspace.Pad 名前: TouchPad
-- Workspace の Pad という名前の Part の中の Script、スクリプト名は TouchPad。
-- イベント: プレイヤーがパッドに乗ると黄色く光り、Output に誰だったかを書きます。
-- debounce は、プレイヤーが乗っている間にコードが1秒に何度も動くのを防ぎます。

local Players = game:GetService("Players")

local pad = script.Parent :: BasePart
local COOLDOWN_SECONDS = 2

local normalColour = pad.Color
local busy = false

local function onTouched(otherPart: BasePart)
	if busy then
		return -- 前回触れたときのクールダウン中
	end
	-- キャラクターとは、パッドに触れた体の部位(または帽子)が入っている Model です
	local character = otherPart:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	if not player then
		return -- 触れたのは単独のパーツか NPC で、プレイヤーではない
	end

	busy = true
	print(`{player.Name} stepped on the pad`)
	pad.Color = Color3.fromRGB(255, 220, 0)
	task.wait(COOLDOWN_SECONDS)
	pad.Color = normalColour
	busy = false
end

pad.Touched:Connect(onTouched)
TouchPad が接触からプレイヤーにたどり着くまで
コード役割
pad.Touched:Connect(onTouched)パッドの Touched イベントに関数を接続します。これで Roblox は、何かがパッドに触れるたびに onTouched を実行し、触れたパーツを渡します。
otherPartパッドに触れたパーツです。足、脚、帽子の持ち手、プレイヤーが手に持つツールなどです。プレイヤー自身であることは決してないので、続く2行でそれが誰のものかを調べます。
otherPart:FindFirstAncestorOfClass("Model")そのパーツから上にたどり、クラスがちょうど Model である最初の祖先、つまりキャラクターを見つけます。クラス名は完全に一致する必要があるので、帽子(Accessory クラス)や手に持ったツール(Tool クラス)は飛ばします。
Players:GetPlayerFromCharacter(character)それがキャラクターである Player を返します。NPC のように誰のキャラクターでもなければ nil を返します。前の character and は、モデルが見つからなかったときに呼び出しを飛ばし、player は nil のままになります。
if not player then return endプレイヤー以外のものならここで止まります。return は関数を途中で抜けます。

パッドに debounce が必要な理由

Roblox の debounce のページでは、パーツどうしが触れている間 Touched は続けて何度も発生し、歩いているキャラクターには体の部位がいくつもあると注意しています。チェックがなければ、パッドに1歩乗っただけで何行も表示され、黄色い光が何度も最初からやり直されるかもしれません。

busy 変数がまさに debounce です。最初の接触でこれが true になり、その後2秒間の接触はすべて if busy then return end に当たって止まります。task.wait(COOLDOWN_SECONDS) の後、パッドは色を戻し、busy は再び false になります。COOLDOWN_SECONDS が大文字なのは、プレイ中に変わらない設定だからです。Roblox は定数をこのように名付けるよう勧めています。

このパッドの debounce は全員で1つなので、その2秒の間に乗った2人目のプレイヤーは無視されます。光るパッドならそれで問題ありません。報酬を出すパッドは、リーダーボードのガイドのコインパッドのように、プレイヤーごとにクールダウンを持つべきです。

ステップ4: 最初の LocalScript と、その違い

動いているゲームは、1つのサーバーと、プレイヤーごとのクライアントでできています。ここまではすべて Script で、サーバーで動くので、その変更は全プレイヤーに届きます。LocalScript は1人のプレイヤーの端末で動きます。キー入力、カメラ、画面上のメニューはそこで処理します。それを知っているのはその端末だけだからです。

  1. Explorer で StarterPlayer を展開し、StarterPlayerScripts にカーソルを合わせ、+ を押して LocalScript を挿入します。名前を MyFirstLocalScript に変え、下のコードを貼り付けます。
  2. Play を押します。Output に、Client の印付きで Hello, とあなたの名前が出ます。
  3. ゲーム画面をクリックして E を押します。パッドが透けます。もう一度 E を押すと元に戻ります。
  4. プレイテスト中に、Studio のテスト用コントロールにある Client/Server の切り替えを押して、ゲームのサーバー側のコピーに移ります。そこではパッドは不透明です。サーバーは変更について何も知らされていません。
LocalScript 場所: StarterPlayerScripts 名前: MyFirstLocalScript
-- StarterPlayer > StarterPlayerScripts の LocalScript、名前は MyFirstLocalScript。
-- LocalScript は1人のプレイヤーの端末で動きます。E を押すと Pad はあなたの画面でだけ透けます。
-- ここからのパーツの変更は、サーバーにもほかの人にも届かないからです。

local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")

local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- Output に Client の印付きで出る

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	if gameProcessed then
		return -- キーは別のこと、たとえばチャットの入力に使われた
	end
	if input.KeyCode == Enum.KeyCode.E then
		local pad = workspace:FindFirstChild("Pad")
		if pad and pad:IsA("BasePart") then
			pad.Transparency = if pad.Transparency == 0 then 0.6 else 0
		end
	end
end)
  • Players.LocalPlayer は、スクリプトが動いている端末のプレイヤーです。Roblox がこれを設定するのは LocalScript と、それが読み込む ModuleScript だけなので、サーバーのコードでは使えません。
  • UserInputService.InputBegan は、プレイヤーがキーを押す、クリックする、タップするのを始めたときに発生します。gameProcessed は、ボタンのクリックやチャット欄でのキー入力のように、エンジンがすでにその入力を使ったときに true になるので、スクリプトはそれを無視します。
  • workspace:FindFirstChild("Pad") は Pad という名前の子を返し、なければ nil を返します。pad:IsA("BasePart") は、スクリプトが Transparency を変える前に、それが本当にパーツかどうかを確かめます。
  • if pad.Transparency == 0 then 0.6 else 0 は if 式で、2つの値のどちらかを選びます。Transparency 0 は完全に見える状態、1 は見えない状態です。
  • Shift ダッシュのスクリプトは、2つ目の LocalScript にぴったりです。キーを待ち受けて、キャラクターの WalkSpeed を変えます。
Script、LocalScript、ModuleScript
種類動く場所変更が届く範囲用途よく置く場所
Scriptサーバー全プレイヤーゲームのルール: コイン、ダメージ、ドア、ラウンド、保存ServerScriptService、学習中ならパーツの中
LocalScript1人のプレイヤーの端末自分のキャラクターの移動を除き、その端末だけ入力、カメラ、画面上のメニュー、1人向けのエフェクトStarterPlayerScripts または StarterGui
ModuleScriptそれに対して require() を呼んだ側読み込んだスクリプトと同じ範囲複数のスクリプトで共有するコード両側用なら ReplicatedStorage、サーバー専用なら ServerScriptService

チーターが変えられるもの

チーターは自分の端末のすべてを操れると考えてください。自分の LocalScript を実行したり、あなたの LocalScript を書き換えたりできるので、パッドでも何でも、自分の画面では透明にできます。ここではそれは無害です。透明度は見た目だけで、その端末に残るからです。だからこそ、大事なことはすべてサーバーの Script が決めます。

サーバーの Script も自動的に安全なわけではありません。TouchPad はサーバーで動きますが、各プレイヤーの端末は自分のキャラクターの物理演算を担当していて、Roblox のセキュリティのドキュメントは、クライアントが自分の管理するパーツでできることとして、Touched が発生するタイミングの操作や、完全な発生の阻止を挙げています。光るパッドなら問題ありません。報酬を払うパッドでは、チェックポイントは順番どおりにしか認めないというオビーのガイドのルールのように、サーバー自身が追跡していることも確認してください。

ステップ5: 4つのスクリプトをまとめてテストする

  1. Ctrl+K(Mac では ⌘K)で Output をクリアし、Play(F5)を押します。Output に Server の印付きの FirstScript の8行と、Client の印付きのあなたの Hello の行が出ます。ColourChanger パーツは毎秒色が変わります。
  2. パッドに乗ります。2秒間黄色になり、Output にあなたの名前と「stepped on the pad」が1回出ます。パッドの上を歩き回ってみてください。新しい行は Touched が発生するたびではなく、最大でも2秒に1回しか出ません。
  3. E を押します。パッドが半透明(Transparency 0.6)になります。もう一度 E を押すと不透明に戻ります。
  4. Stop を押します。テストのリストで Server & Clients を選び、クライアントを 2 にして Play(または F7)を押します。Studio がサーバーのウィンドウと2つのクライアントのウィンドウを開きます。片方のクライアントで E を押すと、そちらではパッドが透けますが、もう片方のクライアントとサーバーでは不透明なままです。終わったら End Session を押します。
  5. わざと何かを壊してみましょう。Pad の名前を Pad2 に変えてゲームを実行します。パッドに乗るとまだ黄色になります。TouchPad は名前ではなく script.Parent で自分のパーツを見つけるからです。E を押しても何も起きず、エラーも出ません。FindFirstChild("Pad") が nil を返し、if pad and ... のチェックが残りを黙って飛ばしたからです。FindFirstChild の次の行に print(pad) を加え、実行して E を押すと、Output に nil と出ます。こうした print は、スクリプトが何もしない理由を知るいちばん早い方法です。ゲームを止め、print の行を消して、パーツの名前を Pad に戻してください。

スクリプトを置く場所

スクリプトがどこにあるかで、そもそも実行されるかどうかが決まります。そして、決して実行されない場合でも Studio は警告しません。次に書くスクリプトのために:

各種スクリプトを置く場所
コンテナ置くもの理由
ServerScriptServiceゲームのルールの大半を担うスクリプト: 報酬、ラウンド、保存サーバーで動き、ServerScriptService の中身はプレイヤーに送られません。
Workspace のパーツの中ColourChanger や TouchPad のように、1つのパーツに関わる Script学習中なら問題ありません。パーツは script.Parent です。本格的なプロジェクトでは、Roblox は代わりにパーツにタグを付けることを勧めています(下記参照)。
StarterPlayer の中の StarterPlayerScriptsほとんどの LocalScript: 入力、カメラ、1人向けのエフェクト各プレイヤーが参加時に自分のコピーを受け取ります。
StarterGui画面上のメニューを操作する、ScreenGui の中の LocalScript各プレイヤーが自分の UI のコピーを受け取ります。
ReplicatedStorageサーバーとクライアントの両方のコードが読み込む ModuleScript両側から見えます。初期設定の LocalScript や Script は、ここでは決して実行されません。

Roblox のスクリプトの配置に関するページでは、Workspace のパーツに直接スクリプトを入れること自体を避けるよう勧めています。パーツにタグを付け、CollectionService を使って1つの ModuleScript から扱うのです。それでもパーツの中のスクリプトはいちばん簡単な始め方で、学習中にオブジェクト1つか2つで使うなら問題ありません。ドアのガイドでは、全部のドアを1つのスクリプトで扱うタグのパターンを紹介しており、クライアントとサーバーのガイドには、どのコンテナがどのスクリプトを実行するかの完全な表があります。

うまくいかないとき: Output を読む

エラーは Output に赤で表示されます。どれも、起きた場所、つまりスクリプトの完全な名前と行番号から始まり、続いて何が問題かを伝えます。エラーをクリックすると、Studio がそのスクリプトのその行を開きます。たとえば TouchPad から if not player のチェックを消し、単独のパーツがパッドに落ちると、Output にこう出ます:

Output(例)
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'

end の抜けのような、コードの書き方の誤りは Play を押す前から見えます。Script Editor が赤い下線を引き、Script Analysis ウィンドウ(Script タブの Analysis ボタン)が一覧にします。こうした誤りのあるスクリプトはまったく実行されず、誤りより上の行も動きません。

見分けられるようにしておきたい3つのエラー
メッセージ意味直し方
Colour is not a valid member of Part "Workspace.Part"このオブジェクトには、まさにその名前のものがありません。ここではプロパティのつづりは Color です。つづりと大文字を Properties ウィンドウや Explorer と照らし合わせます。このエラーの詳細。
attempt to index nil with 'Name'コードが nil の値から何か(ここでは .Name)を読もうとしました。上の例では、パッドに触れたのが単独のパーツだったので player が nil でした。なぜその値が nil なのかを調べ、使う前に if で確認します。このエラーの詳細。
Expected 'end' (to close 'then' at line 2), got <eof>2行目の if に対応する end がありません。関数の場合は to close 'function' と出て、<eof> はファイルの終わりという意味です。最後の行ではなく、かっこ内の行を手がかりに、抜けている end を足します。メッセージの最後に「did you forget to close ... at line N?」と付くことがあります。これはインデントから Luau が推測したもので、違うブロックを指していることがあるので、まずかっこ内の行を確認してください。構文エラーの詳細。

スクリプトが何もせず Output も空なら、たいていはスクリプトが決して実行されない場所にあるか、発生しないイベントを待っています。エラーのガイドに何も言わないスクリプトのチェックリストと、Output の読み方の詳しい説明があります。

古いスクリプトのチュートリアルとの違い

動画やフォーラムの投稿でも勉強していると、古いパターンに出会います。重要なものを、それぞれが問題になる理由と合わせて挙げます。

古いチュートリアルのパターンと、このガイドでの代わりのやり方
チュートリアル問題このガイド
wait(1) で一時停止するRoblox のリファレンスでは、グローバルの wait() は非推奨で、task.wait() に置き換えられたとされています。task.wait(1)
Roblox の溶岩のレッスンのように、otherPart.Parent でキャラクターを探す帽子や手に持ったツールがパーツに触れると、otherPart.Parent はキャラクターではなく Accessory や Tool になるので、Humanoid が見つからず、接触が失われます。FindFirstAncestorOfClass("Model")、次に GetPlayerFromCharacter
debounce なしで Touched を使うTouched は1歩で続けて何度も発生するので、コードが何度も実行されます。busy フラグとクールダウン
Workspace のパーツの中に LocalScript を置くLocalScript はそこでは決して実行されません。1人のプレイヤーに属する場所からしか動きません。StarterPlayerScripts の LocalScript(理由)
part.Touched:connect(...) や table.getn(list) と書くRoblox の命名ガイドでは camelCase の API はほぼ非推奨とされ、リファレンスには Connect しか載っていません。table.getn は #list に置き換えられ非推奨です。:Connect(...) と #list
LocalScript でコインを変えたりダメージを与えたりする変更はそのプレイヤーの端末に残るので、ほかの誰にも見えず、サーバーも数えません。ゲームのルールはサーバーの Script に

練習: 試してみたい3つの変更

コードは読むより変えるほうが身につきます。自分のプレイスで1つずつ試し、そのたびに Play を押してください。

  • パッドでポイントがもらえるようにする。リーダーボードのガイドのステップ1の Leaderstats スクリプトを追加します。次に TouchPad の busy = true の後で、プレイヤーの leaderstats フォルダーを見つけ、Coins の値に 1 を足します。ヒント: player:FindFirstChild("leaderstats")、次に leaderstats:FindFirstChild("Coins")、次に coins.Value += 1。リーダーボードのガイドのコインパッドが、プレイヤーごとのクールダウン付きの完成版です。
  • ColourChanger で透明度も変える。ColourChanger が毎秒パーツの Transparency も変えるようにします。ヒント: { 0, 0.3, 0.6 } のような 0 から 1 までの数値の2つ目のテーブルを足し、part.Color の次の行で、同じ index を使ってそこから part.Transparency を設定します。
  • パッドの色を表示する。E を押したときに MyFirstLocalScript がパッドの Color を表示するようにします。ヒント: if pad and pad:IsA("BasePart") のブロックの中に print(pad.Color)。パッドが黄色の間に E を押してみてください。サーバーでの変更はすべてのクライアントに届くので、クライアントにはサーバーが設定した色が見えます。

次に学ぶこと

これで、ほとんどのゲームのスクリプトを形づくる部品を使ったことになります。この先のおすすめの順番は次のとおりです:

  1. LocalScript、Script、ModuleScript の違い: 各スクリプトがどこで動き、何を変えられるかを、ステップ4より深く学べます。
  2. RemoteEvent: LocalScript がサーバーに何かを頼む方法と、サーバーがその要求を確認する方法。
  3. リーダーボード: サーバーで作って変更する、あなたの最初のステータス。
  4. 最初のゲーム: 2つのサーバースクリプトで、溶岩、コイン、ゴールのパッドがある短いコースを作り、公開します。
  5. その次はシステムを選びましょう: ショップ GUI、ラウンドシステム、オビーのチェックポイント、ロード画面、キーを押して再生するアニメーション。何かが壊れたら、スクリプトのエラーのガイドがメッセージを読む手助けになります。チェックポイントのガイドはまだ英語のみです。

Roblox 自身のチュートリアル Coding fundamentals(英語)は、このガイドを補うのにぴったりです。変数と関数から、条件、ループ、配列、辞書を経て、ModuleScript でのコードの整理まで、Studio での小さなプロジェクト付きで6回のシリーズになっています。

よくあるエラーと対処法

最初のスクリプトの問題のほとんどは、名前の不一致、置き場所の間違い、待ち時間のないループです。テスト中は Output を開いたままにしてください。

Play を押すと Studio が固まる、または応答しなくなる

while true do のループに待ち時間がないので、ほかのことが何も実行できません。Roblox のドキュメントでは、task.wait() のような待ち時間のない無限ループはゲームを固まらせ、Studio をクラッシュさせるとされています。ColourChanger のように、すべての無限ループに task.wait() を入れてください。

パッドに乗っても何も起きない

TouchPad が LocalScript ではなく Script であること、Pad パーツの直下にあること、無効になっていないこと、そしてパッドの CanTouch プロパティにチェックが入っていることを確認してください。次に onTouched の中の最初の行に print("touched", otherPart.Name) を入れます。これが表示されなければイベントが発生していません。表示されるなら、問題はそれより下にあります。

E を押しても何も起きない

MyFirstLocalScript は StarterPlayerScripts の中の LocalScript でなければなりません。Workspace や ServerScriptService の LocalScript は決して実行されません。パーツの名前は正確に Pad で、Workspace の直下にある必要があります。まずゲーム画面をクリックし、チャットに入力していないことを確かめてください。スクリプトは、ゲームがすでに使ったキーを無視するからです。

自分の画面ではパーツが変わるのに、ほかのプレイヤーには変わらない

変更したのが LocalScript なので、変更はあなたの端末に残りました。サーバーの Script で変更するか、LocalScript から RemoteEvent でサーバーに頼むようにしてください。

ColourChanger はパーツの中では動くのに、ServerScriptService に入れると壊れる

script.Parent を自分のパーツとして使っているからです。ServerScriptService では親は ServerScriptService で、そこには Anchored も Color もないので、Output に「not a valid member」のエラーが出ます。パーツの中に置いておくか、パーツに名前を付けて名前で探してください。たとえば local part = workspace:WaitForChild("ColourPart") :: BasePart です。

Output に何も表示されない

Output ウィンドウが開いていて(Window メニューまたは Script タブ)、フィルターがかかっていないか確認してください。Output はメッセージの種類、Client か Server か、テキストで絞り込めます。開いていて何もないなら、スクリプトがおそらく実行されていません。何もしないスクリプトのチェックリストを参照してください。

行き詰まったら: RoCode

自分のプレイスのスクリプトで行き詰まったら、RoCode が一緒に読み解けます。RoCode は Roblox 製ではない、独立した Roblox Studio 向けの AI エージェントです。Web チャットに書くと、Studio のプラグインが Explorer の中でスクリプトを作ったり編集したりします。

学習中は Ask モードが便利です。スクリプトはあなたが書き、RoCode はすでにあるものを読んで質問に答えます。

あなたの入力

Pad パーツの中の TouchPad スクリプトが何をしているか、1行ずつ説明して。それと、なぜ debounce を使っているのかも。

RoCode の作業
  • Ask モードでは Search Scripts や Read Script などの読み取りツールだけを使い、プレイスは何も変えません
  • 直す必要があれば、何をどこで変えるかを伝え、Build への切り替えを提案します
  • Build モードではスクリプトをその場で編集し、それぞれを Check Script で確認します。これはコンパイルのチェックで、型チェックでもプレイテストでもありません
  • Check Output ツールで Studio の Output を読みます。Stop を押した後でも、直前のプレイテストの Server と Client の行を含みます

プラグイン 3.9 以降の Build モードでは、RoCode は短いプレイテストを実行してエラーを読み取れ、3.9.11 以降ではテスト用キャラクターも操作できますが、プレイ中にスクリーンショットは撮らないので、パッドに乗るのはやはりあなた自身です。RoCode が Studio に接続する仕組み。

よくある質問

Roblox Studio ではどこにスクリプトを書きますか?

Explorer で ServerScriptService などのコンテナにカーソルを合わせ、+ を押して Script を選びます。Studio がそれを Script Editor で開くので、そこに Luau を書きます。サーバーのスクリプトはふつう ServerScriptService に、LocalScript は StarterPlayerScripts か StarterGui に置きます。

Roblox Studio でスクリプトを実行するには?

Play(F5)を押します。Studio がプレイテストを始め、ServerScriptService や Workspace にある有効な Script はゲーム開始と同時に実行されます。StarterPlayerScripts の LocalScript は、あなたがプレイテストに参加したときに実行されます。Run(Play の横のリストで選ぶか F8)はアバターなしでゲームを動かすので、このガイドでは Play を使ってください。Stop(Shift+F5)でテストを終えます。既存のスクリプトを開くには、Explorer でダブルクリックします。

Roblox ではどのプログラミング言語を使いますか?

Luau です。Roblox はこれを、Lua 5.1 から派生した、速く、小さく、安全で、段階的な型付けを持つスクリプト言語と説明しているので、Lua のチュートリアルの多くは今でも役に立ちます。Luau にはバッククォートによる文字列補間や省略可能な型注釈などの機能が加わり、Roblox は task.wait のような独自のライブラリとオブジェクトを加えています。

Script と LocalScript の違いは何ですか?

Script はサーバーで動き、その変更は全プレイヤーに届きます。LocalScript は1人のプレイヤーの端末で、入力、カメラ、画面上のメニューのために動き、パーツ、値、UI への変更はその端末に残ります。クライアントとサーバーのガイド(英語)で、両方と ModuleScript を詳しく解説しています。

スマートフォンや iPad で Roblox Studio のスクリプトを書けますか?

Roblox のインストールページでは、Studio は Windows と Mac 向けの無料アプリとされ、スマートフォンやタブレット向けの版は挙げられていないので、スクリプトにはパソコンが必要です。

スクリプトが何もせず、エラーも出ないのはなぜですか?

たいていは、その種類のスクリプトが実行されない場所にある(Workspace の LocalScript や StarterPlayerScripts の Script)、無効になっている、または待っているイベントが発生していない、のどれかです。エラーのガイドにチェックリストがあります。

Roblox のスクリプトを覚えるのにどれくらいかかりますか?

正直な数字は誰にも言えません。どれだけ作るかによります。いちばん効くのは、自分のプレイスで小さなスクリプトを頻繁に書くことです。ここの4つのスクリプトを変えてみて、練習の課題に挑戦し、それから最初のゲームのガイドに進み、システムを1つずつ足していきましょう。

参考資料

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

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

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