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
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.
| Im Chat eingeben | Was passiert |
|---|---|
/kick Name | Entfernt diesen Spieler vom Server. |
/tp Name | Teleportiert dich zu ihm. /tp Name1 Name2 schickt Name1 zu Name2. |
/speed Name 50 | Setzt seine WalkSpeed (0 bis 200). Ohne Zahl geht sie zurück auf 16. |
/heal Name | Setzt seine Gesundheit auf voll. |
/kill Name | Tö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
- 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.
- Füge in ServerScriptService ein Script namens
AdminCommandsein und füge den Code unten ein. - Ersetz
123456inADMINSdurch deine User-ID.
-- 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
speedund benenn ihn injumpum. - Setz darin
humanoid.UseJumpPower = trueundhumanoid.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
- Drück in einem Spiel, das dir gehört, auf Play. Tipp
/speed me 60in den Chat: Du läufst schneller, und die Nachricht erscheint nicht im Chat. - Tipp nach einem Sturz
/heal me, um zu prüfen, ob die Gesundheit zurückkommt. - 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.
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.
- 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
- Roblox Creator Docs: TextChatCommand (auf Englisch). Aliase, AutocompleteVisible und Triggered
- Roblox Creator Docs: Custom text chat commands (auf Englisch). ein Server-Script, das einen Befehl behandelt
- Roblox Creator Docs: Player:Kick (auf Englisch). einen Spieler mit einer Nachricht entfernen
- Roblox Creator Docs: Text filtering (auf Englisch). wann getippter Text gefiltert werden muss
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.