In breve
In uno Script in ServerScriptService crea una TextChatCommand per ogni comando, imposta il suo PrimaryAlias (per esempio "/kick") e mettila in TextChatService. Il suo evento Triggered passa il TextSource del mittente e il testo completo del messaggio. Trova il giocatore con Players:GetPlayerByUserId(textSource.UserId), controlla che il suo user ID sia nella tua lista di admin, poi dividi il messaggio in parole ed esegui l'azione.
- Controlla la lista di admin sul server. Un controllo in un LocalScript può essere aggirato da un exploiter.
- Controlla gli user ID, non i nomi: i giocatori possono cambiare nome, ma l'ID non cambia mai.
- Un messaggio che corrisponde a un comando non viene mostrato in chat, quindi i comandi non intasano la chat degli altri giocatori.
In questa pagina
Come funzionano i comandi chat
Una TextChatCommand dentro TextChatService osserva i messaggi della chat. Quando un messaggio inizia con il suo PrimaryAlias o SecondaryAlias, seguito da uno spazio o da niente, Roblox non invia il messaggio agli altri giocatori e attiva invece Triggered. Il confronto con l'alias non tiene conto delle maiuscole. L'esempio di comandi personalizzati di Roblox si collega a Triggered in uno Script lato server, ed è proprio lì il posto per il controllo admin.
| Cosa scrivere in chat | Cosa succede |
|---|---|
/kick Name | Rimuove quel giocatore dal server. |
/tp Name | Ti teletrasporta da lui. /tp Name1 Name2 manda Name1 da Name2. |
/speed Name 50 | Imposta il suo WalkSpeed (da 0 a 200). Senza numero torna a 16. |
/heal Name | Gli ripristina completamente la salute. |
/kill Name | Uccide il suo personaggio. |
Al posto del nome puoi scrivere me, all o others, e basta l'inizio del nome: /heal ro cura tutti i giocatori il cui nome o nome visualizzato inizia con «ro».
Passo 1: aggiungi i comandi
- Assicurati che il gioco usi TextChatService: seleziona TextChatService nell'Explorer e guarda ChatVersion nella finestra Properties. Se in un vecchio place c'è ancora LegacyChatService, la pagina di Roblox sulla chat testuale in gioco ha una sezione sulla migrazione.
- Inserisci uno Script in ServerScriptService chiamato
AdminCommandse incolla il codice qui sotto. - Sostituisci
123456inADMINScon il tuo user ID.
-- Script in ServerScriptService chiamato AdminCommands.
-- Comandi chat per gli user ID in ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")
-- Il tuo user ID è il numero nel link del profilo: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
[123456] = true,
}
local function isAdmin(userId: number): boolean
-- Nel playtest di Studio, in un place che possiedi personalmente, sei considerato admin anche tu
local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
return ADMINS[userId] == true or ownerInStudio
end
-- Cerca i giocatori per l'inizio del nome o del nome visualizzato, oppure "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: da lui. /tp name1 name2: manda name1 da 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,
}
-- Crea una TextChatCommand per ogni comando. Il risultato lo ottengono solo gli admin; per gli altri
-- il comando non fa nulla, e anche il messaggio non viene mostrato in chat.
for name, handler in commands do
local command = Instance.new("TextChatCommand")
command.Name = "Admin_" .. name
command.PrimaryAlias = "/" .. name
command.AutocompleteVisible = false -- i comandi non compaiono nei suggerimenti degli altri giocatori
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
La tabella commands associa una funzione a ogni nome. Il ciclo in fondo trasforma ogni voce in una TextChatCommand, quindi un nuovo comando è solo una voce in più nella tabella. string.split(unfilteredText, " ") divide il messaggio in parole: args[1] è il comando, args[2] il bersaglio, args[3] il numero o il secondo bersaglio.
AutocompleteVisible = false toglie i comandi dai suggerimenti che ogni giocatore vede quando digita la barra. Se un admin scrive il comando per intero, funziona comunque.
Passo 2: aggiungi un tuo comando
Aggiungi una voce alla tabella commands. Per esempio un comando /jump Name 100 che imposta la forza del salto:
- Copia la voce
speede rinominala injump. - Al suo interno imposta
humanoid.UseJumpPower = trueehumanoid.JumpPower = math.clamp(power, 0, 300).
Per un messaggio a tutti, come un annuncio, invialo tramite un RemoteEvent che ogni client mostra sullo schermo. Tutto ciò che i giocatori possono leggere e che arriva da un testo digitato deve prima passare dal filtro del testo di Roblox, quindi per gli annunci usa messaggi fissi oppure filtrali con TextService:FilterStringAsync.
Prova
- Premi Play in un place che possiedi. Scrivi in chat
/speed me 60: corri più veloce e il messaggio non compare in chat. - Dopo una caduta scrivi
/heal meper controllare che la salute torni. - Avvia un test con 2 giocatori (scheda Test, Clients and Servers). Da Player1 scrivi
/tp Player2. Da Player2, che non è admin, scrivi/kill Player1: non succede nulla.
Errori comuni e soluzioni
Se un comando non fa nulla, controlla prima la finestra Output e questi punti.
Il comando compare in chat e non succede nulla
TextChatCommand appartiene a TextChatService. Controlla la proprietà ChatVersion di TextChatService, e anche che lo script sia uno Script in ServerScriptService e che nell'Output non ci sia un errore rosso.
Nel gioco pubblicato il comando non fa nulla per me
Il tuo user ID non è in ADMINS. L'eccezione per Studio vale solo in Studio e solo per un place posseduto dal tuo account personale, non da un gruppo.
/tp non fa nulla
Entrambi i giocatori devono avere un personaggio nel mondo. Controlla il nome del bersaglio: basta l'inizio del nome o del nome visualizzato, ma con un errore di battitura non si trova nessuno.
Voglio dei ranghi, per esempio moderatore e proprietario
Cambia ADMINS in modo che ogni user ID corrisponda a un numero di rango, e assegna a ogni comando il rango minimo che può eseguirlo.
Costruiscilo con RoCode
Se non vuoi configurarlo a mano, RoCode può costruirlo nel place che hai aperto. RoCode è un agente IA indipendente per Roblox Studio, non di Roblox: descrivi la modifica nella chat web e il suo plugin per Studio crea gli script nel tuo Explorer.
Aggiungi comandi admin per me e per il mio amico (user ID 111 e 222): /kick, /tp, /speed, /heal, /kill e /fly, con il controllo sul server.
- Scrive lo script dei comandi con i tuoi ID admin e tutti i comandi in più che descrivi
- Può prima leggere il tuo place per usare ciò che c'è già, per esempio la configurazione della chat esistente
- Ha l'istruzione di verificare la compilazione di ogni script con Check Script, e mette punti di annullamento attorno a ogni gruppo di modifiche
Provare i comandi nel playtest tocca comunque a te, e per controllare il blocco admin serve un secondo giocatore. Come RoCode si collega a Studio.
Domande frequenti
Come aggiungo comandi admin al mio gioco Roblox?
Crea delle TextChatCommand in uno Script lato server e in ogni gestore Triggered controlla lo user ID del mittente con la tua lista di admin prima di fare qualsiasi cosa. Lo script completo è nel passo 1.
Mi serve HD Admin o Adonis?
No. I sistemi admin del Creator Store aggiungono molti comandi e un pannello, ma sono tanto codice che non hai scritto tu. Un breve script tuo fa esattamente ciò che ti serve e niente di più.
Come trovo il mio user ID su Roblox?
Apri il tuo profilo su roblox.com: il numero nel link tra /users/ e /profile è il tuo user ID.
I giocatori vedono i comandi admin in chat?
No. Un messaggio che corrisponde a una TextChatCommand non viene inviato agli altri giocatori.
Fonti e letture
- Roblox Creator Docs: TextChatCommand (in inglese). alias, AutocompleteVisible e Triggered
- Roblox Creator Docs: Custom text chat commands (in inglese). lo Script lato server che gestisce il comando
- Roblox Creator Docs: Player:Kick (in inglese). rimuovere un giocatore con un messaggio
- Roblox Creator Docs: Text filtering (in inglese). quando il testo digitato va filtrato
Come è stato controllato il codice: ogni script di questa pagina supera il controllo dei tipi rigoroso di Luau con le definizioni dell'API di Roblox (luau-lsp, 20 novembre 2026). Il controllo dei tipi trova API scritte male e tipi sbagliati, non la logica del gioco, quindi provalo in Studio prima di pubblicare.