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

Roblox の RemoteEvent:クライアントからサーバーへ、そして戻りも

LocalScript はほかのプレイヤーに見えるものを変えられず、サーバーの Script は1人のプレイヤーの画面に手が届きません。その間でメッセージを運ぶのが RemoteEvent です。このガイドでは、いちばんよく使う3つのパターン、答えを返す RemoteFunction、そして改造されたクライアントに悪用させないためのサーバー側の検証を作っていきます。

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

要点

RemoteEvent は、ふつう ReplicatedStorage に置くオブジェクトで、クライアントとサーバーの境界を越えてメッセージを運びます。LocalScript が FireServer を呼ぶと、サーバーは OnServerEvent でメッセージを受け取ります。そのとき1番目の引数として、送ってきた Player が付け加えられます。サーバーが FireClient(player, ...) か FireAllClients(...) を呼ぶと、LocalScript は OnClientEvent でメッセージを受け取ります。

  • RemoteFunction(InvokeServer と OnServerInvoke)は、クライアントが答えを必要とするときだけ使います。InvokeClient は避けてください。エラーを出した、退出した、または値を返さなかったクライアントが、サーバー側の呼び出しを壊します。
  • クライアントが送ってくるものは決して信用しないでください。サーバーで、各引数の型、範囲、所有権、プレイヤーとの距離、そしてリモートを呼ぶ頻度を確認します。
  • 関数、メタテーブル、相手側から見えないオブジェクトは、送る途中で失われます。UnreliableRemoteEvent はメッセージを失ったり順番を入れ替えたりすることがあり、1000バイトを超えるデータは捨てられます。
このページの内容
  1. リモートが必要な理由
  2. リモートの準備
  3. 1. クライアントからサーバー
  4. 2. サーバーからクライアント
  5. 3. サーバーから全員
  6. RemoteFunction
  7. 検証のチェックリスト
  8. 送れないもの
  9. nil が返る?
  10. UnreliableRemoteEvent
  11. 順番と上限
  12. 選び方
  13. Common errors
  14. RoCode で
  15. よくある質問
  16. 参考資料

RemoteEvent が必要な理由

イメージクリックのたびにサーバーにパーツを塗るよう頼むので、新しい色は両方のプレイヤーの画面に見えます。

どの Roblox ゲームも、1つのサーバーと、プレイヤーごとに1つのクライアントで動いています。主導権を持つのはサーバーです。新しいオブジェクトやプロパティの変更がすべてのプレイヤーに届くのは、サーバーがそれを行ったときだけです。LocalScript で行った変更は1台の端末にとどまります。例外は、プレイヤー自身のキャラクターのように、動きをそのクライアントが制御しているものなど、わずかです。そのため、クリックやキー入力で共有の世界を変えたいときはクライアントがサーバーに頼み、サーバーが1人のプレイヤーの画面に反応させたいときはクライアントに知らせる必要があります。Script と LocalScript の違いがまだよくわからないなら、先に Script vs LocalScript vs ModuleScript(英語)を読んでください。スクリプト自体が初めてなら、Roblox Studio でスクリプトを書く方法から始めましょう。

この境界を越えるために、Roblox は3つのオブジェクトを用意しています:

  • RemoteEvent:一方通行のメッセージ。送り手はすぐに処理を続けます。
  • RemoteFunction:答えを待つリクエスト。呼び出したコードは、相手側が値を返すまで一時停止します。
  • UnreliableRemoteEvent:失われたり順番どおりに届かなかったりすることがある一方通行のメッセージですが、ネットワークの負担が少なくて済みます。絶えず変わるデータに向いています。
どの呼び出しがどのイベントを発火させるか
向き送り手が呼ぶもの受け手が接続するもの受け手が受け取るもの
クライアントからサーバーLocalScript で remote:FireServer(...)Script で remote.OnServerEventメッセージを送った Player、続いてあなたの引数
サーバーから1つのクライアントScript で remote:FireClient(player, ...)LocalScript で remote.OnClientEventあなたの引数だけ
サーバーからすべてのクライアントScript で remote:FireAllClients(...)LocalScript で remote.OnClientEventあなたの引数だけ
クライアントが尋ね、サーバーが答えるremoteFunction:InvokeServer(...)remoteFunction.OnServerInvoke = function(player, ...)Player、続いてあなたの引数。呼び出した側は関数が返したものを受け取ります

クライアント同士が直接メッセージを送り合うことはできません。あるプレイヤーからほかのプレイヤーへ何かを伝えるには、それをサーバーに送ってそこで確認し、サーバーに FireClient か FireAllClients で転送させます。Roblox のセキュリティの推奨では、ここでのサーバーはただの中継役ではなく、門番として働きます。

リモートの置き場所

リモートは、サーバーとクライアントの両方から見える場所に置く必要があります。ふつうの置き場所は ReplicatedStorage です。Roblox のドキュメントには、場合によっては Workspace や Tool でもよいと書かれています。ServerStorage と ServerScriptService はサーバーからしか見えないので、そこにあるリモートを待つ LocalScript は永遠に待ち続けます。

  1. Explorer で ReplicatedStorage にカーソルを合わせ、+ ボタンを押して Folder を入れます。フォルダーの名前は Remotes にします。
  2. Remotes にカーソルを合わせ、+ を押して RemoteEvent を入れます。名前は役割がわかるもの、たとえば PaintRequest に変えます。
  3. リモートごとに繰り返します。このガイドでは RemoteEvent を2つ(PaintRequest と Notify)、RemoteFunction を1つ(RedeemCode)使います。
