Poradnik · Rozgrywka

Jak zrobić komendy admina w Roblox Studio

Komendy admina pozwalają sterować grą prosto z czatu: wyrzucić łamiącego zasady, teleportować się do znajomego, sprawdzić prędkość. W obecnym czacie Roblox, TextChatService, komendy są wbudowane przez TextChatCommand. W tym poradniku dodasz na tej podstawie zestaw komend admina, a każda jest sprawdzana na serwerze według listy user ID, więc nikt inny nie może ich użyć.

Zaktualizowano 20 listopada 20264 min czytaniaAutor:

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
  1. Jak to działa
  2. 1. Skrypt
  3. 2. Własna komenda
  4. Common errors
  5. With RoCode
  6. Najczęstsze pytania
  7. Źródła i dalsza lektura

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.

Komendy z tego poradnika
Co wpisać na czacieCo się stanie
/kick NameUsuwa tego gracza z serwera.
/tp NameTeleportuje cię do niego. /tp Name1 Name2 wysyła Name1 do Name2.
/speed Name 50Ustawia jego WalkSpeed (od 0 do 200). Bez liczby wraca do 16.
/heal NamePrzywraca mu całe zdrowie.
/kill NameZabija 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

  1. 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.
  2. Wstaw Script do ServerScriptService o nazwie AdminCommands i wklej kod poniżej.
  3. Zamień 123456 w ADMINS na swój user ID.
Script w ServerScriptService o nazwie AdminCommands
-- 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 speed i zmień jego nazwę na jump.
  • W środku ustaw humanoid.UseJumpPower = true i humanoid.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ź

  1. Kliknij Play w grze, którą posiadasz. Wpisz na czacie /speed me 60: biegasz szybciej, a wiadomość nie pojawia się na czacie.
  2. Po upadku wpisz /heal me, żeby sprawdzić, czy zdrowie wraca.
  3. 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.

Ty piszesz

Dodaj komendy admina dla mnie i mojego znajomego (user ID 111 i 222): /kick, /tp, /speed, /heal, /kill i /fly, ze sprawdzaniem na serwerze.

RoCode robi
  • 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

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ą.

Wypróbuj RoCode we własnej grze.

Darmowe kredyty codziennie, bez karty. Zainstaluj plugin, opisz funkcję i sprawdź, co pojawi się w Studio.