チュートリアル · ゲームプレイ

Roblox Studio で管理者コマンドを作る方法

管理者コマンドを使うと、チャットから直接ゲームを管理できます。ルール違反のプレイヤーを追い出したり、友だちのところへテレポートしたり、移動速度を試したりできます。現在の Roblox のチャットである TextChatService には、TextChatCommand によるコマンドが組み込まれています。このガイドではそれを使って管理者コマンドのセットを追加します。どのコマンドもサーバー側で user ID のリストと照合するので、ほかの人は使えません。

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

要点

ServerScriptService の Script で、コマンドごとに TextChatCommand を作り、PrimaryAlias(たとえば "/kick")を設定して TextChatService に入れます。その Triggered イベントは、送信者の TextSource とメッセージ全文を渡します。Players:GetPlayerByUserId(textSource.UserId) でプレイヤーを見つけ、その user ID が管理者リストにあるか確認してから、メッセージを単語に分けて処理を実行します。

  • 管理者リストのチェックはサーバーで行います。LocalScript でのチェックはエクスプロイターに回避されるおそれがあります。
  • 名前ではなく user ID で確認します。プレイヤーは名前を変えられますが、ID は決して変わりません。
  • コマンドに一致したメッセージはチャットに表示されないので、ほかのプレイヤーのチャットが散らかりません。
このページの内容
  1. 仕組み
  2. 1. スクリプト
  3. 2. 自分のコマンド
  4. Common errors
  5. With RoCode
  6. よくある質問
  7. 参考資料

チャットコマンドの仕組み

TextChatService の中にある TextChatCommand は、チャットのメッセージを監視します。メッセージがその PrimaryAlias または SecondaryAlias で始まり、その後にスペースが続くか何も続かない場合、Roblox はメッセージをほかのプレイヤーに送らず、代わりに Triggered を呼びます。エイリアスとの比較では大文字と小文字は区別されません。Roblox のカスタムコマンドの例ではサーバーの Script で Triggered に接続しており、管理者チェックを置くべき場所もそこです。

このガイドのコマンド
チャットに入力する内容起こること
/kick Nameそのプレイヤーをサーバーから退出させます。
/tp Nameあなたをそのプレイヤーのところへテレポートします。/tp Name1 Name2 は Name1 を Name2 のところへ送ります。
/speed Name 50そのプレイヤーの WalkSpeed を設定します(0 から 200)。数字がなければ 16 に戻します。
/heal Nameそのプレイヤーの体力を全回復します。
/kill Nameそのプレイヤーのキャラクターを倒します。

名前の代わりに me、all、others と書くこともでき、名前は先頭部分だけで十分です。/heal ro は、名前または表示名が「ro」で始まるすべてのプレイヤーを回復します。

ステップ1: コマンドを追加する

  1. ゲームが TextChatService を使っているか確認します。Explorer で TextChatService を選び、Properties ウィンドウで ChatVersion を見てください。古いプレイスでまだ LegacyChatService になっている場合は、ゲーム内テキストチャットに関する Roblox のページに移行についての項目があります。
  2. ServerScriptService に AdminCommands という名前の Script を挿入し、下のコードを貼り付けます。
  3. ADMINS の中の 123456 を自分の user ID に置き換えます。
Script 場所: ServerScriptService 名前: AdminCommands
-- ServerScriptService に置く AdminCommands という名前の Script。
-- ADMINS の user ID 用のチャットコマンド: /kick、/tp、/speed、/heal、/kill。
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")

-- user ID はプロフィールのリンクにある数字です: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
	[123456] = true,
}

local function isAdmin(userId: number): boolean
	-- 個人で所有しているプレイスの Studio プレイテストでは、あなたも管理者として扱われます
	local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
	return ADMINS[userId] == true or ownerInStudio
end

