要点
ServerScriptService の Script で、コマンドごとに TextChatCommand を作り、PrimaryAlias(たとえば "/kick")を設定して TextChatService に入れます。その Triggered イベントは、送信者の TextSource とメッセージ全文を渡します。Players:GetPlayerByUserId(textSource.UserId) でプレイヤーを見つけ、その user ID が管理者リストにあるか確認してから、メッセージを単語に分けて処理を実行します。
- 管理者リストのチェックはサーバーで行います。LocalScript でのチェックはエクスプロイターに回避されるおそれがあります。
- 名前ではなく user ID で確認します。プレイヤーは名前を変えられますが、ID は決して変わりません。
- コマンドに一致したメッセージはチャットに表示されないので、ほかのプレイヤーのチャットが散らかりません。
チャットコマンドの仕組み
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: コマンドを追加する
- ゲームが TextChatService を使っているか確認します。Explorer で TextChatService を選び、Properties ウィンドウで ChatVersion を見てください。古いプレイスでまだ LegacyChatService になっている場合は、ゲーム内テキストチャットに関する Roblox のページに移行についての項目があります。
- ServerScriptService に
AdminCommandsという名前の Script を挿入し、下のコードを貼り付けます。 ADMINSの中の123456を自分の user ID に置き換えます。
-- 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 でフィルタリングしてください。
テストする
- 自分が所有しているプレイスで Play を押します。チャットに
/speed me 60と入力すると、速く走れるようになり、チャットにはメッセージが表示されません。 - 落下した後に
/heal meと入力し、体力が戻るか確認します。 - 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、サーバー側でチェックして。
- あなたの管理者 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 Creator Docs: TextChatCommand(英語). エイリアス、AutocompleteVisible、Triggered
- Roblox Creator Docs: Custom text chat commands(英語). コマンドを処理するサーバーの Script
- Roblox Creator Docs: Player:Kick(英語). メッセージを付けてプレイヤーを退出させる
- Roblox Creator Docs: Text filtering(英語). 入力された文字をフィルタリングすべきとき
コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。