Tutorial · Gameplay

Como fazer comandos de admin no Roblox Studio

Comandos de admin deixam você controlar o seu próprio jogo pela caixa do chat: expulsar quem está atrapalhando, se teleportar até um amigo, testar uma velocidade. O chat atual do Roblox, o TextChatService, já tem comandos embutidos com o TextChatCommand. Este guia cria um conjunto de comandos de admin com ele, todos conferidos no servidor contra uma lista de user IDs, para que ninguém mais consiga usá-los.

Atualizado em 12 de novembro de 20265 min de leituraEscrito por

Resumo

Em um Script no ServerScriptService, crie um TextChatCommand para cada comando, defina o PrimaryAlias dele (como "/kick") e coloque como filho do TextChatService. O evento Triggered entrega o TextSource de quem enviou e a mensagem completa. Ache o jogador com Players:GetPlayerByUserId(textSource.UserId), confira se o user ID dele está na sua lista de admins, depois divida a mensagem em palavras e execute.

  • Confira a lista de admins no servidor. Uma checagem em um LocalScript pode ser pulada por um exploiter.
  • Confira user IDs, não nomes: os jogadores podem trocar de nome, os IDs nunca mudam.
  • Uma mensagem que bate com um comando não aparece no chat, então os comandos não enchem o chat dos outros jogadores.
Nesta página
  1. Como funciona
  2. 1. O script
  3. 2. Seu próprio comando
  4. Erros comuns
  5. Com o RoCode
  6. Perguntas frequentes
  7. Fontes e leitura extra

Como os comandos de chat funcionam

Um TextChatCommand dentro do TextChatService observa as mensagens enviadas no chat. Quando uma mensagem começa com o PrimaryAlias ou o SecondaryAlias dele, seguido de um espaço ou de nada, o Roblox não envia a mensagem aos outros jogadores e dispara o Triggered no lugar. A comparação do alias ignora maiúsculas. O exemplo de comandos personalizados da Roblox conecta o Triggered em um Script de servidor, que é onde a checagem de admin deve ficar.

Os comandos deste guia
Digite no chatO que acontece
/kick NameRemove aquele jogador do servidor.
/tp NameTeleporta você até ele. /tp Name1 Name2 manda Name1 até Name2.
/speed Name 50Define a WalkSpeed dele (de 0 a 200). Sem número, volta para 16.
/heal NameEnche a vida dele.
/kill NameMata o personagem dele.

No lugar de um nome você pode escrever me, all ou others, e o começo de um nome já basta: /heal ro cura todo jogador cujo nome ou display name começa com "ro".

Passo 1: Adicione os comandos

  1. Confira se o seu jogo usa o TextChatService: selecione TextChatService no Explorer e olhe a ChatVersion na janela Properties. Se um jogo antigo ainda mostra LegacyChatService, a página de chat de texto da Roblox tem uma seção sobre como migrar.
  2. Insira um Script no ServerScriptService chamado AdminCommands e cole o código abaixo.
  3. Troque 123456 em ADMINS pelo seu user ID.
Script em ServerScriptService chamado AdminCommands
-- Script no ServerScriptService chamado AdminCommands.
-- Comandos de chat para os user IDs em ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")

-- Seu user ID é o número no link do seu perfil: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
	[123456] = true,
}

local function isAdmin(userId: number): boolean
	-- Em um teste no Studio de um jogo que é seu, você também conta como admin
	local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
	return ADMINS[userId] == true or ownerInStudio
end

-- Acha jogadores pelo começo do nome ou do display name, ou "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 nome: vai até ele. /tp nome1 nome2: manda nome1 até nome2.
		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 nome 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,
}

-- Cria um TextChatCommand por comando. Só os admins têm resultado; para todo mundo
-- mais o comando não faz nada, e a mensagem também não aparece no chat.
for name, handler in commands do
	local command = Instance.new("TextChatCommand")
	command.Name = "Admin_" .. name
	command.PrimaryAlias = "/" .. name
	command.AutocompleteVisible = false -- deixa os comandos fora das sugestões de todo mundo
	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

A tabela commands liga cada nome a uma função. O loop no final transforma cada entrada em um TextChatCommand, então adicionar um comando é só mais uma entrada na tabela. string.split(unfilteredText, " ") quebra a mensagem em palavras: args[1] é o comando, args[2] o alvo, args[3] um número ou um segundo alvo.