Explorer:このガイドでセクションごとに追加するものすべて
ReplicatedStorage
  Remotes  Folder  new
    PaintRequest  RemoteEvent  new
    Notify  RemoteEvent  new
    RedeemCode  RemoteFunction  new
ServerScriptService
  PaintServer  Script  new
  WelcomeServer  Script  new
  FinishAnnouncer  Script  new
  RedeemServer  Script  new
  RemoteGuard  ModuleScript  new
StarterPlayer
  StarterPlayerScripts
    PaintClient  LocalScript  new
    NotifyClient  LocalScript  new
StarterGui
  CodeGui  ScreenGui  new
    CodeBox  TextBox  new
      RedeemClient  LocalScript  new
Workspace
  Paintable  Folder  new
  FinishLine  Part  new

このガイドのスクリプトは WaitForChild でリモートを見つけます。リモートがすでにあればすぐに結果を返し、まだなければ待ちます。たとえば、サーバーのスクリプトがゲーム中にリモートを作る場合です。リクエストの種類ごとに別のリモートを用意しましょう。そうすれば、サーバーの各ハンドラーが確認する引数の形は1つだけになり、1つのリモートですべてをまかなうよりずっと正しく書きやすくなります。

パターン1:クライアントからサーバーへ、サーバーで検証

いちばんよくある作業です。プレイヤーが自分の画面で何かをして、何が起きるかはサーバーが決めます。ここでは、プレイヤーが Q を押して4色の中から1色を選び、パーツをクリックまたはタップして塗ります。塗るのはサーバーなので、新しい色は全員に見えます。

クライアントが送るのは2つ、どのパーツかと、色の番号です。色そのものは決して送りません。ほかのゲームでも同じように、値段、報酬、ダメージの大きさを送ってはいけません。改造されたクライアントは何でも送れるので、本当のデータ(ここではパレット)はサーバーが持ち、引数は確認が必要なリクエストとして扱います。

  1. Workspace に Paintable という名前の Folder を入れ、その中に Anchored の Part をいくつか置きます。
  2. ReplicatedStorage.Remotes に PaintRequest という名前の RemoteEvent があることを確認します。
  3. 下のコードで、ServerScriptService に PaintServer という名前の Script を、StarterPlayer の StarterPlayerScripts に PaintClient という名前の LocalScript を入れます。
Script 場所: ServerScriptService 名前: PaintServer
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local remotes = ReplicatedStorage:WaitForChild("Remotes")
local paintRequest = remotes:WaitForChild("PaintRequest") :: RemoteEvent
local paintable = workspace:WaitForChild("Paintable")

-- 色はサーバーのもの。クライアントは、そのうち1つを選ぶ番号だけを送る。
local PALETTE = {
	Color3.fromRGB(231, 76, 60),
	Color3.fromRGB(46, 204, 113),
	Color3.fromRGB(52, 152, 219),
	Color3.fromRGB(241, 196, 15),
}
local MAX_DISTANCE = 30 -- キャラクターとパーツの間のスタッド数
local COOLDOWN_SECONDS = 0.25

local lastPaint: { [Player]: number } = {}

-- 1番目の引数は常に、リモートを呼んだプレイヤー。これは Roblox が入れるので
-- 信用してよい。その後ろはすべてクライアントから来たもので、信用してはいけない。
paintRequest.OnServerEvent:Connect(function(player: Player, part: unknown, colourIndex: unknown)
	-- 1. 型:パーツのふりをしたテーブルではなく、本物のパーツ
	if typeof(part) ~= "Instance" or not part:IsA("BasePart") then
		return
	end

	-- 2. 範囲:1から4の整数。NaN と無限大もここで弾かれる。
	if type(colourIndex) ~= "number" or not math.isfinite(colourIndex) then
		return
	end
	if colourIndex % 1 ~= 0 or colourIndex < 1 or colourIndex > #PALETTE then
		return
	end

	-- 3. 許可された対象:Paintable フォルダーの中のパーツだけで、ゲーム内のほかのものは不可
	if not part:IsDescendantOf(paintable) then
		return
	end

	-- 4. 距離:プレイヤーのキャラクターがパーツの近くにいること
	local character = player.Character
	local root = character and character:FindFirstChild("HumanoidRootPart")
	if not (root and root:IsA("BasePart")) then
		return
	end
	if (root.Position - part.Position).Magnitude > MAX_DISTANCE then
		return
	end

	-- 5. 頻度の上限:プレイヤーごとに0.25秒に1回まで塗れる
	local now = os.clock()
	local last = lastPaint[player]
	if last and now - last < COOLDOWN_SECONDS then
		return
	end
	lastPaint[player] = now

	part.Color = PALETTE[colourIndex]
end)

Players.PlayerRemoving:Connect(function(player: Player)
	lastPaint[player] = nil
end)

どの確認も、通らなければただ return します。チートをしているクライアントに、断った理由を説明する必要はありません。

LocalScript 場所: StarterPlayerScripts 名前: PaintClient
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")

local remotes = ReplicatedStorage:WaitForChild("Remotes")
local paintRequest = remotes:WaitForChild("PaintRequest") :: RemoteEvent
local paintable = workspace:WaitForChild("Paintable")

local COLOUR_COUNT = 4 -- 本当の色はサーバーが持っている
local selectedColour = 1

