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
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.
| Wat je in de chat typt | Wat er gebeurt |
|---|---|
/kick Name | Verwijdert die speler van de server. |
/tp Name | Teleporteert jou naar hem. /tp Name1 Name2 stuurt Name1 naar Name2. |
/speed Name 50 | Zet zijn WalkSpeed (van 0 tot 200). Zonder getal terug naar 16. |
/heal Name | Herstelt zijn gezondheid volledig. |
/kill Name | Doodt 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
- 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.
- Voeg een Script toe in ServerScriptService met de naam
AdminCommandsen plak de code hieronder. - Vervang
123456inADMINSdoor je eigen user ID.
-- 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
speeden hernoem die naarjump. - Zet daarin
humanoid.UseJumpPower = trueenhumanoid.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
- Klik op Play in een place die je bezit. Typ
/speed me 60in de chat: je rent sneller en het bericht verschijnt niet in de chat. - Typ na een val
/heal meom te controleren dat je gezondheid terugkomt. - 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.
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.
- 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
- Roblox Creator Docs: TextChatCommand (in het Engels). aliassen, AutocompleteVisible en Triggered
- Roblox Creator Docs: Custom text chat commands (in het Engels). het server-Script dat het command afhandelt
- Roblox Creator Docs: Player:Kick (in het Engels). een speler verwijderen met een bericht
- Roblox Creator Docs: Text filtering (in het Engels). wanneer getypte tekst gefilterd moet worden
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.