Tutorial · Gameplay

Admin commands maken in Roblox Studio

Met admin commands beheer je je game direct vanuit de chat: een overtreder eruit gooien, naar een vriend teleporteren, een snelheid testen. In de huidige Roblox-chat, TextChatService, zijn commands ingebouwd via TextChatCommand. In deze handleiding voeg je daarmee een set admin commands toe, en elk command wordt op de server gecontroleerd tegen een lijst user ID's, zodat niemand anders ze kan gebruiken.

Bijgewerkt 20 november 20265 min lezenAuteur:

In het kort

Maak in een Script in ServerScriptService een TextChatCommand voor elk command, geef het een PrimaryAlias (bijvoorbeeld "/kick") en zet het in TextChatService. Het event Triggered geeft de TextSource van de afzender en de volledige tekst van het bericht door. Zoek de speler op met Players:GetPlayerByUserId(textSource.UserId), controleer of zijn user ID in je adminlijst staat, splits het bericht dan in woorden en voer de actie uit.

  • Controleer de adminlijst op de server. Een controle in een LocalScript kan een exploiter omzeilen.
  • Controleer user ID's, geen namen: spelers kunnen hun naam veranderen, maar een ID verandert nooit.
  • Een bericht dat overeenkomt met een command wordt niet in de chat getoond, dus commands vervuilen de chat niet voor andere spelers.
Op deze pagina
  1. Hoe het werkt
  2. 1. Script
  3. 2. Eigen command
  4. Common errors
  5. With RoCode
  6. Veelgestelde vragen
  7. Bronnen en verder lezen

Hoe chatcommands werken

Een TextChatCommand in TextChatService houdt de chatberichten in de gaten. Als een bericht begint met zijn PrimaryAlias of SecondaryAlias, gevolgd door een spatie of niets, stuurt Roblox het bericht niet naar andere spelers en roept in plaats daarvan Triggered aan. De vergelijking met de alias negeert hoofdletters. Het voorbeeld van Roblox voor eigen commands koppelt Triggered in een server-Script, en precies daar hoort de admincontrole.

Commands uit deze handleiding
Wat je in de chat typtWat er gebeurt
/kick NameVerwijdert die speler van de server.
/tp NameTeleporteert jou naar hem. /tp Name1 Name2 stuurt Name1 naar Name2.
/speed Name 50Zet zijn WalkSpeed (van 0 tot 200). Zonder getal terug naar 16.
/heal NameHerstelt zijn gezondheid volledig.
/kill NameDoodt zijn personage.

In plaats van een naam kun je me, all of others schrijven, en het begin van een naam is genoeg: /heal ro geneest alle spelers van wie de naam of weergavenaam met „ro” begint.

Stap 1: voeg de commands toe

  1. Controleer of de game TextChatService gebruikt: selecteer TextChatService in de Explorer en kijk naar ChatVersion in het venster Properties. Staat er in een oude place nog LegacyChatService, dan heeft de Roblox-pagina over tekstchat in de game een deel over de overstap.
  2. Voeg een Script toe in ServerScriptService met de naam AdminCommands en plak de code hieronder.
  3. Vervang 123456 in ADMINS door je eigen user ID.
Script in ServerScriptService met de naam AdminCommands
-- Script in ServerScriptService met de naam AdminCommands.
-- Chatcommands voor de user ID's in ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")

-- Je user ID is het getal in de link naar je profiel: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
	[123456] = true,
}

local function isAdmin(userId: number): boolean
	-- In een Studio-playtest in een place die je zelf bezit, tel je ook als admin
	local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
	return ADMINS[userId] == true or ownerInStudio
end

-- Zoekt spelers op het begin van de naam of weergavenaam, of "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: naar hem toe. /tp name1 name2: stuur name1 naar 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,
}

-- Maakt per command een TextChatCommand. Alleen admins krijgen een resultaat; voor anderen
-- doet het command niets, en het bericht verschijnt ook niet in de chat.
for name, handler in commands do
	local command = Instance.new("TextChatCommand")
	command.Name = "Admin_" .. name
	command.PrimaryAlias = "/" .. name
	command.AutocompleteVisible = false -- commands komen niet in de suggesties van andere spelers
	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

De tabel commands koppelt aan elke naam een functie. De lus onderaan maakt van elke regel een TextChatCommand, dus een nieuw command is maar één regel in de tabel. string.split(unfilteredText, " ") splitst het bericht in woorden: args[1] is het command, args[2] het doelwit, args[3] een getal of een tweede doelwit.

