Tutorial · Gameplay

Admin-Befehle in Roblox Studio erstellen

Mit Admin-Befehlen steuerst du dein eigenes Spiel aus dem Chat: einen Störenfried kicken, dich zu einem Freund teleportieren, eine Geschwindigkeit testen. Der aktuelle Chat von Roblox, TextChatService, hat Befehle über TextChatCommand schon eingebaut. Dieser Guide baut damit eine Reihe von Admin-Befehlen, die alle auf dem Server gegen eine Liste von User-IDs geprüft werden, sodass niemand sonst sie nutzen kann.

Aktualisiert am 12. November 20264 Min. LesezeitGeschrieben von

Kurz gesagt

Erstelle in einem Script in ServerScriptService für jeden Befehl ein TextChatCommand, setz seinen PrimaryAlias (zum Beispiel "/kick") und leg es in TextChatService. Sein Event Triggered gibt dir die TextSource des Absenders und die ganze Nachricht. Such den Spieler mit Players:GetPlayerByUserId(textSource.UserId), prüf, ob seine User-ID in deiner Admin-Liste steht, teil dann die Nachricht in Wörter auf und handle.

  • Prüf die Admin-Liste auf dem Server. Eine Prüfung in einem LocalScript kann ein Exploiter überspringen.
  • Prüf User-IDs, keine Namen: Spieler können ihren Namen ändern, IDs ändern sich nie.
  • Eine Nachricht, die zu einem Befehl passt, wird nicht im Chat angezeigt, also spammen Befehle andere Spieler nicht zu.
Auf dieser Seite
  1. So funktioniert es
  2. 1. Das Skript
  3. 2. Eigener Befehl
  4. Häufige Fehler
  5. Mit RoCode
  6. Häufige Fragen
  7. Quellen und weiterführende Links

So funktionieren Chat-Befehle

Ein TextChatCommand in TextChatService beobachtet die Nachrichten, die im Chat gesendet werden. Beginnt eine Nachricht mit seinem PrimaryAlias oder SecondaryAlias, gefolgt von einem Leerzeichen oder nichts, schickt Roblox die Nachricht nicht an andere Spieler und feuert stattdessen Triggered. Beim Vergleich mit dem Alias spielt Groß- und Kleinschreibung keine Rolle. Das Beispiel von Roblox für eigene Befehle verbindet sich in einem Server-Script mit Triggered, und genau dort gehört eine Admin-Prüfung hin.

Die Befehle in diesem Guide
Im Chat eingebenWas passiert
/kick NameEntfernt diesen Spieler vom Server.
/tp NameTeleportiert dich zu ihm. /tp Name1 Name2 schickt Name1 zu Name2.
/speed Name 50Setzt seine WalkSpeed (0 bis 200). Ohne Zahl geht sie zurück auf 16.
/heal NameSetzt seine Gesundheit auf voll.
/kill NameTötet seine Figur.

Statt eines Namens kannst du me, all oder others schreiben, und der Anfang eines Namens reicht: /heal ro heilt jeden Spieler, dessen Name oder Anzeigename mit „ro“ beginnt.

Schritt 1: Die Befehle hinzufügen

  1. Prüf, ob dein Spiel TextChatService nutzt: Wähl im Explorer TextChatService aus und sieh dir im Properties-Fenster ChatVersion an. Steht bei einem alten Spiel noch LegacyChatService, hat die Seite von Roblox zum Text-Chat im Spiel einen Abschnitt zum Umstieg.
  2. Füge in ServerScriptService ein Script namens AdminCommands ein und füge den Code unten ein.
  3. Ersetz 123456 in ADMINS durch deine User-ID.
Script in ServerScriptService namens AdminCommands
-- Script in ServerScriptService namens AdminCommands.
-- Chat-Befehle für die User-IDs in ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")

-- Deine User-ID ist die Zahl in deinem Profil-Link: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
	[123456] = true,
}

local function isAdmin(userId: number): boolean
	-- In einem Studio-Playtest eines Spiels, das dir selbst gehört, zählst du auch als Admin
	local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
	return ADMINS[userId] == true or ownerInStudio
end

-- Findet Spieler über den Anfang ihres Namens oder Anzeigenamens, oder "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: zu ihm gehen. /tp name1 name2: name1 zu name2 schicken.
		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,
}

-- Erstellt ein TextChatCommand pro Befehl. Nur Admins bekommen ein Ergebnis; für alle anderen
-- macht der Befehl nichts, und die Nachricht wird auch nicht im Chat angezeigt.
for name, handler in commands do
	local command = Instance.new("TextChatCommand")
	command.Name = "Admin_" .. name
	command.PrimaryAlias = "/" .. name
	command.AutocompleteVisible = false -- hält die Befehle aus den Vorschlägen aller Spieler heraus
	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

Die Tabelle commands ordnet jedem Namen eine Funktion zu. Die Schleife ganz unten macht aus jedem Eintrag ein TextChatCommand, also ist ein neuer Befehl nur ein weiterer Eintrag in der Tabelle. string.split(unfilteredText, " ") zerlegt die Nachricht in Wörter: args[1] ist der Befehl, args[2] das Ziel, args[3] eine Zahl oder ein zweites Ziel.