-- 名前または表示名の先頭部分、または "me"、"all"、"others" でプレイヤーを探します
local function findPlayers(text: string?, caller: Player): { Player }
	local found: { Player } = {}
	if not text or text == "" or text == "me" then
		table.insert(found, caller)
		return found
	end
	local lower = string.lower(text)
	for _, player in Players:GetPlayers() do
		local name = string.lower(player.Name)
		local display = string.lower(player.DisplayName)
		if lower == "all"
			or (lower == "others" and player ~= caller)
			or string.sub(name, 1, #lower) == lower
			or string.sub(display, 1, #lower) == lower
		then
			table.insert(found, player)
		end
	end
	return found
end

local function getHumanoid(player: Player): Humanoid?
	local character = player.Character
	return character and character:FindFirstChildOfClass("Humanoid")
end

type Handler = (caller: Player, args: { string }) -> ()

local commands: { [string]: Handler } = {
	kick = function(caller, args)
		for _, target in findPlayers(args[2], caller) do
			if target ~= caller then
				target:Kick("Kicked by an admin")
			end
		end
	end,
	tp = function(caller, args)
		-- /tp name: その人のところへ。/tp name1 name2: name1 を name2 のところへ送る。
		local destination = if args[3] then findPlayers(args[3], caller)[1] else findPlayers(args[2], caller)[1]
		local movers: { Player } = if args[3] then findPlayers(args[2], caller) else { caller }
		local destCharacter = destination and destination.Character
		if not destCharacter then
			return
		end
		for _, mover in movers do
			local character = mover.Character
			if character and mover ~= destination then
				character:PivotTo(destCharacter:GetPivot() * CFrame.new(0, 0, 4))
			end
		end
	end,
	speed = function(caller, args)
		-- /speed name 50
		local speed = tonumber(args[3]) or 16
		for _, target in findPlayers(args[2], caller) do
			local humanoid = getHumanoid(target)
			if humanoid then
				humanoid.WalkSpeed = math.clamp(speed, 0, 200)
			end
		end
	end,
	heal = function(caller, args)
		for _, target in findPlayers(args[2], caller) do
			local humanoid = getHumanoid(target)
			if humanoid then
				humanoid.Health = humanoid.MaxHealth
			end
		end
	end,
	kill = function(caller, args)
		for _, target in findPlayers(args[2], caller) do
			local humanoid = getHumanoid(target)
			if humanoid then
				humanoid.Health = 0
			end
		end
	end,
}

-- コマンドごとに TextChatCommand を1つ作ります。結果が出るのは管理者だけで、ほかの人には
-- コマンドは何もせず、メッセージもチャットに表示されません。
for name, handler in commands do
	local command = Instance.new("TextChatCommand")
	command.Name = "Admin_" .. name
	command.PrimaryAlias = "/" .. name
	command.AutocompleteVisible = false -- コマンドがほかのプレイヤーの入力候補に出ないようにする
	command.Parent = TextChatService
	command.Triggered:Connect(function(textSource: TextSource, unfilteredText: string)
		local caller = Players:GetPlayerByUserId(textSource.UserId)
		if not caller or not isAdmin(caller.UserId) then
			return
		end
		handler(caller, string.split(unfilteredText, " "))
	end)
end

commands テーブルは、名前ごとに関数を対応させています。下のループが各エントリーを TextChatCommand に変えるので、新しいコマンドはテーブルに1エントリー足すだけです。string.split(unfilteredText, " ") はメッセージを単語に分けます。args[1] がコマンド、args[2] が対象、args[3] が数字または2人目の対象です。

AutocompleteVisible = false は、スラッシュを入力したときに全プレイヤーに表示される入力候補からコマンドを外します。管理者がコマンドを最後まで入力すれば、それでも動きます。

ステップ2: 自分のコマンドを追加する

commands テーブルにエントリーを追加します。たとえば、ジャンプ力を設定する /jump Name 100 コマンドなら次のとおりです。

  • speed のエントリーをコピーして、名前を jump に変えます。
  • 中で humanoid.UseJumpPower = true と humanoid.JumpPower = math.clamp(power, 0, 300) を設定します。

お知らせのように全員に向けたメッセージは、各クライアントが画面に表示する RemoteEvent で送ります。プレイヤーが読めるもので、入力された文字から来たものは、先に Roblox のテキストフィルタリングを通す必要があります。お知らせには固定のメッセージを使うか、TextService:FilterStringAsync でフィルタリングしてください。

テストする

  1. 自分が所有しているプレイスで Play を押します。チャットに /speed me 60 と入力すると、速く走れるようになり、チャットにはメッセージが表示されません。
  2. 落下した後に /heal me と入力し、体力が戻るか確認します。
  3. 2人プレイヤーのテストを始めます(Test タブ、Clients and Servers)。Player1 から /tp Player2 と入力します。管理者ではない Player2 から /kill Player1 と入力すると、何も起こりません。

よくあるエラーと対処法

コマンドが何もしない場合は、まず Output ウィンドウと次の項目を確認してください。

コマンドがチャットに表示され、何も起こらない

TextChatCommand は TextChatService のものです。TextChatService の ChatVersion プロパティを確認し、スクリプトが ServerScriptService の Script であること、Output に赤いエラーがないことも確かめてください。

ライブのゲームでは自分のコマンドが何もしない

あなたの user ID が ADMINS にありません。Studio の例外は Studio の中だけで、しかもグループではなく個人アカウントが所有するプレイスにだけ適用されます。

/tp が何もしない

両方のプレイヤーのキャラクターがワールドにいる必要があります。対象の名前を確認してください。名前または表示名の先頭部分で十分ですが、打ち間違いがあると誰も見つかりません。

モデレーターやオーナーのようなランクを作りたい

ADMINS を、user ID にランク番号を対応させる形に変え、各コマンドに実行できる最低ランクを設定してください。

RoCode で作る

手作業で設定したくない場合は、RoCode が開いているプレイスにこれを組み立てられます。RoCode は Roblox 製ではない独立した Roblox Studio 向けの AI エージェントです。ウェブチャットで変更内容を説明すると、Studio プラグインがあなたの Explorer にスクリプトを作ります。

あなたの入力

自分と友だち(user ID 111 と 222)用に管理者コマンドを追加して: /kick、/tp、/speed、/heal、/kill、/fly、サーバー側でチェックして。

RoCode の作業
  • あなたの管理者 ID と、説明した追加コマンドを入れたコマンドのスクリプトを書きます
  • 先にプレイスを読み、既存のチャット設定など、すでにあるものを使うこともできます
  • 各スクリプトのコンパイルを Check Script で確認するよう指示されており、変更のまとまりごとに取り消しポイントを置きます

コマンドをプレイテストで確かめるのはやはりあなたの役目で、管理者チェックの確認には2人目のプレイヤーが必要です。RoCode が Studio に接続する仕組み。

よくある質問

自分の Roblox ゲームに管理者コマンドを追加するには?

サーバーの Script で TextChatCommand を作り、各 Triggered ハンドラーで何かをする前に送信者の user ID を管理者リストと照合します。完全なスクリプトはステップ1にあります。

HD Admin や Adonis は必要ですか?

いいえ。Creator Store の管理者システムは多くのコマンドとパネルを追加しますが、自分で書いたものではない大きなコードです。自作の短いスクリプトなら、必要なことだけを行い、それ以上は何もしません。

Roblox の自分の user ID はどうやって調べますか?

roblox.com で自分のプロフィールを開いてください。リンクの /users/ と /profile の間にある数字があなたの user ID です。

管理者コマンドはほかのプレイヤーのチャットに見えますか?

いいえ。TextChatCommand に一致したメッセージは、ほかのプレイヤーには送られません。

参考資料

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

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

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