Tutoriel · Gameplay

Comment faire des commandes admin sur Roblox Studio

Les commandes admin te permettent de gérer ton jeu depuis la boîte de chat : expulser un fauteur de troubles, te téléporter vers un ami, tester une vitesse. Le chat actuel de Roblox, TextChatService, a des commandes intégrées grâce à TextChatCommand. Ce guide ajoute avec lui une série de commandes admin, toutes vérifiées sur le serveur avec une liste d'ID d'utilisateurs, pour que personne d'autre ne puisse s'en servir.

Mis à jour le 12 novembre 20265 min de lectureÉcrit par

En bref

Dans un Script dans ServerScriptService, crée un TextChatCommand pour chaque commande, règle son PrimaryAlias (par exemple "/kick") et mets-le dans TextChatService. Son événement Triggered te donne le TextSource de l'expéditeur et le message complet. Trouve le joueur avec Players:GetPlayerByUserId(textSource.UserId), vérifie que son ID d'utilisateur est dans ta liste d'admins, puis découpe le message en mots et agis.

  • Vérifie la liste d'admins sur le serveur. Un tricheur peut contourner une vérification faite dans un LocalScript.
  • Vérifie les ID d'utilisateurs, pas les noms : les joueurs peuvent changer de nom, les ID ne changent jamais.
  • Un message qui correspond à une commande n'est pas affiché dans le chat, donc les commandes ne spamment pas les autres joueurs.
Sur cette page
  1. Fonctionnement
  2. 1. Le script
  3. 2. Ta propre commande
  4. Problèmes courants
  5. Avec RoCode
  6. Questions fréquentes
  7. Sources et lectures

Comment marchent les commandes de chat

Un TextChatCommand placé dans TextChatService surveille les messages envoyés dans le chat. Quand un message commence par son PrimaryAlias ou son SecondaryAlias, suivi d'un espace ou de rien, Roblox n'envoie pas le message aux autres joueurs et déclenche Triggered à la place. La correspondance avec l'alias ignore les majuscules. L'exemple de commandes personnalisées de Roblox se connecte à Triggered dans un Script serveur, et c'est là que doit se trouver la vérification admin.

Les commandes de ce guide
À taper dans le chatCe qui se passe
/kick NameRetire ce joueur du serveur.
/tp NameTe téléporte vers lui. /tp Name1 Name2 envoie Name1 vers Name2.
/speed Name 50Règle sa WalkSpeed (de 0 à 200). Sans nombre, elle revient à 16.
/heal NameRemet sa santé au maximum.
/kill NameTue son personnage.

À la place d'un nom, tu peux écrire me, all ou others, et le début d'un nom suffit : /heal ro soigne chaque joueur dont le nom ou le nom d'affichage commence par « ro ».

Étape 1 : ajouter les commandes

  1. Vérifie que ton jeu utilise TextChatService : sélectionne TextChatService dans l'Explorer et regarde ChatVersion dans la fenêtre Properties. Si un ancien jeu indique encore LegacyChatService, la page de Roblox sur le chat textuel en jeu a une partie sur la migration.
  2. Insère un Script dans ServerScriptService, nomme-le AdminCommands et colle le code ci-dessous.
  3. Remplace 123456 dans ADMINS par ton ID d'utilisateur.
Script dans ServerScriptService nommé AdminCommands
-- Script dans ServerScriptService nommé AdminCommands.
-- Commandes de chat pour les ID d'utilisateurs de ADMINS : /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")

-- Ton ID d'utilisateur est le nombre dans le lien de ton profil : roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
	[123456] = true,
}

local function isAdmin(userId: number): boolean
	-- Dans un test Studio d'un jeu qui t'appartient, tu comptes aussi comme admin
	local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
	return ADMINS[userId] == true or ownerInStudio
end

-- Trouve les joueurs par le début de leur nom ou nom d'affichage, 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 nom : aller vers lui. /tp nom1 nom2 : envoyer nom1 vers nom2.
		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 nom 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,
}

-- Crée un TextChatCommand par commande. Seuls les admins obtiennent un résultat ; pour tous
-- les autres, la commande ne fait rien, et le message n'apparaît pas non plus dans le chat.
for name, handler in commands do
	local command = Instance.new("TextChatCommand")
	command.Name = "Admin_" .. name
	command.PrimaryAlias = "/" .. name
	command.AutocompleteVisible = false -- garde les commandes hors des suggestions de tout le monde
	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 table commands associe chaque nom à une fonction. La boucle du bas transforme chaque entrée en TextChatCommand, donc ajouter une commande, c'est ajouter une entrée dans la table. string.split(unfilteredText, " ") découpe le message en mots : args[1] est la commande, args[2] la cible, args[3] un nombre ou une deuxième cible.

