I korthet
I ett Script i ServerScriptService skapar du en TextChatCommand för varje kommando, ger den ett PrimaryAlias (till exempel "/kick") och lägger den i TextChatService. Dess händelse Triggered skickar avsändarens TextSource och hela meddelandets text. Hitta spelaren med Players:GetPlayerByUserId(textSource.UserId), kontrollera att spelarens user ID finns i din adminlista, dela sedan upp meddelandet i ord och utför handlingen.
- Kontrollera adminlistan på servern. En kontroll i ett LocalScript kan en exploiter ta sig förbi.
- Kontrollera user ID, inte namn: spelare kan byta namn, men ID:t ändras aldrig.
- Ett meddelande som matchar ett kommando visas inte i chatten, så kommandona skräpar inte ner chatten för andra spelare.
På den här sidan
Så fungerar chattkommandon
En TextChatCommand inuti TextChatService bevakar chattmeddelanden. När ett meddelande börjar med dess PrimaryAlias eller SecondaryAlias, följt av ett mellanslag eller ingenting, skickar Roblox inte meddelandet till andra spelare utan anropar Triggered i stället. Jämförelsen med aliaset bryr sig inte om stora och små bokstäver. Roblox exempel på egna kommandon kopplar Triggered i ett Script på servern, och det är just där adminkontrollen hör hemma.
| Vad du skriver i chatten | Vad som händer |
|---|---|
/kick Name | Tar bort den spelaren från servern. |
/tp Name | Teleporterar dig till spelaren. /tp Name1 Name2 skickar Name1 till Name2. |
/speed Name 50 | Sätter spelarens WalkSpeed (från 0 till 200). Utan tal återställs den till 16. |
/heal Name | Återställer spelarens hälsa helt. |
/kill Name | Dödar spelarens karaktär. |
I stället för ett namn kan du skriva me, all eller others, och det räcker med början av namnet: /heal ro helar alla spelare vars namn eller visningsnamn börjar med "ro".
Steg 1: lägg till kommandona
- Se till att spelet använder TextChatService: markera TextChatService i Explorer och titta på ChatVersion i fönstret Properties. Om det fortfarande står LegacyChatService i en äldre place har Roblox sida om textchatt i spelet ett avsnitt om att byta.
- Lägg in ett Script i ServerScriptService med namnet
AdminCommandsoch klistra in koden nedan. - Byt ut
123456iADMINSmot ditt eget user ID.
-- Script i ServerScriptService med namnet AdminCommands.
-- Chattkommandon för user ID i ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")
-- Ditt user ID är talet i länken till din profil: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
[123456] = true,
}
local function isAdmin(userId: number): boolean
-- I ett speltest i Studio i en place som du själv äger räknas du också som admin
local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
return ADMINS[userId] == true or ownerInStudio
end
-- Hittar spelare via början av namnet eller visningsnamnet, eller "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: till spelaren. /tp name1 name2: skicka name1 till 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,
}
-- Skapar en TextChatCommand per kommando. Bara admins får ett resultat; för alla andra
-- gör kommandot ingenting, och meddelandet visas inte heller i chatten.
for name, handler in commands do
local command = Instance.new("TextChatCommand")
command.Name = "Admin_" .. name
command.PrimaryAlias = "/" .. name
command.AutocompleteVisible = false -- kommandona hamnar inte i förslagen för andra spelare
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
Tabellen commands kopplar varje namn till en funktion. Loopen längst ner gör om varje post till en TextChatCommand, så ett nytt kommando är bara en post till i tabellen. string.split(unfilteredText, " ") delar upp meddelandet i ord: args[1] är kommandot, args[2] målet, args[3] ett tal eller ett andra mål.
AutocompleteVisible = false tar bort kommandona från förslagen som varje spelare ser när de skriver ett snedstreck. Om en admin skriver hela kommandot fungerar det ändå.
Steg 2: lägg till ett eget kommando
Lägg till en post i tabellen commands. Till exempel ett kommando /jump Name 100 som sätter hoppkraften:
- Kopiera posten
speedoch byt namn på den tilljump. - Inuti sätter du
humanoid.UseJumpPower = trueochhumanoid.JumpPower = math.clamp(power, 0, 300).
För ett meddelande till alla, till exempel ett meddelande till hela servern, skicka det via ett RemoteEvent som varje klient visar på skärmen. Allt som spelare kan läsa och som kommer från inskriven text måste först gå igenom Roblox textfiltrering, så använd fasta meddelanden för utrop eller filtrera dem med TextService:FilterStringAsync.
Testa
- Tryck på Play i en place som du äger. Skriv
/speed me 60i chatten: du springer snabbare, och meddelandet syns inte i chatten. - Efter ett fall skriver du
/heal meför att kontrollera att hälsan kommer tillbaka. - Starta ett test med 2 spelare (fliken Test, Clients and Servers). Som Player1 skriver du
/tp Player2. Som Player2, som inte är admin, skriver du/kill Player1: ingenting händer.
Vanliga fel och lösningar
Om ett kommando inte gör något, titta först i fönstret Output och gå igenom de här punkterna.
Kommandot syns i chatten och ingenting händer
TextChatCommand hör till TextChatService. Kontrollera egenskapen ChatVersion på TextChatService, och även att skriptet är ett Script i ServerScriptService och att det inte finns något rött fel i Output.
I det publicerade spelet gör kommandot ingenting för mig
Ditt user ID finns inte i ADMINS. Undantaget för Studio gäller bara i Studio och bara för en place som ägs av ditt personliga konto, inte av en grupp.
/tp gör ingenting
Båda spelarna måste ha en karaktär i världen. Kontrollera målets namn: det räcker med början av namnet eller visningsnamnet, men med ett stavfel hittas ingen.
Jag vill ha rang, till exempel moderator och ägare
Ändra ADMINS så att varje user ID kopplas till ett rangnummer, och ge varje kommando en lägsta rang som får köra det.
Bygg det med RoCode
Om du inte vill sätta upp det här för hand kan RoCode bygga det i din öppna place. RoCode är en oberoende AI-agent för Roblox Studio, inte från Roblox: du beskriver ändringen i webbchatten, och dess Studio-plugin skapar skripten i din Explorer.
Lägg till admin-kommandon för mig och min vän (user ID 111 och 222): /kick, /tp, /speed, /heal, /kill och /fly, med kontroll på servern.
- Skriver kommandoskriptet med dina admin-ID:n och alla extra kommandon som du beskriver
- Kan först läsa din place för att använda det som redan finns, till exempel en befintlig chattinställning
- Den är instruerad att kontrollera att varje skript kompilerar med Check Script, och den sätter ångrapunkter runt varje omgång ändringar
Du behöver fortfarande testa kommandona själv i ett speltest, och för att kontrollera adminkontrollen behövs en andra spelare. Så ansluter RoCode till Studio.
Vanliga frågor
Hur lägger jag till admin-kommandon i mitt Roblox-spel?
Skapa TextChatCommand i ett Script på servern och kontrollera i varje Triggered-hanterare avsändarens user ID mot din adminlista innan något görs. Hela skriptet finns i steg 1.
Behöver jag HD Admin eller Adonis?
Nej. Adminsystem från Creator Store lägger till många kommandon och en panel, men det är mycket kod som du inte själv har skrivit. Ett kort eget skript gör precis det du behöver och inget mer.
Hur hittar jag mitt user ID i Roblox?
Öppna din profil på roblox.com: talet i länken mellan /users/ och /profile är ditt user ID.
Ser spelare admin-kommandona i chatten?
Nej. Ett meddelande som matchar en TextChatCommand skickas inte till andra spelare.
Källor och vidare läsning
- Roblox Creator Docs: TextChatCommand (på engelska). alias, AutocompleteVisible och Triggered
- Roblox Creator Docs: Custom text chat commands (på engelska). Script på servern som hanterar kommandot
- Roblox Creator Docs: Player:Kick (på engelska). ta bort en spelare med ett meddelande
- Roblox Creator Docs: Text filtering (på engelska). när inskriven text måste filtreras
Så kontrollerades koden: varje skript på den här sidan klarar strikt Luau-typkontroll mot Roblox API-definitionerna (luau-lsp, 20 november 2026). Typkontrollen fångar felstavade API-namn och fel typer, men inte fel i spellogiken, så testa allt i Studio innan du publicerar.