-- レイが当たるのは Paintable フォルダーの中のパーツだけ
local rayParams = RaycastParams.new()
rayParams.FilterType = Enum.RaycastFilterType.Include
rayParams.FilterDescendantsInstances = { paintable }

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	if gameProcessed then
		return -- キーやクリックはチャットかボタンに使われた
	end

	if input.KeyCode == Enum.KeyCode.Q then
		selectedColour = selectedColour % COLOUR_COUNT + 1
		return
	end

	local isClick = input.UserInputType == Enum.UserInputType.MouseButton1
	local isTap = input.UserInputType == Enum.UserInputType.Touch
	if isClick or isTap then
		local camera = workspace.CurrentCamera
		local ray = camera:ScreenPointToRay(input.Position.X, input.Position.Y)
		local result = workspace:Raycast(ray.Origin, ray.Direction * 500, rayParams)
		if result then
			-- 命令ではなくお願い:塗るかどうかはサーバーが決める
			paintRequest:FireServer(result.Instance, selectedColour)
		end
	end
end)

gameProcessed は、エンジンがその入力をすでに処理したとき、ふつうは UI で処理したときに true になります。ボタンのクリックや、チャット欄のようなテキストボックスに入力したキーです。この確認があるので、メッセージの中で打った Q で色が変わることはありません。

パターン2:サーバーから1つのクライアントへ

サーバーは FireClient で1人のプレイヤーにメッセージを送ります。1番目の引数は宛先の Player で、クライアントのハンドラーが受け取るのはその後ろの引数だけです。通知、報酬のウィンドウ、そのプレイヤーにだけ聞こえるべき音など、個人的なものすべてに使います。カットシーンのガイドは、もっと大きな実例です。プレイヤーがカットシーンを見るタイミングをサーバーが決め、そのコマを FireClient でその1人に送り、カメラはその人の端末が動かします。

この2つのスクリプトは、プレイヤーが参加したときにあいさつを表示します。LocalScript が小さなバナーを自分で組み立てるので、GUI の準備は必要ありません。

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

local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent

local function welcome(player: Player)
	-- 1番目の引数で、どのクライアントがメッセージを受け取るかを選ぶ。ほかの誰にも見えない。
	notify:FireClient(player, `Welcome, {player.DisplayName}! Press Q to change colour.`)
end

Players.PlayerAdded:Connect(welcome)

-- Studio ではこのスクリプトが接続する前に参加できるので、すでにいる全員にもあいさつする
for _, player in Players:GetPlayers() do
	welcome(player)
end
LocalScript 場所: StarterPlayerScripts 名前: NotifyClient
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local player = Players.LocalPlayer

-- 画面上部の小さなバナー。コードで組み立てる
local gui = Instance.new("ScreenGui")
gui.Name = "Notifications"
gui.ResetOnSpawn = false
gui.Parent = player:WaitForChild("PlayerGui")

local label = Instance.new("TextLabel")
label.AnchorPoint = Vector2.new(0.5, 0)
label.Position = UDim2.new(0.5, 0, 0, 16)
label.Size = UDim2.fromOffset(420, 44)
label.BackgroundColor3 = Color3.fromRGB(18, 11, 31)
label.TextColor3 = Color3.new(1, 1, 1)
label.TextScaled = true
label.Visible = false
label.Parent = gui

local messageCount = 0

-- ここに player 引数はない:誰が受け取るかはサーバーがもう選んでいる
notify.OnClientEvent:Connect(function(message: string)
	messageCount += 1
	local thisMessage = messageCount
	label.Text = message
	label.Visible = true
	task.delay(4, function()
		if messageCount == thisMessage then -- もっと新しいメッセージに置き換わっていなければ隠す
			label.Visible = false
		end
	end)
end)

サーバーは PlayerAdded でメッセージを送りますが、それはこの LocalScript がハンドラーを接続するより前かもしれません。それで問題ありません。Roblox は、ハンドラーができる前に届いた RemoteEvent のメッセージをキューに入れ、ハンドラーが接続されるとすぐに順番どおり届けます。

クライアントがサーバーから身を守る必要はありません。OnClientEvent を発火できるのはサーバーのコードだけです。message: string という注釈は型チェックのためのもので、実行時の確認ではありません。

パターン3:サーバーからすべてのクライアントへ

FireAllClients は、接続しているすべてのプレイヤーに同じメッセージを送ります。Player 引数はなく、各クライアントは前と同じ OnClientEvent でメッセージを受け取るので、パターン2の NotifyClient スクリプトがすでに表示してくれます。

この Script は、プレイヤーが初めてゴールラインに触れたときに全員に知らせます。Workspace に FinishLine という名前の Anchored の Part を追加し、ServerScriptService に Script を追加します。

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

local notify = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("Notify") :: RemoteEvent
local finishLine = workspace:WaitForChild("FinishLine") :: BasePart

local finished: { [Player]: boolean } = {}

finishLine.Touched:Connect(function(hit: BasePart)
	local character = hit:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	if not player or finished[player] then
		return -- プレイヤーではない、またはすでに知らせた
	end
	finished[player] = true

	-- 接続しているすべてのクライアントが、このテキストで自分の OnClientEvent ハンドラーを実行する
	notify:FireAllClients(`{player.DisplayName} reached the finish!`)
end)

Players.PlayerRemoving:Connect(function(player: Player)
	finished[player] = nil
end)

エクスプロイターは自分のキャラクターについて、どんなに離れていても Touched を起こせますが、プレイヤーごとに1回だけ表示するお知らせなら害はありません。あとでゴールに報酬を出すなら、渡す前にサーバーでの確認、たとえばラウンド開始からの最短時間などを加えてください。