AutocompleteVisible = false garde les commandes hors des suggestions que chaque joueur voit quand il tape une barre oblique. Elles marchent toujours quand un admin les tape en entier.

Étape 2 : ajouter ta propre commande

Ajoute une entrée dans la table commands. Par exemple, une commande /jump Name 100 qui règle la puissance de saut :

  • Copie l'entrée speed et renomme-la jump.
  • À l'intérieur, règle humanoid.UseJumpPower = true et humanoid.JumpPower = math.clamp(power, 0, 300).

Pour un message à tout le monde, comme une annonce, envoie-le par un RemoteEvent (guide en anglais) que chaque client affiche à l'écran. Tout texte tapé que les joueurs peuvent lire doit d'abord passer par le filtrage de texte de Roblox, donc limite les annonces à des messages fixes, ou filtre-les avec TextService:FilterStringAsync.

Le tester

  1. Appuie sur Play dans un jeu qui t'appartient. Tape /speed me 60 dans le chat : tu cours plus vite, et le message n'apparaît pas dans le chat.
  2. Tape /heal me après une chute pour vérifier que ta santé revient.
  3. Lance un test à 2 joueurs (onglet Test, Clients and Servers). Depuis Player1, tape /tp Player2. Depuis Player2, qui n'est pas admin, tape /kill Player1 : rien ne se passe.

Problèmes courants

Si une commande ne fait rien, regarde d'abord la fenêtre Output et ces points.

La commande s'affiche dans le chat et rien ne se passe

TextChatCommand fait partie de TextChatService. Vérifie la propriété ChatVersion de TextChatService, et que le script est un Script dans ServerScriptService sans erreur rouge dans l'Output.

La commande ne fait rien pour moi dans le jeu publié

Ton ID d'utilisateur n'est pas dans ADMINS. L'exception de Studio ne marche que dans Studio, et seulement pour un jeu qui appartient à ton propre compte, pas à un groupe.

/tp ne fait rien

Les deux joueurs doivent avoir un personnage dans le monde. Vérifie le nom de la cible : le début du nom ou du nom d'affichage suffit, mais une faute de frappe ne correspond à personne.

Je veux des rangs comme modérateur et propriétaire

Change ADMINS pour associer chaque ID d'utilisateur à un numéro de rang, et donne à chaque commande le rang le plus bas qui a le droit de la lancer.

Le faire avec RoCode

Si tu préfères ne pas tout configurer à la main, RoCode peut le construire dans le jeu que tu as ouvert. RoCode est un agent IA indépendant pour Roblox Studio, qui n'est pas fait par Roblox : tu décris le changement dans un chat web, et son plugin pour Studio crée les scripts dans ton Explorer.

Tu écris

Ajoute des commandes admin pour moi et mon ami (ID d'utilisateurs 111 et 222) : /kick, /tp, /speed, /heal, /kill et /fly, vérifiées sur le serveur.

RoCode fait
  • Écrit le script de commandes avec tes ID d'admins et les commandes en plus que tu décris
  • Peut d'abord lire ton jeu pour réutiliser ce qui s'y trouve, comme une configuration de chat existante
  • A pour consigne de vérifier la compilation de chaque script avec Check Script, et place des points d'annulation autour de chaque lot de changements

Tu testes toujours les commandes toi-même dans un test, et avec un deuxième joueur pour la vérification admin. Comment RoCode se connecte à Studio.

Questions fréquentes

Comment ajouter des commandes admin à mon jeu Roblox ?

Crée des TextChatCommands dans un Script serveur, et dans chaque fonction Triggered, vérifie l'ID d'utilisateur de l'expéditeur avec ta liste d'admins avant d'agir. L'étape 1 contient le script complet.

Est-ce que j'ai besoin de HD Admin ou d'Adonis ?

Non. Les systèmes d'admin du Creator Store ajoutent beaucoup de commandes et un panneau, mais c'est beaucoup de code que tu n'as pas écrit. Un court script à toi fait exactement ce dont tu as besoin, et rien d'autre.

Comment trouver mon ID d'utilisateur Roblox ?

Ouvre ton profil sur roblox.com : le nombre dans le lien, entre /users/ et /profile, est ton ID d'utilisateur.

Les joueurs voient-ils les commandes admin dans le chat ?

Non. Un message qui correspond à un TextChatCommand n'est pas envoyé aux autres joueurs.

Sources et lectures

Comment le code a été vérifié : chaque script de cette page passe le vérificateur de types strict de Luau avec les définitions de l'API Roblox (luau-lsp, 12 novembre 2026). Une vérification de types repère les API mal écrites et les mauvais types, pas la logique du jeu : teste dans Studio avant de publier.

Essaie RoCode sur ton propre jeu.

Des crédits gratuits chaque jour, sans carte. Installe le plugin, décris la fonctionnalité et vérifie ce qui arrive dans Studio.