AutocompleteVisible = false haalt de commands uit de suggesties die elke speler ziet als hij een slash typt. Als een admin het command volledig typt, werkt het nog steeds.

Stap 2: voeg je eigen command toe

Voeg een regel toe aan de tabel commands. Bijvoorbeeld een command /jump Name 100 dat de springkracht instelt:

  • Kopieer de regel speed en hernoem die naar jump.
  • Zet daarin humanoid.UseJumpPower = true en humanoid.JumpPower = math.clamp(power, 0, 300).

Voor een bericht aan iedereen, zoals een aankondiging, stuur je het via een RemoteEvent dat elke client op het scherm toont. Alles wat spelers kunnen lezen en dat uit getypte tekst komt, moet eerst door de tekstfilter van Roblox, dus gebruik voor aankondigingen vaste berichten of filter ze met TextService:FilterStringAsync.

Testen

  1. Klik op Play in een place die je bezit. Typ /speed me 60 in de chat: je rent sneller en het bericht verschijnt niet in de chat.
  2. Typ na een val /heal me om te controleren dat je gezondheid terugkomt.
  3. Start een test met 2 spelers (tabblad Test, Clients and Servers). Typ als Player1 /tp Player2. Typ als Player2, die geen admin is, /kill Player1: er gebeurt niets.

Veelvoorkomende fouten en oplossingen

Als een command niets doet, kijk dan eerst in het venster Output en loop deze punten na.

Het command verschijnt in de chat en er gebeurt niets

TextChatCommand hoort bij TextChatService. Controleer de eigenschap ChatVersion van TextChatService, en ook of het script een Script in ServerScriptService is en er geen rode fout in Output staat.

In de live game doet het command bij mij niets

Je user ID staat niet in ADMINS. De uitzondering voor Studio geldt alleen in Studio en alleen voor een place die van je persoonlijke account is, niet van een groep.

/tp doet niets

Beide spelers moeten een personage in de wereld hebben. Controleer de naam van het doelwit: het begin van de naam of weergavenaam is genoeg, maar met een typfout wordt niemand gevonden.

Ik wil rangen, zoals moderator en eigenaar

Verander ADMINS zodat een user ID aan een rangnummer gekoppeld is, en geef elk command een minimale rang die het mag uitvoeren.

Bouw dit met RoCode

Wil je dit niet met de hand instellen, dan kan RoCode het bouwen in de place die je open hebt. RoCode is een onafhankelijke AI-agent voor Roblox Studio, niet van Roblox: je beschrijft de wijziging in de webchat en de plugin voor Studio maakt de scripts in je Explorer.

Jij typt

Voeg admin commands toe voor mij en mijn vriend (user ID 111 en 222): /kick, /tp, /speed, /heal, /kill en /fly, met controle op de server.

RoCode doet
  • Schrijft het commandscript met jouw admin-ID's en alle extra commands die je beschrijft
  • Kan eerst je place lezen om te gebruiken wat er al is, zoals een bestaande chatinstelling
  • Heeft de opdracht elk script met Check Script te laten compileren, en zet undo-punten rond elke set wijzigingen

De commands in een playtest testen moet je nog steeds zelf doen, en voor de admincontrole heb je een tweede speler nodig. Hoe RoCode verbinding maakt met Studio.

Veelgestelde vragen

Hoe voeg ik admin commands toe aan mijn Roblox-game?

Maak een TextChatCommand in een server-Script en controleer in elke Triggered-handler de user ID van de afzender tegen je adminlijst voordat je iets doet. Het volledige script staat in stap 1.

Heb ik HD Admin of Adonis nodig?

Nee. Adminsystemen uit de Creator Store voegen veel commands en een paneel toe, maar dat is veel code die je niet zelf hebt geschreven. Een kort eigen script doet precies wat je nodig hebt en niets meer.

Hoe vind ik mijn user ID in Roblox?

Open je profiel op roblox.com: het getal in de link tussen /users/ en /profile is je user ID.

Zien spelers admin commands in de chat?

Nee. Een bericht dat overeenkomt met een TextChatCommand wordt niet naar andere spelers gestuurd.

Bronnen en verder lezen

Hoe de code is gecontroleerd: elk script op deze pagina doorloopt een strikte Luau-typecontrole met de Roblox API-definities (luau-lsp, 20 november 2026). De typecontrole vangt fouten in API-namen en verkeerde types op, maar geen fouten in de gamelogica, dus test alles in Studio voordat je publiceert.

Probeer RoCode in je eigen game.

Elke dag gratis credits, geen creditcard nodig. Installeer de plugin, beschrijf een functie en kijk wat er in Studio verschijnt.