FireAllClients が届くのは、その瞬間に接続しているプレイヤーだけです。1秒後に参加した人にはメッセージは見えません。お知らせ、爆発のエフェクト、音のような一度きりの瞬間には向いていますが、ラウンドのタイマーやゲームの今のフェーズのような状態には向いていません。状態には、サーバーで属性を設定します。たとえば ReplicatedStorage:SetAttribute("TimeLeft", 30) とし、クライアントでは GetAttribute と GetAttributeChangedSignal("TimeLeft") で読みます。属性は、あとから参加したプレイヤーも含めて、すべてのクライアントにレプリケートされます。

RemoteFunction:クライアントが答えを必要とするとき

RemoteEvent は「送ったら終わり」です。RemoteFunction は呼び出した側を待たせます。InvokeServer は、サーバーの OnServerInvoke 関数が値を返すまで呼び出したコードを一時停止させ、それから返ってきたものを渡します。「このコードは正しかった?」のように、答えがないとクライアントが先へ進めないときに使います。答えが不要なときは、待たずに済むので Roblox は RemoteEvent を勧めています。

例:プレイヤーがプロモーションコードを入力する欄です。サーバーはコードを持っていて、テキストを確認し、2つの値を返します。成功したかどうかと、表示するメッセージです。

  1. ReplicatedStorage.Remotes に RedeemCode という名前の RemoteFunction を入れます。
  2. StarterGui に CodeGui という名前の ScreenGui を入れ、その中に CodeBox という名前の TextBox を入れます。サイズと位置はお好みで。
  3. 下の Script を ServerScriptService に、LocalScript を CodeBox の中に追加します。
Script 場所: ServerScriptService 名前: RedeemServer
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local redeemCode = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("RedeemCode") :: RemoteFunction

-- コードはサーバーに置く。どのプレイヤーにも読めない
local CODES: { [string]: number } = {
	LAUNCH = 100,
	THANKYOU = 50,
}
local MAX_LENGTH = 20
local COOLDOWN_SECONDS = 2

local usedCodes: { [Player]: { [string]: boolean } } = {}
local lastTry: { [Player]: number } = {}

-- = で代入する。OnServerInvoke はコールバックで、Connect するイベントではない。
redeemCode.OnServerInvoke = function(player: Player, code: unknown): (boolean, string)
	local now = os.clock()
	local last = lastTry[player]
	if last and now - last < COOLDOWN_SECONDS then
		return false, "Wait a moment before trying again"
	end
	lastTry[player] = now

	if type(code) ~= "string" or #code == 0 or #code > MAX_LENGTH then
		return false, "Type a code first"
	end

	local key = string.upper(code)
	local reward = CODES[key]
	if not reward then
		return false, "That code doesn't exist"
	end

	local used = usedCodes[player]
	if not used then
		used = {}
		usedCodes[player] = used
	end
	if used[key] then
		return false, "You already used that code"
	end

	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	if not (coins and coins:IsA("IntValue")) then
		return false, "Coins aren't set up in this game yet"
	end

	used[key] = true
	coins.Value += reward
	return true, `Code accepted: +{reward} coins`
end

Players.PlayerRemoving:Connect(function(player: Player)
	usedCodes[player] = nil
	lastTry[player] = nil
end)

リーダーボードのガイドの Coins に加算します。使ったコードはプレイヤーが退出するまでしか覚えていないので、このままでは入り直して同じコードをもう一度入力できます。コインが保存されるなら、入り直すたびに無料でコインがもらえてしまいます。公開中のゲームで使う前に、各プレイヤーの使用済みコードを、保存データと一緒にデータストアに保存してください。

LocalScript 場所: TextBox CodeBox 名前: RedeemClient
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local redeemCode = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("RedeemCode") :: RemoteFunction
local box = script.Parent :: TextBox

local GREEN = Color3.fromRGB(46, 204, 113)
local RED = Color3.fromRGB(231, 76, 60)

box.FocusLost:Connect(function(enterPressed: boolean)
	local code = box.Text
	if not enterPressed or code == "" then
		return
	end
	box.Text = ""
	box.PlaceholderText = "Checking..."

	-- InvokeServer は、サーバーのコールバックが値を返すまでこの関数を一時停止する。
	-- 呼び出しが失敗しても、pcall のおかげで LocalScript は止まらない。
	local ok, accepted, message = pcall(function()
		return redeemCode:InvokeServer(code)
	end)

	if ok and type(message) == "string" then
		box.PlaceholderText = message
		box.PlaceholderColor3 = if accepted == true then GREEN else RED
	else
		box.PlaceholderText = "Something went wrong, try again"
		box.PlaceholderColor3 = RED
	end
end)

RemoteFunction のサーバーコールバックはちょうど1つです。2つのスクリプトが同じ RemoteFunction の OnServerInvoke を設定すると、最後のものだけが働きます。

InvokeClient の危険

RemoteFunction は逆向きにも使えます。サーバーで InvokeClient、クライアントで OnClientInvoke です。Roblox のドキュメントは、3つの深刻なリスクを挙げています:

  • クライアントのコールバックがエラーを出すと、サーバーもエラーを出します。
  • 呼び出し中にプレイヤーが退出すると、InvokeClient はエラーを出します。
  • クライアントが値を返さなければ、サーバーのスクリプトは永遠に待ちます。

