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
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.
| Digite no chat | O que acontece |
|---|---|
/kick Name | Remove aquele jogador do servidor. |
/tp Name | Teleporta você até ele. /tp Name1 Name2 manda Name1 até Name2. |
/speed Name 50 | Define a WalkSpeed dele (de 0 a 200). Sem número, volta para 16. |
/heal Name | Enche a vida dele. |
/kill Name | Mata 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
- 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.
- Insira um Script no ServerScriptService chamado
AdminCommandse cole o código abaixo. - Troque
123456emADMINSpelo seu user ID.
-- 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
speede renomeie parajump. - Dentro dela, defina
humanoid.UseJumpPower = trueehumanoid.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
- Aperte Play em um jogo que é seu. Digite
/speed me 60no chat: você corre mais rápido, e a mensagem não aparece no chat. - Digite
/heal medepois de cair para conferir se a vida volta. - 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.
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.
- 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
- Roblox Creator Docs: TextChatCommand (em inglês). aliases, AutocompleteVisible e Triggered
- Roblox Creator Docs: Custom text chat commands (em inglês). um Script de servidor que trata um comando
- Roblox Creator Docs: Player:Kick (em inglês). remover um jogador com uma mensagem
- Roblox Creator Docs: Text filtering (em inglês). quando texto digitado precisa ser filtrado
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.