Tutorial · Gameplay

Come creare comandi admin in Roblox Studio

I comandi admin ti permettono di gestire il tuo gioco direttamente dalla chat: espellere chi viola le regole, teletrasportarti da un amico, provare la velocità. Nella chat attuale di Roblox, TextChatService, i comandi sono integrati tramite TextChatCommand. In questa guida aggiungi su questa base un set di comandi admin, e ognuno viene controllato sul server con una lista di user ID, così nessun altro può usarli.

Aggiornato il 20 novembre 20265 min di letturaScritto da

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
  1. Come funziona
  2. 1. Lo script
  3. 2. Un tuo comando
  4. Common errors
  5. With RoCode
  6. Domande frequenti
  7. Fonti e letture

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.

I comandi di questa guida
Cosa scrivere in chatCosa succede
/kick NameRimuove quel giocatore dal server.
/tp NameTi teletrasporta da lui. /tp Name1 Name2 manda Name1 da Name2.
/speed Name 50Imposta il suo WalkSpeed (da 0 a 200). Senza numero torna a 16.
/heal NameGli ripristina completamente la salute.
/kill NameUccide 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

  1. 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.
  2. Inserisci uno Script in ServerScriptService chiamato AdminCommands e incolla il codice qui sotto.
  3. Sostituisci 123456 in ADMINS con il tuo user ID.
Script in ServerScriptService chiamato AdminCommands
-- 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 speed e rinominala in jump.
  • Al suo interno imposta humanoid.UseJumpPower = true e humanoid.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

  1. Premi Play in un place che possiedi. Scrivi in chat /speed me 60: corri più veloce e il messaggio non compare in chat.
  2. Dopo una caduta scrivi /heal me per controllare che la salute torni.
  3. 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.

Tu scrivi

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.

RoCode fa
  • 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

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.

Prova RoCode nel tuo gioco.

Crediti gratis ogni giorno, senza carta. Installa il plugin, descrivi la funzione e controlla cosa compare in Studio.