Kort fortalt
I et Script i ServerScriptService opretter du en TextChatCommand for hver kommando, giver den et PrimaryAlias (for eksempel "/kick") og lægger den i TextChatService. Dens event Triggered sender afsenderens TextSource og hele beskedens tekst. Find spilleren med Players:GetPlayerByUserId(textSource.UserId), tjek at spillerens user ID står på din admin-liste, del derefter beskeden op i ord, og udfør handlingen.
- Tjek admin-listen på serveren. Et tjek i et LocalScript kan en exploiter komme uden om.
- Tjek user ID'er og ikke navne: spillere kan skifte navn, men ID'et ændrer sig aldrig.
- En besked, der matcher en kommando, vises ikke i chatten, så kommandoer roder ikke chatten til for andre spillere.
På denne side
Sådan virker chatkommandoer
En TextChatCommand inde i TextChatService holder øje med beskeder i chatten. Når en besked begynder med dens PrimaryAlias eller SecondaryAlias efterfulgt af et mellemrum eller ingenting, sender Roblox ikke beskeden til de andre spillere og kalder i stedet Triggered. Sammenligningen med aliaset skelner ikke mellem store og små bogstaver. Roblox' eksempel på egne kommandoer forbinder til Triggered i et server-Script, og det er netop dér, admin-tjekket hører hjemme.
| Det skriver du i chatten | Det sker der |
|---|---|
/kick Name | Fjerner den spiller fra serveren. |
/tp Name | Teleporterer dig hen til spilleren. /tp Name1 Name2 sender Name1 hen til Name2. |
/speed Name 50 | Sætter spillerens WalkSpeed (fra 0 til 200). Uden et tal sættes den tilbage til 16. |
/heal Name | Giver spilleren fuldt helbred igen. |
/kill Name | Dræber spillerens karakter. |
I stedet for et navn kan du skrive me, all eller others, og starten af navnet er nok: /heal ro heler alle spillere, hvis navn eller visningsnavn begynder med »ro«.
Trin 1: tilføj kommandoerne
- Sørg for, at spillet bruger TextChatService: markér TextChatService i Explorer, og se på ChatVersion i vinduet Properties. Hvis der i et gammelt place stadig står LegacyChatService, har Roblox' side om tekstchat i spillet et afsnit om at skifte over.
- Indsæt et Script i ServerScriptService med navnet
AdminCommands, og sæt koden nedenfor ind. - Erstat
123456iADMINSmed dit eget user ID.
-- Script i ServerScriptService med navnet AdminCommands.
-- Chatkommandoer for user ID'er i ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")
-- Dit user ID er tallet i linket til din profil: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
[123456] = true,
}
local function isAdmin(userId: number): boolean
-- I en playtest i Studio i et place, du selv ejer personligt, regnes du også som admin
local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
return ADMINS[userId] == true or ownerInStudio
end
-- Finder spillere ud fra starten af navnet eller visningsnavnet, 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: hen til spilleren. /tp name1 name2: send name1 hen til 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,
}
-- Opretter én TextChatCommand pr. kommando. Kun admins får et resultat; for alle andre
-- gør kommandoen ingenting, og beskeden vises heller ikke i chatten.
for name, handler in commands do
local command = Instance.new("TextChatCommand")
command.Name = "Admin_" .. name
command.PrimaryAlias = "/" .. name
command.AutocompleteVisible = false -- kommandoerne kommer ikke med i de andre spilleres forslag
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 knytter en funktion til hvert navn. Løkken nederst gør hver post til en TextChatCommand, så en ny kommando kun er én post i tabellen. string.split(unfilteredText, " ") deler beskeden op i ord: args[1] er kommandoen, args[2] målet, args[3] et tal eller et andet mål.
AutocompleteVisible = false fjerner kommandoerne fra de forslag, alle spillere ser, når de skriver en skråstreg. Hvis en admin skriver kommandoen helt ud, virker den stadig.
Trin 2: tilføj din egen kommando
Tilføj en post i tabellen commands. For eksempel kommandoen /jump Name 100, der sætter hoppekraften:
- Kopiér posten
speed, og omdøb den tiljump. - Sæt indeni
humanoid.UseJumpPower = trueoghumanoid.JumpPower = math.clamp(power, 0, 300).
En besked til alle, for eksempel en meddelelse, sender du via en RemoteEvent, som hver klient viser på skærmen. Alt, som spillere kan læse, og som kommer fra indtastet tekst, skal først igennem Roblox' tekstfiltrering, så brug faste beskeder til meddelelser, eller filtrér dem med TextService:FilterStringAsync.
Test det
- Tryk på Play i et place, du ejer. Skriv
/speed me 60i chatten: du løber hurtigere, og beskeden vises ikke i chatten. - Efter et fald kan du skrive
/heal mefor at tjekke, at helbredet kommer tilbage. - Start en test med 2 spillere (fanen Test, Clients and Servers). Skriv
/tp Player2fra Player1. Fra Player2, som ikke er admin, skriver du/kill Player1: der sker ingenting.
Almindelige fejl og løsninger
Hvis en kommando ikke gør noget, så tjek først vinduet Output og disse punkter.
Kommandoen vises i chatten, og der sker ingenting
TextChatCommand hører til TextChatService. Tjek egenskaben ChatVersion på TextChatService, og at scriptet er et Script i ServerScriptService uden en rød fejl i Output.
I det udgivne spil gør kommandoen ingenting for mig
Dit user ID står ikke i ADMINS. Undtagelsen for Studio gælder kun i Studio og kun for et place, som din personlige konto ejer, ikke en gruppe.
/tp gør ingenting
Begge spillere skal have en karakter i verden. Tjek målets navn: starten af navnet eller visningsnavnet er nok, men med en stavefejl bliver ingen fundet.
Jeg vil have rang, for eksempel moderator og ejer
Lav ADMINS om, så et user ID peger på et rangnummer, og giv hver kommando en minimumsrang, der må køre den.
Byg det med RoCode
Hvis du ikke vil sætte det op i hånden, kan RoCode bygge det i det place, du har åbent. RoCode er en uafhængig AI-agent til Roblox Studio, ikke fra Roblox: du beskriver ændringen i webchatten, og dens Studio-plugin opretter scripts i din Explorer.
Tilføj admin-kommandoer for mig og min ven (user ID 111 og 222): /kick, /tp, /speed, /heal, /kill og /fly, med tjek på serveren.
- Skriver kommandoscriptet med dine admin-ID'er og alle de ekstra kommandoer, du beskriver
- Kan først læse dit place for at bruge det, der allerede findes, for eksempel en eksisterende chatopsætning
- Er instrueret i at tjekke kompileringen af hvert script med Check Script og sætter fortryd-punkter omkring hver omgang ændringer
Du skal stadig selv teste kommandoerne i en playtest, og til admin-tjekket skal du bruge en spiller mere. Sådan forbinder RoCode til Studio.
Ofte stillede spørgsmål
Hvordan tilføjer man admin-kommandoer til sit Roblox-spil?
Opret TextChatCommand i et server-Script, og tjek i hver Triggered-handler afsenderens user ID mod din admin-liste, før du gør noget. Det fulde script står i trin 1.
Har jeg brug for HD Admin eller Adonis?
Nej. Admin-systemer fra Creator Store tilføjer mange kommandoer og et panel, men det er meget kode, som du ikke selv har skrevet. Et kort script, du selv har lavet, gør præcis det, du har brug for, og intet andet.
Hvordan finder jeg mit user ID i Roblox?
Åbn din profil på roblox.com: tallet i linket mellem /users/ og /profile er dit user ID.
Kan spillerne se admin-kommandoer i chatten?
Nej. En besked, der matcher en TextChatCommand, sendes ikke til andre spillere.
Kilder og videre læsning
- Roblox Creator Docs: TextChatCommand (på engelsk). aliaser, AutocompleteVisible og Triggered
- Roblox Creator Docs: Custom text chat commands (på engelsk). server-Scriptet, der håndterer kommandoen
- Roblox Creator Docs: Player:Kick (på engelsk). at fjerne en spiller med en besked
- Roblox Creator Docs: Text filtering (på engelsk). hvornår indtastet tekst skal filtreres
Sådan blev koden tjekket: hvert script på denne side gennemgår streng Luau-typekontrol med Roblox API-definitionerne (luau-lsp, 20. november 2026). Typekontrollen fanger fejl i API-navne og forkerte typer, men ikke fejl i spillogikken, så test alt i Studio, før du udgiver.