要点
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 のどちらから来たかがわかります。
このページの内容
始める前に: Studio、Baseplate、Output ウィンドウ
必要なのは Roblox Studio と Roblox アカウントだけで、コードエディターもプラグインもいりません。このガイドのスクリプトはすべて、Studio の Script Editor で入力します。
- Windows と Mac 向けの Roblox の無料アプリ Roblox Studio をインストールし、Roblox アカウントでログインします。
- Studio を開きます。スタートページにテンプレートがあるので、Baseplate を選びます。4x4 のグリッド模様の床と、プレイ時にアバターが現れる場所である SpawnLocation が用意されます。
- Explorer と Properties のウィンドウが見えなければ、Window メニューか Home タブから開きます。Explorer はプレイスのすべてのオブジェクトを一覧にし、Properties は選択中のオブジェクトの設定を表示します。
- Window メニューか Script タブから Output を開きます。スクリプトのメッセージやエラーはここに出ます。
- Output ウィンドウの表示設定で、各メッセージに Client か Server の印を付ける Show Context と、どのスクリプトの何行目から来たかを表示する Show Source をオンにします。
| スクリプト | 種類 | 置く場所 | 学べること |
|---|---|---|---|
FirstScript | Script | ServerScriptService | 変数、関数、if 条件、ループ、テーブル |
ColourChanger | Script | Workspace の Part の中 | プロパティの変更、script.Parent、待ち時間のあるループ |
TouchPad | Script | Pad という名前の Part の中 | イベント、パーツに触れたプレイヤーの特定、debounce |
MyFirstLocalScript | LocalScript | StarterPlayer の中の StarterPlayerScripts | 1人のプレイヤーの端末で動くコード、キー入力、その端末に残るもの |
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: 最初のスクリプトを書く
- Explorer で ServerScriptService にカーソルを合わせ、+ を押して Script を選びます(ショートカットは Ctrl+I、Mac では ⌘I)。Studio がスクリプトを作り、Script Editor で開きます。
- 新しいスクリプトを右クリックして Rename を選び、
FirstScriptと名前を付けます。名前はスクリプトの動作を変えませんが、どのスクリプトが何を表示したかがわかります。 - 新しいスクリプトは
print("Hello world!")の1行から始まります。それを消して、下のコードを貼り付けます。 - 左側のリストで Test を選んだ状態で Play(F5)を押します。Studio がプレイテストを始め、アバターを SpawnLocation に置きます。
- Output の行を読んだら、Stop(Shift+F5)を押します。Stop はすべてのオブジェクトを Play を押す前の状態にも戻すので、プレイ中に動かしたり色を変えたりしたものは元に戻ります。
-- 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 と行番号の印も付きます。
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 プレイグラウンドでも動きます。そこで値を変えてもう一度実行し、何が変わるか見てみましょう。
| コード | 考え方 | 意味 |
|---|---|---|
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、end | if 条件 | 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 はプロパティで、スクリプトからも設定できます。
- Home タブで Part を押します。Studio が Workspace にブロックを追加します。名前は何でもかまいません。
- Explorer で新しいパーツにカーソルを合わせ、+ を押して Script を挿入します。名前を
ColourChangerに変え、中身を下のコードに置き換えます。 - Play を押します。パーツが1秒ごとに赤、青、緑と変わり、また最初に戻ります。
-- 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つ Part を挿入し、名前を正確に
Pad(P は大文字)に変えます。フォルダーやモデルの中ではなく、Workspace の直下に置いてください。ステップ4の LocalScript がそこを探すからです。 - 乗れる平らな台にします。たとえば Properties ウィンドウで
Sizeを6, 1, 6にします。SpawnLocation の近くの床に置き、動かないように Anchored にチェックを入れます。 - Pad にカーソルを合わせ、+ を押して Script を挿入し、名前を
TouchPadに変えて、下のコードを貼り付けます。 - Play を押してパッドに乗ります。パッドが2秒間黄色になり、Output にあなたの名前が出ます。
-- 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)
| コード | 役割 |
|---|---|
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人のプレイヤーの端末で動きます。キー入力、カメラ、画面上のメニューはそこで処理します。それを知っているのはその端末だけだからです。
- Explorer で StarterPlayer を展開し、StarterPlayerScripts にカーソルを合わせ、+ を押して LocalScript を挿入します。名前を
MyFirstLocalScriptに変え、下のコードを貼り付けます。 - Play を押します。Output に、Client の印付きで
Hello,とあなたの名前が出ます。 - ゲーム画面をクリックして E を押します。パッドが透けます。もう一度 E を押すと元に戻ります。
- プレイテスト中に、Studio のテスト用コントロールにある Client/Server の切り替えを押して、ゲームのサーバー側のコピーに移ります。そこではパッドは不透明です。サーバーは変更について何も知らされていません。
-- 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 | サーバー | 全プレイヤー | ゲームのルール: コイン、ダメージ、ドア、ラウンド、保存 | ServerScriptService、学習中ならパーツの中 |
| LocalScript | 1人のプレイヤーの端末 | 自分のキャラクターの移動を除き、その端末だけ | 入力、カメラ、画面上のメニュー、1人向けのエフェクト | StarterPlayerScripts または StarterGui |
| ModuleScript | それに対して require() を呼んだ側 | 読み込んだスクリプトと同じ範囲 | 複数のスクリプトで共有するコード | 両側用なら ReplicatedStorage、サーバー専用なら ServerScriptService |
チーターが変えられるもの
チーターは自分の端末のすべてを操れると考えてください。自分の LocalScript を実行したり、あなたの LocalScript を書き換えたりできるので、パッドでも何でも、自分の画面では透明にできます。ここではそれは無害です。透明度は見た目だけで、その端末に残るからです。だからこそ、大事なことはすべてサーバーの Script が決めます。
サーバーの Script も自動的に安全なわけではありません。TouchPad はサーバーで動きますが、各プレイヤーの端末は自分のキャラクターの物理演算を担当していて、Roblox のセキュリティのドキュメントは、クライアントが自分の管理するパーツでできることとして、Touched が発生するタイミングの操作や、完全な発生の阻止を挙げています。光るパッドなら問題ありません。報酬を払うパッドでは、チェックポイントは順番どおりにしか認めないというオビーのガイドのルールのように、サーバー自身が追跡していることも確認してください。
ステップ5: 4つのスクリプトをまとめてテストする
- Ctrl+K(Mac では ⌘K)で Output をクリアし、Play(F5)を押します。Output に Server の印付きの FirstScript の8行と、Client の印付きのあなたの Hello の行が出ます。ColourChanger パーツは毎秒色が変わります。
- パッドに乗ります。2秒間黄色になり、Output にあなたの名前と「stepped on the pad」が1回出ます。パッドの上を歩き回ってみてください。新しい行は Touched が発生するたびではなく、最大でも2秒に1回しか出ません。
- E を押します。パッドが半透明(Transparency 0.6)になります。もう一度 E を押すと不透明に戻ります。
- Stop を押します。テストのリストで Server & Clients を選び、クライアントを 2 にして Play(または F7)を押します。Studio がサーバーのウィンドウと2つのクライアントのウィンドウを開きます。片方のクライアントで E を押すと、そちらではパッドが透けますが、もう片方のクライアントとサーバーでは不透明なままです。終わったら End Session を押します。
- わざと何かを壊してみましょう。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 にこう出ます:
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'
end の抜けのような、コードの書き方の誤りは Play を押す前から見えます。Script Editor が赤い下線を引き、Script Analysis ウィンドウ(Script タブの Analysis ボタン)が一覧にします。こうした誤りのあるスクリプトはまったく実行されず、誤りより上の行も動きません。
| メッセージ | 意味 | 直し方 |
|---|---|---|
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 を押してみてください。サーバーでの変更はすべてのクライアントに届くので、クライアントにはサーバーが設定した色が見えます。
次に学ぶこと
これで、ほとんどのゲームのスクリプトを形づくる部品を使ったことになります。この先のおすすめの順番は次のとおりです:
- LocalScript、Script、ModuleScript の違い: 各スクリプトがどこで動き、何を変えられるかを、ステップ4より深く学べます。
- RemoteEvent: LocalScript がサーバーに何かを頼む方法と、サーバーがその要求を確認する方法。
- リーダーボード: サーバーで作って変更する、あなたの最初のステータス。
- 最初のゲーム: 2つのサーバースクリプトで、溶岩、コイン、ゴールのパッドがある短いコースを作り、公開します。
- その次はシステムを選びましょう: ショップ 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 を使っているのかも。
- 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 Creator Docs: Luau(英語). Luau とは何か、どこから来たか
- Roblox Creator Docs: Roblox Studio setup(英語). Windows と Mac、システム要件
- Roblox Creator Docs: Output(英語). Output の開き方、フィルター、Show Context と Show Source
- Roblox Creator Docs: Studio testing modes(英語). Play、Run、Stop、Client/Server の切り替え、Server & Clients
- Roblox Creator Docs: Script Editor(英語). 新しいスクリプトが開く場所と Script Analysis
- Roblox Creator Docs: Script types and locations(英語). 各スクリプトの種類が動く場所と、パーツ内のスクリプトの代わりにタグを使う方法
- Roblox Creator Docs: Script(英語). Script が動き始めるタイミング
- Roblox Creator Docs: Control structures(英語). 条件、ループ、無限ループに待ち時間が必要な理由
- Roblox Creator Docs: Events(英語). Connect と、Touched が関数に渡すもの
- Roblox Creator Docs: Debounce patterns(英語). 1回の接触で Touched が何度も発生する理由
- Roblox Creator Docs: wait(英語). グローバルの wait() と task.wait()
- Roblox Creator Docs: Network ownership, movement validation and physics exploits(英語). クライアントが自分のキャラクターでできること
- Roblox Creator Docs: Coding fundamentals(英語). Roblox の初心者向けシリーズ
コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。