V skratke
V Scripte v ServerScriptService vytvorte TextChatCommand pre každý príkaz, nastavte mu PrimaryAlias (napríklad "/kick") a vložte ho do TextChatService. Jeho udalosť Triggered odovzdá TextSource odosielateľa a celý text správy. Nájdite hráča cez Players:GetPlayerByUserId(textSource.UserId), overte, že jeho user ID je vo vašom zozname adminov, potom správu rozdeľte na slová a vykonajte akciu.
- Zoznam adminov kontrolujte na serveri. Kontrolu v LocalScripte exploiter obíde.
- Kontrolujte user ID, nie mená: hráči si mená môžu meniť, ale ID sa nemení nikdy.
- Správa, ktorá zodpovedá príkazu, sa v chate nezobrazí, takže príkazy ostatným hráčom chat nezaplavujú.
Na tejto stránke
Ako fungujú príkazy chatu
TextChatCommand vnútri TextChatService sleduje správy v chate. Keď správa začína jeho PrimaryAlias alebo SecondaryAlias, za ktorým nasleduje medzera alebo nič, Roblox správu ostatným hráčom nepošle a namiesto toho vyvolá Triggered. Porovnanie s aliasom nerozlišuje veľké a malé písmená. Ukážka vlastných príkazov od Robloxu sa pripája k Triggered v serverovom Scripte a práve tam patrí kontrola admina.
| Čo napísať do chatu | Čo sa stane |
|---|---|
/kick Name | Odstráni tohto hráča zo servera. |
/tp Name | Teleportuje vás k nemu. /tp Name1 Name2 pošle Name1 k Name2. |
/speed Name 50 | Nastaví mu WalkSpeed (od 0 do 200). Bez čísla vráti 16. |
/heal Name | Obnoví mu plné zdravie. |
/kill Name | Zabije jeho postavu. |
Namiesto mena môžete napísať me, all alebo others a stačí začiatok mena: /heal ro vylieči všetkých hráčov, ktorých meno alebo zobrazované meno začína na „ro“.
Krok 1: pridajte príkazy
- Overte, že hra používa TextChatService: vyberte TextChatService v Exploreri a pozrite sa na ChatVersion v okne Properties. Ak je v starom place stále LegacyChatService, stránka Robloxu o textovom chate v hre má časť o prechode.
- Vložte Script do ServerScriptService s názvom
AdminCommandsa vložte doň kód nižšie. - Nahraďte
123456vADMINSsvojím user ID.
-- Script v ServerScriptService s názvom AdminCommands.
-- Príkazy chatu pre user ID z ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")
-- Vaše user ID je číslo v odkaze na profil: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
[123456] = true,
}
local function isAdmin(userId: number): boolean
-- V playteste v Studiu v place, ktorý vlastníte osobne, sa tiež počítate ako admin
local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
return ADMINS[userId] == true or ownerInStudio
end
-- Hľadá hráčov podľa začiatku mena alebo zobrazovaného mena, prípadne "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: k nemu. /tp name1 name2: poslať name1 k 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,
}
-- Vytvorí jeden TextChatCommand na príkaz. Výsledok dostanú len admini; pre ostatných
-- príkaz nič nerobí a správa sa v chate tiež nezobrazí.
for name, handler in commands do
local command = Instance.new("TextChatCommand")
command.Name = "Admin_" .. name
command.PrimaryAlias = "/" .. name
command.AutocompleteVisible = false -- príkazy sa neobjavia v nápovede ostatných hráčov
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
Tabuľka commands priraďuje každému názvu funkciu. Slučka dole z každého záznamu urobí TextChatCommand, takže nový príkaz je len jeden záznam v tabuľke. string.split(unfilteredText, " ") rozdelí správu na slová: args[1] je príkaz, args[2] cieľ, args[3] číslo alebo druhý cieľ.
AutocompleteVisible = false odstráni príkazy z nápovedy, ktorú vidí každý hráč, keď napíše lomku. Keď admin napíše príkaz celý, aj tak zafunguje.
Krok 2: pridajte vlastný príkaz
Pridajte záznam do tabuľky commands. Napríklad príkaz /jump Name 100, ktorý nastaví silu skoku:
- Skopírujte záznam
speeda premenujte ho najump. - Vnútri nastavte
humanoid.UseJumpPower = trueahumanoid.JumpPower = math.clamp(power, 0, 300).
Správu pre všetkých, napríklad oznámenie, posielajte cez RemoteEvent, ktorý každý klient zobrazí na obrazovke. Všetko, čo hráči môžu čítať a čo pochádza z napísaného textu, musí najprv prejsť filtrovaním textu Robloxu, preto pre oznámenia používajte pevné správy alebo ich filtrujte cez TextService:FilterStringAsync.
Otestujte
- Kliknite na Play v place, ktorý vlastníte. Napíšte do chatu
/speed me 60: behávate rýchlejšie a správa sa v chate neobjaví. - Po páde napíšte
/heal mea overte, že sa zdravie vracia. - Spustite test pre 2 hráčov (karta Test, Clients and Servers). Ako Player1 napíšte
/tp Player2. Ako Player2, ktorý nie je admin, napíšte/kill Player1: nič sa nestane.
Časté chyby a riešenia
Ak príkaz nič nerobí, najprv skontrolujte okno Output a tieto body.
Príkaz sa objaví v chate a nič sa nestane
TextChatCommand patrí k TextChatService. Skontrolujte vlastnosť ChatVersion pri TextChatService a tiež to, že skript je Script v ServerScriptService a v Output nie je červená chyba.
V živej hre mi príkaz nič nerobí
Vaše user ID nie je v ADMINS. Výnimka pre Studio platí len v Studiu a len pre place, ktorý vlastní váš osobný účet, nie skupina.
/tp nič nerobí
Obaja hráči musia mať postavu vo svete. Skontrolujte meno cieľa: stačí začiatok mena alebo zobrazovaného mena, ale s preklepom sa nenájde nikto.
Chcem hodnosti, napríklad moderátor a majiteľ
Zmeňte ADMINS tak, aby sa user ID priraďovalo číslu hodnosti, a každému príkazu nastavte minimálnu hodnosť, ktorá ho smie spustiť.
Postavte to s RoCode
Ak to nechcete nastavovať ručne, RoCode to môže postaviť vo vašom otvorenom place. RoCode je nezávislý AI agent pre Roblox Studio, nie od Robloxu: zmenu opíšete vo webovom chate a jeho plugin pre Studio vytvorí skripty vo vašom Exploreri.
Pridaj admin príkazy pre mňa a môjho kamaráta (user ID 111 a 222): /kick, /tp, /speed, /heal, /kill a /fly, s kontrolou na serveri.
- Napíše skript príkazov s vašimi ID adminov a akýmikoľvek ďalšími príkazmi, ktoré opíšete
- Môže si najprv prečítať váš place, aby použil to, čo už existuje, napríklad súčasné nastavenia chatu
- Má za úlohu overiť kompiláciu každého skriptu cez Check Script a okolo každej sady zmien vytvára body na vrátenie
Príkazy v playteste aj tak musíte otestovať vy a na kontrolu admina potrebujete druhého hráča. Ako sa RoCode pripája k Studiu.
Časté otázky
Ako pridať admin príkazy do svojej hry v Robloxe?
Vytvorte TextChatCommand v serverovom Scripte a v každom handleri Triggered overte user ID odosielateľa podľa svojho zoznamu adminov, skôr než čokoľvek urobíte. Celý skript je v kroku 1.
Potrebujem HD Admin alebo Adonis?
Nie. Admin systémy z Creator Store pridávajú veľa príkazov a panel, ale je to veľký kód, ktorý ste nepísali vy. Krátky vlastný skript robí presne to, čo potrebujete, a nič viac.
Ako zistím svoje user ID v Robloxe?
Otvorte svoj profil na roblox.com: číslo v odkaze medzi /users/ a /profile je vaše user ID.
Vidia hráči admin príkazy v chate?
Nie. Správa, ktorá zodpovedá TextChatCommand, sa ostatným hráčom neposiela.
Zdroje a ďalšie čítanie
- Roblox Creator Docs: TextChatCommand (po anglicky). aliasy, AutocompleteVisible a Triggered
- Roblox Creator Docs: Custom text chat commands (po anglicky). serverový Script, ktorý príkaz spracuje
- Roblox Creator Docs: Player:Kick (po anglicky). odstránenie hráča so správou
- Roblox Creator Docs: Text filtering (po anglicky). kedy treba napísaný text filtrovať
Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.