W skrócie
W Script w ServerScriptService utwórz TextChatCommand dla każdej komendy, ustaw jej PrimaryAlias (na przykład "/kick") i umieść ją w TextChatService. Jej event Triggered przekazuje TextSource nadawcy i pełny tekst wiadomości. Znajdź gracza przez Players:GetPlayerByUserId(textSource.UserId), sprawdź, czy jego user ID jest na twojej liście adminów, potem podziel wiadomość na słowa i wykonaj akcję.
- Sprawdzaj listę adminów na serwerze. Sprawdzenie w LocalScript exploiter może obejść.
- Sprawdzaj user ID, a nie nazwy: gracze mogą zmieniać nazwy, a ID nie zmienia się nigdy.
- Wiadomość pasująca do komendy nie pokazuje się na czacie, więc komendy nie zaśmiecają czatu innym graczom.
Na tej stronie
Jak działają komendy czatu
TextChatCommand wewnątrz TextChatService obserwuje wiadomości na czacie. Gdy wiadomość zaczyna się od jej PrimaryAlias albo SecondaryAlias, po którym jest spacja albo nic, Roblox nie wysyła wiadomości innym graczom i zamiast tego wywołuje Triggered. Porównanie z aliasem nie uwzględnia wielkości liter. Przykład własnych komend od Roblox podłącza się do Triggered w serwerowym Script i właśnie tam jest miejsce na sprawdzenie admina.
| Co wpisać na czacie | Co się stanie |
|---|---|
/kick Name | Usuwa tego gracza z serwera. |
/tp Name | Teleportuje cię do niego. /tp Name1 Name2 wysyła Name1 do Name2. |
/speed Name 50 | Ustawia jego WalkSpeed (od 0 do 200). Bez liczby wraca do 16. |
/heal Name | Przywraca mu całe zdrowie. |
/kill Name | Zabija jego postać. |
Zamiast nazwy możesz napisać me, all albo others i wystarczy początek nazwy: /heal ro leczy wszystkich graczy, których nazwa albo nazwa wyświetlana zaczyna się od „ro”.
Krok 1: dodaj komendy
- Upewnij się, że gra używa TextChatService: zaznacz TextChatService w Explorerze i sprawdź ChatVersion w oknie Properties. Jeśli w starej grze nadal jest tam LegacyChatService, strona Roblox o czacie tekstowym w grze ma sekcję o migracji.
- Wstaw Script do ServerScriptService o nazwie
AdminCommandsi wklej kod poniżej. - Zamień
123456wADMINSna swój user ID.
-- Script w ServerScriptService o nazwie AdminCommands.
-- Komendy czatu dla user ID z ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")
-- Twój user ID to liczba w linku do profilu: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
[123456] = true,
}
local function isAdmin(userId: number): boolean
-- W playteście Studio w grze, którą posiadasz osobiście, też jesteś adminem
local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
return ADMINS[userId] == true or ownerInStudio
end
-- Szuka graczy po początku nazwy albo nazwy wyświetlanej, albo "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: do niego. /tp name1 name2: wyślij name1 do 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,
}
-- Tworzy po jednej TextChatCommand na komendę. Efekt dostają tylko admini; dla pozostałych
-- komenda nic nie robi, a wiadomość też nie pokazuje się na czacie.
for name, handler in commands do
local command = Instance.new("TextChatCommand")
command.Name = "Admin_" .. name
command.PrimaryAlias = "/" .. name
command.AutocompleteVisible = false -- komendy nie trafiają do podpowiedzi innych graczy
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
Tabela commands przypisuje każdej nazwie funkcję. Pętla na dole zamienia każdy wpis w TextChatCommand, więc nowa komenda to tylko jeden wpis w tabeli. string.split(unfilteredText, " ") dzieli wiadomość na słowa: args[1] to komenda, args[2] cel, args[3] liczba albo drugi cel.
AutocompleteVisible = false usuwa komendy z podpowiedzi, które widzi każdy gracz, gdy wpisuje ukośnik. Jeśli admin wpisze komendę w całości, i tak zadziała.
Krok 2: dodaj własną komendę
Dodaj wpis do tabeli commands. Na przykład komendę /jump Name 100, która ustawia siłę skoku:
- Skopiuj wpis
speedi zmień jego nazwę najump. - W środku ustaw
humanoid.UseJumpPower = trueihumanoid.JumpPower = math.clamp(power, 0, 300).
Wiadomość do wszystkich, na przykład ogłoszenie, wysyłaj przez RemoteEvent, który każdy klient pokazuje na ekranie. Wszystko, co gracze mogą przeczytać i co pochodzi z wpisanego tekstu, musi najpierw przejść filtrowanie tekstu Roblox, więc do ogłoszeń używaj stałych wiadomości albo filtruj je przez TextService:FilterStringAsync.
Sprawdź
- Kliknij Play w grze, którą posiadasz. Wpisz na czacie
/speed me 60: biegasz szybciej, a wiadomość nie pojawia się na czacie. - Po upadku wpisz
/heal me, żeby sprawdzić, czy zdrowie wraca. - Uruchom test na 2 graczy (karta Test, Clients and Servers). Jako Player1 wpisz
/tp Player2. Jako Player2, który nie jest adminem, wpisz/kill Player1: nic się nie stanie.
Częste błędy i rozwiązania
Jeśli komenda nic nie robi, najpierw sprawdź okno Output i te punkty.
Komenda pojawia się na czacie i nic się nie dzieje
TextChatCommand należy do TextChatService. Sprawdź właściwość ChatVersion w TextChatService, a także czy skrypt to Script w ServerScriptService i czy w Output nie ma czerwonego błędu.
W opublikowanej grze komenda u mnie nic nie robi
Twojego user ID nie ma w ADMINS. Wyjątek dla Studio działa tylko w Studio i tylko dla gry, którą posiada twoje osobiste konto, a nie grupa.
/tp nic nie robi
Obaj gracze muszą mieć postać w świecie. Sprawdź nazwę celu: wystarczy początek nazwy albo nazwy wyświetlanej, ale z literówką nikt się nie znajdzie.
Chcę rangi, na przykład moderator i właściciel
Zmień ADMINS tak, żeby user ID był przypisany do numeru rangi, i daj każdej komendzie minimalną rangę, która może ją uruchomić.
Zbuduj to z RoCode
Jeśli nie chcesz ustawiać tego ręcznie, RoCode może to zbudować w grze, którą masz otwartą. RoCode to niezależny agent AI do Roblox Studio, nie robi go Roblox: opisujesz zmianę na czacie w przeglądarce, a jego plugin do Studio tworzy skrypty w twoim Explorerze.
Dodaj komendy admina dla mnie i mojego znajomego (user ID 111 i 222): /kick, /tp, /speed, /heal, /kill i /fly, ze sprawdzaniem na serwerze.
- Pisze skrypt komend z twoimi ID adminów i wszystkimi dodatkowymi komendami, które opiszesz
- Może najpierw przeczytać twoją grę, żeby wykorzystać to, co już jest, na przykład istniejące ustawienia czatu
- Ma polecone sprawdzać kompilację każdego skryptu przez Check Script i stawia punkty cofania wokół każdego zestawu zmian
Sprawdzić komendy w playteście i tak musisz sam, a do sprawdzenia admina potrzebny jest drugi gracz. Jak RoCode łączy się ze Studio.
Najczęstsze pytania
Jak dodać komendy admina do swojej gry Roblox?
Utwórz TextChatCommand w serwerowym Script i w każdym handlerze Triggered sprawdzaj user ID nadawcy według swojej listy adminów, zanim cokolwiek zrobisz. Pełny skrypt jest w kroku 1.
Czy potrzebuję HD Admin albo Adonis?
Nie. Systemy adminów z Creator Store dodają dużo komend i panel, ale to duży kod, którego nie pisałeś ty. Krótki własny skrypt robi dokładnie to, czego potrzebujesz, i nic więcej.
Jak sprawdzić swój user ID w Roblox?
Otwórz swój profil na roblox.com: liczba w linku między /users/ a /profile to twój user ID.
Czy gracze widzą komendy admina na czacie?
Nie. Wiadomość pasująca do TextChatCommand nie jest wysyłana innym graczom.
Źródła i dalsza lektura
- Roblox Creator Docs: TextChatCommand (po angielsku). aliasy, AutocompleteVisible i Triggered
- Roblox Creator Docs: Custom text chat commands (po angielsku). serwerowy Script, który obsługuje komendę
- Roblox Creator Docs: Player:Kick (po angielsku). usuwanie gracza z wiadomością
- Roblox Creator Docs: Text filtering (po angielsku). kiedy wpisany tekst trzeba filtrować
Jak sprawdziliśmy kod: każdy skrypt na tej stronie przechodzi ścisłe sprawdzanie typów Luau z definicjami API Robloxa (luau-lsp, 20 listopada 2026). Sprawdzanie typów wyłapuje źle wpisane API i błędne typy, ale nie logikę gry, więc przetestuj go w Studio przed publikacją.