Tutorial · Gameplay

Paano gumawa ng admin commands sa Roblox Studio

Sa admin commands, kontrolado mo ang game mo mula mismo sa chat: i-kick ang nanggugulo, mag-teleport papunta sa kaibigan, i-check ang speed. Sa kasalukuyang chat ng Roblox, ang TextChatService, built-in ang mga command sa pamamagitan ng TextChatCommand. Sa guide na ito, magdadagdag ka ng set ng admin commands batay dito, at bawat isa ay chine-check sa server gamit ang listahan ng user ID, kaya walang ibang makakagamit nito.

In-update Nobyembre 20, 20265 minutong basaIsinulat ni

Sa madaling salita

Sa isang Script sa ServerScriptService, gumawa ng TextChatCommand para sa bawat command, bigyan ito ng PrimaryAlias (halimbawa "/kick") at ilagay ito sa TextChatService. Ipinapasa ng Triggered event nito ang TextSource ng nagpadala at ang buong text ng message. Hanapin ang player gamit ang Players:GetPlayerByUserId(textSource.UserId), i-check na nasa admin list mo ang user ID niya, saka hatiin ang message sa mga salita at gawin ang action.

  • I-check ang admin list sa server. Kayang lampasan ng exploiter ang check sa LocalScript.
  • I-check ang user ID, hindi ang pangalan: puwedeng magpalit ng pangalan ang mga player, pero ang ID ay hindi kailanman nagbabago.
  • Hindi lumalabas sa chat ang message na tumugma sa isang command, kaya hindi nakakakalat ang mga command sa chat ng ibang player.
Sa page na ito
  1. Paano ito gumagana
  2. 1. Ang script
  3. 2. Sariling command
  4. Common errors
  5. With RoCode
  6. Mga madalas itanong
  7. Mga source at dagdag na babasahin

Paano gumagana ang chat commands

Ang TextChatCommand sa loob ng TextChatService ay nagbabantay sa mga message sa chat. Kapag nagsimula ang message sa PrimaryAlias o SecondaryAlias nito, na sinusundan ng space o wala nang kasunod, hindi ipinapadala ng Roblox ang message sa ibang player at sa halip ay pina-fire nito ang Triggered. Hindi case-sensitive ang pagtutugma sa alias. Ang halimbawa ng custom commands mula sa Roblox ay kumokonekta sa Triggered sa isang server Script, at doon mismo dapat ang admin check.

Ang mga command sa guide na ito
Ano ang ita-type sa chatAno ang mangyayari
/kick NameTinatanggal ang player na iyon sa server.
/tp NameTine-teleport ka papunta sa kanya. Ang /tp Name1 Name2 ay nagpapadala kay Name1 papunta kay Name2.
/speed Name 50Sine-set ang WalkSpeed niya (mula 0 hanggang 200). Kapag walang number, ibinabalik sa 16.
/heal NameIbinabalik nang buo ang health niya.
/kill NamePinapatay ang character niya.

Sa halip na pangalan, puwede mong isulat ang me, all o others, at sapat na ang simula ng pangalan: hini-heal ng /heal ro ang lahat ng player na ang pangalan o display name ay nagsisimula sa "ro".

Hakbang 1: idagdag ang mga command

  1. Siguraduhing TextChatService ang gamit ng game: piliin ang TextChatService sa Explorer at tingnan ang ChatVersion sa Properties window. Kung LegacyChatService pa rin ito sa lumang place, may section tungkol sa paglipat sa page ng Roblox tungkol sa in-game text chat.
  2. Mag-insert ng Script sa ServerScriptService na pinangalanang AdminCommands at i-paste ang code sa ibaba.
  3. Palitan ang 123456 sa ADMINS ng sarili mong user ID.
Script sa ServerScriptService na pinangalanang AdminCommands
-- Script sa ServerScriptService na pinangalanang AdminCommands.
-- Chat commands para sa mga user ID sa ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")

-- Ang user ID mo ay ang number sa link ng profile mo: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
	[123456] = true,
}

local function isAdmin(userId: number): boolean
	-- Sa playtest sa Studio, sa place na personal mong pagmamay-ari, admin ka rin
	local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
	return ADMINS[userId] == true or ownerInStudio
end

-- Naghahanap ng mga player ayon sa simula ng pangalan o display name, o "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: papunta sa kanya. /tp name1 name2: ipadala si name1 papunta kay 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,
}

-- Gumagawa ng isang TextChatCommand kada command. Mga admin lang ang may resulta; para sa iba
-- walang ginagawa ang command, at hindi rin lumalabas ang message sa chat.
for name, handler in commands do
	local command = Instance.new("TextChatCommand")
	command.Name = "Admin_" .. name
	command.PrimaryAlias = "/" .. name
	command.AutocompleteVisible = false -- hindi lumalabas ang mga command sa suggestions ng ibang player
	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

Ang table na commands ay nagtutugma ng function sa bawat pangalan. Ginagawang TextChatCommand ng loop sa ibaba ang bawat entry, kaya ang bagong command ay isang entry lang sa table. Hinahati ng string.split(unfilteredText, " ") ang message sa mga salita: ang args[1] ay ang command, ang args[2] ay ang target, ang args[3] ay ang number o ang pangalawang target.