AutocompleteVisible = false deixa os comandos fora das sugestões que todo jogador vê quando digita uma barra. Eles continuam funcionando quando um admin digita o comando inteiro.

Passo 2: Crie o seu próprio comando

Adicione uma entrada à tabela commands. Por exemplo, um comando /jump Name 100 que define a força do pulo:

  • Copie a entrada speed e renomeie para jump.
  • Dentro dela, defina humanoid.UseJumpPower = true e humanoid.JumpPower = math.clamp(power, 0, 300).

Para uma mensagem para todo mundo, como um anúncio, envie por um RemoteEvent (em inglês) que todo cliente mostra na tela. Qualquer coisa que os jogadores possam ler e que veio de texto digitado precisa passar antes pelo filtro de texto da Roblox, então use anúncios com mensagens fixas, ou filtre com TextService:FilterStringAsync.

Teste

  1. Aperte Play em um jogo que é seu. Digite /speed me 60 no chat: você corre mais rápido, e a mensagem não aparece no chat.
  2. Digite /heal me depois de cair para conferir se a vida volta.
  3. Comece um teste com 2 jogadores (aba Test, Clients and Servers). No Player1, digite /tp Player2. No Player2, que não é admin, digite /kill Player1: nada acontece.

Erros comuns e como resolver

Se um comando não faz nada, confira a janela Output e estes pontos primeiro.

O comando aparece no chat quando eu digito e nada acontece

O TextChatCommand pertence ao TextChatService. Confira a propriedade ChatVersion do TextChatService, e se o script é um Script no ServerScriptService sem erro vermelho no Output.

O comando não faz nada para mim no jogo publicado

O seu user ID não está em ADMINS. A exceção do Studio só vale no Studio e só para um jogo da sua própria conta, não de um grupo.

O /tp não faz nada

Os dois jogadores precisam ter um personagem no mundo. Confira o nome do alvo: o começo do nome ou do display name basta, mas um erro de digitação não acha ninguém.

Quero cargos como moderador e dono

Mude ADMINS para ligar cada user ID a um número de cargo, e dê a cada comando o cargo mais baixo que pode rodá-lo.

Crie com o RoCode

Se você prefere não montar isso à mão, o RoCode pode construir no jogo que você tem aberto. O RoCode é um agente de IA independente para Roblox Studio, não feito pela Roblox: você descreve a mudança em um chat na web, e o plugin dele para o Studio cria os scripts no seu Explorer.

Você digita

Adicione comandos de admin para mim e para o meu amigo (user IDs 111 e 222): /kick, /tp, /speed, /heal, /kill e /fly, conferidos no servidor.

O RoCode faz
  • Escreve o script de comandos com os seus IDs de admin e qualquer comando extra que você descrever
  • Pode ler o seu jogo antes para reaproveitar o que já existe, como uma configuração de chat
  • É instruído a compilar cada script com Check Script, e cria pontos de desfazer em volta de cada lote

Você ainda testa os comandos em um teste, e com um segundo jogador para a checagem de admin. Como o RoCode se conecta ao Studio.

Perguntas frequentes

Como eu adiciono comandos de admin no meu jogo do Roblox?

Crie TextChatCommands em um Script de servidor e, em cada função do Triggered, confira o user ID de quem enviou contra a sua lista de admins antes de agir. O Passo 1 tem o script completo.

Eu preciso do HD Admin ou do Adonis?

Não. Sistemas de admin da Creator Store trazem muitos comandos e um painel, mas são muito código que não foi você quem escreveu. Um script curto seu faz exatamente o que você precisa e nada mais.

Como eu acho o meu user ID do Roblox?

Abra o seu perfil no roblox.com: o número no link, entre /users/ e /profile, é o seu user ID.

Os jogadores conseguem ver os comandos de admin no chat?

Não. Uma mensagem que bate com um TextChatCommand não é enviada aos outros jogadores.

Fontes e leitura extra

Como o código foi verificado: todo script desta página passa no verificador de tipos estrito do Luau com as definições da API do Roblox (luau-lsp, 12 de novembro de 2026). A verificação de tipos pega APIs com nome errado e tipos incorretos, não a lógica do jogo, então teste no Studio antes de publicar.

Teste o RoCode no seu próprio jogo.

Créditos grátis todo dia, sem cartão. Instale o plugin, descreva o recurso e confira o que aparece no Studio.