AutocompleteVisible = false hält die Befehle aus den Vorschlägen heraus, die jeder Spieler sieht, wenn er einen Schrägstrich tippt. Sie funktionieren trotzdem, wenn ein Admin sie vollständig eintippt.

Schritt 2: Einen eigenen Befehl hinzufügen

Füge der Tabelle commands einen Eintrag hinzu. Zum Beispiel einen Befehl /jump Name 100, der die Sprungkraft setzt:

  • Kopier den Eintrag speed und benenn ihn in jump um.
  • Setz darin humanoid.UseJumpPower = true und humanoid.JumpPower = math.clamp(power, 0, 300).

Für eine Nachricht an alle, zum Beispiel eine Ankündigung, schick sie über ein RemoteEvent (auf Englisch), das jeder Client auf dem Bildschirm anzeigt. Alles, was Spieler lesen können und aus getipptem Text stammt, muss zuerst durch die Textfilterung von Roblox, also beschränk Ankündigungen auf feste Nachrichten oder filtere sie mit TextService:FilterStringAsync.

Testen

  1. Drück in einem Spiel, das dir gehört, auf Play. Tipp /speed me 60 in den Chat: Du läufst schneller, und die Nachricht erscheint nicht im Chat.
  2. Tipp nach einem Sturz /heal me, um zu prüfen, ob die Gesundheit zurückkommt.
  3. Starte einen Test mit 2 Spielern (Tab Test, Clients and Servers). Tipp als Player1 /tp Player2. Tipp als Player2, der kein Admin ist, /kill Player1: Nichts passiert.

Häufige Fehler und Lösungen

Wenn ein Befehl nichts tut, prüf zuerst das Output-Fenster und diese Punkte.

Der Befehl erscheint im Chat, und nichts passiert

TextChatCommand gehört zu TextChatService. Prüf die Eigenschaft ChatVersion von TextChatService und ob das Skript ein Script in ServerScriptService ist, ohne roten Fehler im Output.

Im Live-Spiel macht der Befehl bei mir nichts

Deine User-ID steht nicht in ADMINS. Die Studio-Ausnahme gilt nur in Studio und nur für ein Spiel, das deinem eigenen Konto gehört, nicht einer Gruppe.

/tp macht nichts

Beide Spieler brauchen eine Figur in der Welt. Prüf den Zielnamen: Der Anfang des Namens oder Anzeigenamens reicht, aber mit einem Tippfehler passt niemand.

Ich will Ränge wie Moderator und Besitzer

Lass ADMINS jeder User-ID eine Rangnummer zuordnen und gib jedem Befehl den niedrigsten Rang, der ihn ausführen darf.

Mit RoCode bauen

Wenn du das nicht von Hand einrichten willst, kann RoCode es in dem Spiel bauen, das du offen hast. RoCode ist ein unabhängiger KI-Agent für Roblox Studio und stammt nicht von Roblox: Du beschreibst die Änderung in einem Webchat, und sein Studio-Plugin erstellt die Skripte in deinem Explorer. Prompts kannst du auf Deutsch schreiben.

Du schreibst

Füge Admin-Befehle für mich und meinen Freund hinzu (User-IDs 111 und 222): /kick, /tp, /speed, /heal, /kill und /fly, auf dem Server geprüft.

RoCode macht
  • Schreibt das Befehlsskript mit deinen Admin-IDs und allen zusätzlichen Befehlen, die du beschreibst
  • Kann zuerst dein Spiel lesen, um zu nutzen, was schon da ist, zum Beispiel ein vorhandenes Chat-Setup
  • Ist angewiesen, jedes Skript mit Check Script auf Kompilierfehler zu prüfen, und setzt um jede Änderungsrunde Undo-Punkte

Die Befehle testest du trotzdem selbst in einem Playtest, und für die Admin-Prüfung mit einem zweiten Spieler. Wie sich RoCode mit Studio verbindet.

Häufige Fragen

Wie füge ich meinem Roblox-Spiel Admin-Befehle hinzu?

Erstelle TextChatCommands in einem Server-Script und prüf in jedem Triggered-Handler die User-ID des Absenders gegen deine Admin-Liste, bevor du handelst. Schritt 1 hat das komplette Skript.

Brauche ich HD Admin oder Adonis?

Nein. Admin-Systeme aus dem Creator Store bringen viele Befehle und ein Panel mit, aber sie sind viel Code, den du nicht selbst geschrieben hast. Ein kurzes eigenes Skript macht genau, was du brauchst, und nichts anderes.

Wie finde ich meine Roblox User-ID?

Öffne dein Profil auf roblox.com: Die Zahl im Link, zwischen /users/ und /profile, ist deine User-ID.

Können Spieler Admin-Befehle im Chat sehen?

Nein. Eine Nachricht, die zu einem TextChatCommand passt, wird nicht an andere Spieler geschickt.

Quellen und weiterführende Links

So wurde der Code geprüft: Jedes Skript auf dieser Seite besteht die strikte Typprüfung von Luau mit den Roblox API-Definitionen (luau-lsp, 12. November 2026). Eine Typprüfung findet falsch geschriebene APIs und falsche Typen, aber keine Fehler in der Spiellogik. Teste also in Studio, bevor du veröffentlichst.

Probier RoCode in deinem eigenen Spiel aus.

Jeden Tag kostenlose Credits, ohne Karte. Installiere das Plugin, beschreibe das Feature und prüfe, was in Studio ankommt.