改造されたクライアントは自分のコールバックを操れるので、チーターはわざと3つ目の状況を起こし、そのサーバーのスレッドを好きなだけ止めておけます。プレイヤーの画面を更新するには FireClient を使ってください。サーバーがどうしてもクライアントの情報を必要とするなら、RemoteEvent を送り、クライアントには別の RemoteEvent で答えさせ、サーバーでは答えが来ないことも普通のケースとして扱います。

サーバーですべての引数を確認する

エクスプロイターは、どの RemoteEvent でも RemoteFunction でも、何度でも、どんな引数でも呼べます。偽造できない唯一のものは1番目の引数です。メッセージを送った Player は Roblox 自身が入れます。その後ろのものはすべて、サーバーが動く前に確認しなければなりません。リモートを隠したり、LocalScript で確認したりしても意味がありません。チーターは自分のクライアントを操っているからです。

サーバー用のチェックリスト
確認サーバーが問うこと例
型期待している型か?Instance に似せて作ったテーブルではなく、本物の Instance か?typeof(part) == "Instance" and part:IsA("BasePart")
範囲数値は有限で、許される範囲にあるか?テキストの長さは妥当か?math.isfinite(n)、n >= 1 and n <= 4、#text <= 20
所有権このプレイヤーはそのアイテムを持っているか、お金は足りるか、そのオブジェクトを扱う権利があるか?アイテムがインベントリにある、パーツが Paintable の中にある
距離サーバー側の世界で、プレイヤーのキャラクターは十分近くにいるか?ラグの分だけ少し余裕を持たせます。パーツから30スタッド以内
頻度このプレイヤーは送る回数が多すぎないか?プレイヤーごとのクールダウン、または呼び出しがたまる方式の上限

NaN には特に注意が必要です。NaN は数値なので type(x) == "number" を通りますが、NaN との比較はすべて false になるので、x < 0 or x > 100 のような確認をすり抜けます。math.isfinite(x) は NaN と正負の無限大を弾きます。

距離チェックの限界も覚えておいてください。各クライアントは自分のキャラクターの物理を制御しているので、エクスプロイターは呼び出しの前にキャラクターを対象のそばへ動かせます。それでもこの確認は、1か所からマップ全体に手を出すといういちばん単純な悪用を止めます。対象のパーツは Anchored にしておきましょう。Roblox のセキュリティのドキュメントには、エクスプロイターは近くにある Anchored でないパーツのネットワーク所有権を得て引き寄せられ、それで距離チェックを回避できると書かれています。

同じ確認を、どのリモートのハンドラーでも使える ModuleScript にしたものがこちらです。

ModuleScript 場所: ServerScriptService 名前: RemoteGuard
local Players = game:GetService("Players")

local RemoteGuard = {}

-- min と max の間の本物の数値。普通の type(x) == "number" の確認を通ってしまう
-- NaN と無限大を弾く。
function RemoteGuard.number(value: unknown, min: number, max: number): number?
	if type(value) ~= "number" or not math.isfinite(value) then
		return nil
	end
	if value < min or value > max then
		return nil
	end
	return value
end

-- min と max の間の整数。数量、インデックス、カウンター用
function RemoteGuard.integer(value: unknown, min: number, max: number): number?
	local n = RemoteGuard.number(value, min, max)
	if n and n % 1 == 0 then
		return n
	end
	return nil
end

-- 長さに上限のあるテキスト。utf8.len は不正な UTF-8 に対して nil を返す。
-- 不正な UTF-8 はデータストアに拒否される。
function RemoteGuard.text(value: unknown, maxLength: number): string?
	if type(value) ~= "string" or #value > maxLength or utf8.len(value) == nil then
		return nil
	end
	return value
end

-- 許可したコンテナの中にある、期待したクラスの Instance。
-- Instance に似せて作ったテーブルは typeof の確認を通らない。
function RemoteGuard.instanceIn(value: unknown, className: string, container: Instance): Instance?
	if typeof(value) ~= "Instance" then
		return nil
	end
	if not value:IsA(className) or not value:IsDescendantOf(container) then
		return nil
	end
	return value
end

-- プレイヤーのキャラクターが position から maxDistance スタッド以内にいれば true
function RemoteGuard.isNear(player: Player, position: Vector3, maxDistance: number): boolean
	local character = player.Character
	local root = character and character:FindFirstChild("HumanoidRootPart")
	if not (root and root:IsA("BasePart")) then
		return false
	end
	return (root.Position - position).Magnitude <= maxDistance
end

-- プレイヤーごとの頻度の上限。各プレイヤーは一度に `burst` 回まで呼べて、
-- 毎秒 `perSecond` 回分ずつ回復する。作業の前に呼ぶ関数を返す。
-- その関数は true(呼んでよい)か false(多すぎる)を答える。
function RemoteGuard.limiter(burst: number, perSecond: number): (Player) -> boolean
	local buckets: { [Player]: { tokens: number, updated: number } } = {}

	Players.PlayerRemoving:Connect(function(player: Player)
		buckets[player] = nil
	end)

	return function(player: Player): boolean
		local now = os.clock()
		local bucket = buckets[player]
		if not bucket then
			bucket = { tokens = burst, updated = now }
			buckets[player] = bucket
		end
		bucket.tokens = math.min(burst, bucket.tokens + (now - bucket.updated) * perSecond)
		bucket.updated = now
		if bucket.tokens < 1 then
			return false
		end
		bucket.tokens -= 1
		return true
	end
end

return RemoteGuard