Tinatanggal ng AutocompleteVisible = false ang mga command sa mga suggestion na nakikita ng bawat player kapag nag-type siya ng slash. Kapag tinype ng admin nang buo ang command, gagana pa rin ito.

Hakbang 2: magdagdag ng sarili mong command

Magdagdag ng entry sa table na commands. Halimbawa, isang command na /jump Name 100 na nagse-set ng lakas ng talon:

  • Kopyahin ang entry na speed at palitan ang pangalan nito ng jump.
  • Sa loob, i-set ang humanoid.UseJumpPower = true at humanoid.JumpPower = math.clamp(power, 0, 300).

Para sa message para sa lahat, halimbawa isang announcement, ipadala ito sa pamamagitan ng RemoteEvent na ipinapakita ng bawat client sa screen. Lahat ng mababasa ng mga player na galing sa tinype na text ay dapat munang dumaan sa text filtering ng Roblox, kaya gumamit ng mga fixed na message para sa announcements o i-filter ang mga ito gamit ang TextService:FilterStringAsync.

I-test

  1. Pindutin ang Play sa place na pagmamay-ari mo. I-type sa chat ang /speed me 60: mas mabilis kang tatakbo, at hindi lalabas ang message sa chat.
  2. Pagkatapos mahulog, i-type ang /heal me para i-check na bumabalik ang health.
  3. Magpatakbo ng test na may 2 player (tab na Test, Clients and Servers). Mula kay Player1, i-type ang /tp Player2. Mula kay Player2, na hindi admin, i-type ang /kill Player1: walang mangyayari.

Mga karaniwang error at solusyon

Kung walang ginagawa ang command, tingnan muna ang Output window at ang mga puntong ito.

Lumalabas ang command sa chat at walang nangyayari

Ang TextChatCommand ay para sa TextChatService. I-check ang property na ChatVersion ng TextChatService, at siguraduhin ding Script ang script sa ServerScriptService at walang pulang error sa Output.

Sa live game, walang ginagawa ang command para sa akin

Wala ang user ID mo sa ADMINS. Ang exception para sa Studio ay gumagana lang sa Studio at para lang sa place na pagmamay-ari ng personal mong account, hindi ng group.

Walang ginagawa ang /tp

Kailangang may character sa mundo ang parehong player. I-check ang pangalan ng target: sapat na ang simula ng pangalan o display name, pero kapag may typo, walang mahahanap.

Gusto ko ng ranks, halimbawa moderator at owner

Baguhin ang ADMINS para itugma ang user ID sa isang rank number, at bigyan ang bawat command ng minimum rank na puwedeng magpatakbo nito.

Buuin ito gamit ang RoCode

Kung ayaw mong i-set up ito nang mano-mano, kayang buuin ito ng RoCode sa place na bukas mo. Ang RoCode ay isang independent na AI agent para sa Roblox Studio, hindi galing sa Roblox: ilalarawan mo ang pagbabago sa web chat, at ang plugin nito para sa Studio ang gagawa ng mga script sa Explorer mo.

Ang tina-type mo

Magdagdag ng admin commands para sa akin at sa kaibigan ko (user ID 111 at 222): /kick, /tp, /speed, /heal, /kill at /fly, na may check sa server.

Ang ginagawa ng RoCode
  • Sumusulat ng script ng commands gamit ang admin IDs mo at kahit anong dagdag na command na ilalarawan mo
  • Puwedeng basahin muna ang place mo para gamitin ang nandiyan na, halimbawa ang kasalukuyang setup ng chat
  • Inuutusan itong i-check ang compile ng bawat script gamit ang Check Script, at naglalagay ito ng undo point sa paligid ng bawat batch ng pagbabago

Ikaw pa rin ang kailangang mag-test ng mga command sa playtest, at kailangan ng pangalawang player para i-test ang admin check. Paano kumokonekta ang RoCode sa Studio.

Mga madalas itanong

Paano magdagdag ng admin commands sa sarili kong Roblox game?

Gumawa ng TextChatCommand sa isang server Script, at sa bawat Triggered handler, i-check ang user ID ng nagpadala laban sa admin list mo bago gumawa ng kahit ano. Nasa hakbang 1 ang buong script.

Kailangan ko ba ng HD Admin o Adonis?

Hindi. Ang mga admin system mula sa Creator Store ay nagdadagdag ng maraming command at isang panel, pero malaking code iyon na hindi ikaw ang sumulat. Ang maikling sariling script ay ginagawa lang ang eksaktong kailangan mo, wala nang iba.

Paano malalaman ang user ID ko sa Roblox?

Buksan ang profile mo sa roblox.com: ang number sa link sa pagitan ng /users/ at /profile ang user ID mo.

Nakikita ba ng mga player ang admin commands sa chat?

Hindi. Ang message na tumugma sa isang TextChatCommand ay hindi ipinapadala sa ibang player.

Mga source at dagdag na babasahin

Paano sinuri ang code: bawat script sa page na ito ay dumaan sa strict Luau type check gamit ang mga definition ng Roblox API (luau-lsp, Nobyembre 20, 2026). Nahuhuli ng type check ang maling pangalan ng API at maling type, pero hindi ang mga mali sa game logic, kaya i-test muna ang lahat sa Studio bago mag-publish.

Subukan ang RoCode sa sarili mong game.

Libreng credits araw-araw, walang card. I-install ang plugin, ilarawan ang feature, at tingnan kung ano ang lumabas sa Studio.