ServerScriptService に置いてください。そこにあるコードはクライアントに送られないので、誰にも確認の中身を読まれません。

そして、これを使って書き直したパターン1のハンドラーです。PaintServer の中身を置き換えてください:

Script 場所: ServerScriptService 名前: PaintServer
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerScriptService = game:GetService("ServerScriptService")

-- ":: any" が意味を持つのは Luau の strict 型チェックだけ。実行時には何も変わらない
local RemoteGuard = require(ServerScriptService:WaitForChild("RemoteGuard")) :: any

local paintRequest = ReplicatedStorage:WaitForChild("Remotes"):WaitForChild("PaintRequest") :: RemoteEvent
local paintable = workspace:WaitForChild("Paintable")

local PALETTE = {
	Color3.fromRGB(231, 76, 60),
	Color3.fromRGB(46, 204, 113),
	Color3.fromRGB(52, 152, 219),
	Color3.fromRGB(241, 196, 15),
}
local canPaint = RemoteGuard.limiter(4, 4) -- まとめて4回、そのあと毎秒4回

paintRequest.OnServerEvent:Connect(function(player: Player, partArg: unknown, colourArg: unknown)
	local part = RemoteGuard.instanceIn(partArg, "BasePart", paintable) :: BasePart?
	local colourIndex = RemoteGuard.integer(colourArg, 1, #PALETTE) :: number?
	if not part or not colourIndex then
		return
	end
	if not RemoteGuard.isNear(player, part.Position, 30) or not canPaint(player) then
		return
	end
	part.Color = PALETTE[colourIndex]
end)

リミッターはプレイヤーが退出するとその記録を消すので、テーブルがサーバーの寿命の間ずっと増え続けることはありません。

武器では、これらの確認がいちばん大事です。誰に当たったかをクライアントに言わせてはいけません。剣のガイドのリモートは引数をまったく持たず、サーバーが自分で対象を見つけます。銃のガイドは狙った点だけを送り、サーバーはその型、NaN、距離を確認してから自分でレイを飛ばします。

メニューも同じルールに従います。結果ではなく選択を送ってください。NPC 会話のガイドでは、クライアントは押したボタンの番号だけを送り、その答えで何がもらえるかはサーバーが自分で調べます。テレポートのガイドのメニューは位置ではなく地点の名前を送り、サーバーは自分のフォルダーでその地点を見つけ、必要な Wins の数を確認します。

送れるものと送れないもの

数値、文字列、ブール値、Vector3、CFrame、Color3、Enum の項目などの Roblox の型、両側から見える Instance、そしてそれらでできたテーブルは送れます。途中で変わったり消えたりする値もあります:

送ったときと違う形で届く引数
送るもの何が起きるか
関数相手側は nil を受け取ります
メタテーブル付きのテーブルメタテーブルは失われ、テーブルがメタテーブルを通してだけ持っていたものも一緒に失われます
数値のキーと文字列のキーが混ざったテーブルRoblox はやめるよう勧めています。純粋な配列か純粋な辞書を送ってください
中に nil の値があるテーブル避けてください。Roblox はどのインデックスにも nil を入れないよう勧めています
Instance、userdata、function の型のキーを持つテーブルそうしたキーは文字列に変わります
受け手から見えない Instance(ServerStorage にあるものや LocalScript で作ったものなど)相手側は nil を受け取ります
どんなテーブルでも受け手が受け取るのはコピーで、同じテーブルではありません

よい習慣は、オブジェクトや値ではなく識別子を送ることです。アイテムの名前、選択肢の番号、サーバーが見つけて確認できるパーツなどです。その先はサーバーが自分のデータで処理します。

RemoteFunction が nil を返す理由

InvokeServer が nil を返してくるときは、次の項目を順番に確認してください:

  1. 値を返さない経路。OnServerInvoke のすべての出口で何かを返す必要があります。早い段階の確認にある空の return は nil を送り返します。
  2. 入れ子の関数の中の return。pcall(function() ... end)、:Connect のハンドラー、task.spawn の中の return は、その内側の関数から抜けるだけです。local ok, data = pcall(...) のように結果を保存し、コールバック自体から data を返してください。
  3. 境界を越えられない値。関数や、クライアントから見えない Instance(たとえば ServerStorage にあるもの)は nil として届きます。instance streaming が有効なら、サーバーが作ったばかりのパーツは、関数が値を返す時点でまだクライアントに届いていないかもしれません。
  4. 別のスクリプトがコールバックを設定した。働くのは OnServerInvoke への最後の代入だけです。自分のスクリプトの中でリモートの名前を検索してください。

呼び出しがまったく戻ってこないなら、まだどのスクリプトも OnServerInvoke を設定していない(設定されるまで Roblox は呼び出しをキューに入れておきます)か、コールバックが、決して現れないものへの WaitForChild などで止まっています。

UnreliableRemoteEvent:絶えず続く使い捨ての更新に

UnreliableRemoteEvent には RemoteEvent と同じメソッドとイベントがあります:FireServer、FireClient、FireAllClients、OnServerEvent、OnClientEvent。違いは、Roblox が配達も順番も保証しないことです。次のような場合、メッセージは再送されずに捨てられることがあります:

  • 途中で失われた、または混雑したネットワークで長く待ちすぎた
  • データが 1000バイトを超えている
  • クライアントが上限より多く送っている(超えた分は後回しにされず、捨てられます)
  • 届いた時点でハンドラーが1つも接続されていない(キューに入らず、捨てられます)

メッセージは順番どおりに届かないこともあり、その順番は RemoteEvent や RemoteFunction の順番とは関係ありません。いちばん新しい値だけが大事で、次の更新がほんの一瞬後に来るようなときに使います。プレイヤーが狙っている方向、見た目だけのエフェクトの位置、毎フレーム変わる値などです。順番が大事なら、各メッセージに通し番号かタイムスタンプを入れ、最後に処理したものより古いものは無視してください。

購入、ダメージ、報酬、ラウンドの開始など、ちょうど1回起きなければならないことには決して使わないでください。そして、その引数も RemoteEvent とまったく同じようにサーバーで確認してください。

配達の順番と頻度の上限

Roblox の配達の保証は、1つの接続の1つの向きについてのものです。サーバーから1つのクライアントへ、または1つのクライアントからサーバーへ、です。

  • RemoteEvent は確実で、順番も守られます。失われたメッセージは受け手が接続している間は再送され、別々の RemoteEvent をまたいでも、送った順番どおりに届きます。サーバーがプレイヤーに A、B、A の順で送れば、そのプレイヤーは A、B、A の順で受け取ります。
  • 順番が守られるのは、ハンドラーが起動するタイミングです。ハンドラーが task.wait や WaitForChild などで処理を譲ると、最初のメッセージの処理が終わる前に次のメッセージの処理が始まることがあります。
  • RemoteFunction と RemoteEvent の間では順番は保証されません。コードが厳密な順番に頼っているなら、関連するメッセージは1種類のリモートで送るか、自分で通し番号を付けてください。
  • プロパティや属性の変更とリモートの間でも順番は保証されません。サーバーがプロパティを変えてからリモートを呼ぶと、クライアントはどちらを先に見るかわかりません。変更がもう届いていると決めつけず、GetPropertyChangedSignal などで変更そのものを待ち受けてください。
  • ハンドラーがまだない。RemoteEvent のメッセージは、ハンドラーが接続されるまでキューで待ちます。キューには限りがあり、いっぱいになると次のメッセージは捨てられ、Output に Remote event invocation discarded エラーが出ます。
  • 退出するプレイヤーは、まだ届いていないメッセージをすべて失います。

頻度の上限。クライアントからサーバーへの RemoteEvent と UnreliableRemoteEvent のメッセージは、2026年9月30日時点のドキュメントによると、クライアントごとに毎秒約500リクエストに制限されています。この上限は同じ種類のすべてのリモートで共通なので、混んでいる1つのリモートを10個に分けても上限は上がりません。上限を超えると、RemoteEvent のメッセージは順番を保ったまま後で処理され、UnreliableRemoteEvent のメッセージは捨てられます。エンジンの上限は、1人のプレイヤーがあなたのリモートを毎秒50回呼ぶことを少しも妨げないので、何かを変えるハンドラーにはどれも、やはりプレイヤーごとの上限が必要です。

RemoteEvent、RemoteFunction、UnreliableRemoteEvent、属性のどれを使う?

クライアントとサーバーのやり取りの方法を選ぶ
使うもの用途例注意点
RemoteEvent必ず、順番どおりに届く必要がある一方通行のメッセージクライアント:「このパーツを塗って」。サーバー:「この通知を表示して」サーバーですべての引数を確認する
InvokeServer の RemoteFunction先へ進む前にクライアントが答えを必要とするプロモーションコードの入力、購入の確認呼び出し側は待つ。すべての経路で値を返す必要がある
InvokeClient の RemoteFunctionほぼ使わない代わりに FireClient を使うエラーを出した、退出した、答えなかったクライアントが、サーバー側の呼び出しを壊すか止める
UnreliableRemoteEvent最新のものだけが大事な頻繁な更新狙いの方向、見た目だけのエフェクトメッセージが失われたり順番が変わったりする。データの上限は1000バイト
サーバーが設定する属性や値オブジェクトあとから参加したプレイヤーも含め、いつでも見えるべき共有の状態ラウンドのタイマー、ゲームのフェーズ、ドアが開いているか全員に届くのはサーバーの変更だけ。クライアントは GetAttributeChangedSignal か Changed で待ち受ける
BindableEvent同じ側のスクリプト同士のやり取りあるサーバースクリプトが別のスクリプトにラウンド終了を知らせるサーバーとクライアントの間は越えない

プレイヤーがお金を払う場面で RemoteFunction と確認がどう組み合わさるかの完全な例は、ショップ GUI の作り方のガイドを見てください。属性の行については、ドアのガイドのサーバースクリプトが、ドアが動くたびに各ドアの Open 属性を設定するので、どの LocalScript でもそれに反応できます。

よくあるエラーと対処法

リモートの問題のほとんどは Output ウィンドウ(Window メニューか Script タブから開きます)でわかります。まずそこを見て、それから下で自分の症状を探してください。一般的なエラーメッセージはスクリプトのエラーのガイドで詳しく解説しています。

リモートの WaitForChild で Infinite yield possible

スクリプトが、決して現れないリモートを待っています。名前と大文字小文字が完全に一致していること、そしてリモートがクライアントから見えない ServerStorage や ServerScriptService ではなく、ReplicatedStorage にあることを確認してください。

サーバーが受け取る値が1つずれている

LocalScript が remote:FireServer(player, 5) のようにプレイヤー自身を渡しています。Roblox はもともと送り手を1番目の引数として付け加えるので、サーバーには (player, player, 5) と見えます。remote:FireServer(5) と呼んでください。

リモートを呼んでも何も起きない

それぞれの呼び出しが正しい側から行われているか確認してください。FireServer と InvokeServer はクライアントのコードからだけ、FireClient、FireAllClients、InvokeClient はサーバーの Script からだけ動きます。LocalScript は ServerScriptService、ServerStorage、Workspace の直下では決して実行されません。StarterPlayerScripts、StarterGui、StarterCharacterScripts、StarterPack に置いてください。そのうえで、Output でハンドラーの中のエラーを探します。

Remote event invocation discarded

ハンドラーが接続されていない RemoteEvent にメッセージが届き、キューがいっぱいになりました。たいていは、ハンドラーのあるスクリプトが :Connect の行より前でエラーになっている、無効になっている、または決して読み込まれないものを待って止まっています。ハンドラーはスクリプトの先頭近くで接続してください。

自分には動くのに、ほかのプレイヤーには変化が見えない

変更がクライアント側、つまり LocalScript か OnClientEvent のハンドラーで行われています。サーバーの OnServerEvent ハンドラーで行ってください。

InvokeServer がいつまでも戻ってこない

どのスクリプトも OnServerInvoke を設定していない(設定されるまで Roblox は呼び出しをキューに入れておきます)か、コールバックが WaitForChild やデータストアへのリクエストなど、処理を譲るもので止まっています。コールバックの最初と最後に print を足して、どこで止まるかを見てください。

RoCode で作る

これは RoCode にも、開いているプレイスの中でそのまま設定させられます。RoCode は Roblox Studio のプラグインを通して動く AI エージェントなので、貼り付けるコードを出すのではなく、あなたの Explorer にリモートとスクリプトを作ります。

あなたの入力

Paintable フォルダーのパーツをプレイヤーがクリックで塗れるようにして。RemoteEvent を使って、確認はサーバーに置いて。対象はそのフォルダーのパーツだけ、距離は30スタッド以内、塗るのは1秒に数回まで。

RoCode の作業
  • たいていは最初に Search Game と Search Scripts でプレイスを見て、既存の Remotes フォルダーやハンドラーを探し、あなたのフォルダーがあればそれを使います
  • Create Instance で ReplicatedStorage に RemoteEvent を作り、Create Script でサーバーの Script と LocalScript を書きます
  • 終える前に、Studio の中の Check Script で各スクリプトのコンパイルを確認します。見つかるのはコンパイルエラーで、ロジックの誤りではありません。型チェック、リンターの実行、コードの実行はしません
  • 変更をまとまりごとに送り、まとまりの一つひとつが Studio の取り消し履歴の取り消しポイントになります

プラグイン 3.9 以降の RoCode は短いプレイテストを行ってエラーを読めます。プラグイン 3.9.11 以降ではテスト用キャラクターを操作できますが、3D ビューのパーツはクリックしません。自分で Play を押し、マップの反対側からパーツを塗るなどして、確認を破ろうとしてみてください。エラーが出たら、Check Output が最後のプレイテストの Server と Client の行を読めます。ほとんどのゲームシステムはこうしたリモートでやり取りするので、RoCode でシステムを1つずつゲームを組み立てるときにもまた出てきます。RoCode が Studio につながる仕組み。

よくある質問

Roblox の securing the client-server boundary とは何ですか?

リモートのセキュリティについての Roblox のドキュメントのページの名前で、考え方はシンプルです。クライアントが RemoteEvent や RemoteFunction で送るものはすべてエクスプロイターから来ているかもしれないので、サーバーは動く前にそれを確認します。各引数の型を確認し、数値を妥当な範囲に収め、そのプレイヤーが今それをしてよいかを確認し、各プレイヤーがリモートを呼べる頻度を制限します。上の検証のチェックリストで、そのそれぞれをコードで示しています。

RemoteFunction を使っても安全ですか?

InvokeServer の安全さは、サーバーのコールバックの安全さで決まります。どの RemoteEvent とも同じように、引数を確認し、頻度を制限してください。危険なのは InvokeClient の向きです。エラーを出した、退出した、値を返さなかったクライアントが、サーバー側の呼び出しを壊すか止めてしまうからです。

エクスプロイターは私のリモートを見たり呼んだりできますか?

はい。ReplicatedStorage にあるものはすべてのクライアントに届き、改造されたクライアントはどのリモートでもどんな引数でも呼べます。リモートの名前を変えたり隠したりしても安全にはなりません。安全にするのは、サーバーでのすべての引数の確認です。

あるクライアントから別のクライアントへ RemoteEvent を送れますか?

直接はできません。サーバーに送ってそこで確認し、それから FireClient か FireAllClients を使ってください。

RemoteEvent はどのくらいの頻度で呼べますか?

Roblox のドキュメントには、サーバーに送る RemoteEvent と UnreliableRemoteEvent のメッセージについて、クライアントごとに毎秒約500リクエストという上限が書かれていて、これは同じ種類のすべてのリモートで共通です。それよりずっと低く抑え、各ハンドラーにプレイヤーごとの上限を付けてください。

FireAllClients は、あとから参加したプレイヤーにも届きますか?

いいえ。届くのはその瞬間に接続しているプレイヤーだけです。遅れて来た人にも必要な状態には、サーバーで属性か値オブジェクトを設定してください。

RemoteEvent と BindableEvent の違いは何ですか?

RemoteEvent はサーバーとクライアントの間を越えます。BindableEvent は、2つのサーバースクリプトのように、同じ側のスクリプト同士をつなぎます。

参考資料

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

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

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