Урок · Геймплей

Как да направиш админ команди в Roblox Studio

Админ командите ти позволяват да управляваш играта си направо от чата: да изгониш нарушител, да се телепортираш при приятел, да провериш скоростта. В сегашния чат на Roblox, TextChatService, командите са вградени чрез TextChatCommand. В това ръководство ще добавиш на тази основа набор от админ команди, като всяка се проверява на сървъра по списък с user ID, затова никой друг няма да може да ги използва.

Обновено 20 ноември 2026 г.4 мин четенеАвтор:

Накратко

В Script в ServerScriptService създай TextChatCommand за всяка команда, задай ѝ PrimaryAlias (например "/kick") и я сложи в TextChatService. Събитието ѝ Triggered подава TextSource на изпращача и пълния текст на съобщението. Намери играча чрез Players:GetPlayerByUserId(textSource.UserId), провери дали неговото user ID е в списъка ти с админи, после раздели съобщението на думи и изпълни действието.

  • Проверявай списъка с админи на сървъра. Проверка в LocalScript може да бъде заобиколена от експлойтър.
  • Проверявай user ID, а не имена: играчите могат да сменят имената си, а ID никога не се променя.
  • Съобщение, което съвпада с команда, не се показва в чата, затова командите не задръстват чата на другите играчи.
На тази страница
  1. Как работи
  2. 1. Скрипт
  3. 2. Своя команда
  4. Common errors
  5. With RoCode
  6. Често задавани въпроси
  7. Източници и какво да прочетеш

Как работят командите в чата

TextChatCommand в TextChatService следи съобщенията в чата. Когато съобщение започва с нейния PrimaryAlias или SecondaryAlias, последван от интервал или от нищо, Roblox не изпраща съобщението на другите играчи и вместо това извиква Triggered. Сравнението с алиаса не зависи от главните букви. Примерът на Roblox за собствени команди се свързва с Triggered в сървърен Script и точно там е мястото на проверката за админ.

Командите от това ръководство
Какво пишеш в чатаКакво става
/kick NameПремахва този играч от сървъра.
/tp NameТелепортира те при него. /tp Name1 Name2 праща Name1 при Name2.
/speed Name 50Задава неговия WalkSpeed (от 0 до 200). Без число връща 16.
/heal NameВъзстановява здравето му напълно.
/kill NameУбива персонажа му.

Вместо име можеш да напишеш me, all или others, а началото на името стига: /heal ro лекува всички играчи, чието име или показвано име започва с „ro“.

Стъпка 1: добави командите

  1. Увери се, че играта използва TextChatService: избери TextChatService в Explorer и виж ChatVersion в прозореца Properties. Ако в стар плейс там все още е LegacyChatService, страницата на Roblox за текстовия чат в играта има раздел за преминаването.
  2. Вмъкни Script в ServerScriptService с име AdminCommands и постави кода по-долу.
  3. Смени 123456 в ADMINS със своето user ID.
Script в ServerScriptService с име AdminCommands
-- Script в ServerScriptService с име AdminCommands.
-- Команди в чата за user ID от ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")

-- Твоето user ID е числото в линка към профила: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
	[123456] = true,
}

local function isAdmin(userId: number): boolean
	-- В плейтест в Studio в плейс, който е лично твой, също се смяташ за админ
	local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
	return ADMINS[userId] == true or ownerInStudio
end

-- Търси играчи по началото на името или показваното име, или "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: при него. /tp name1 name2: прати name1 при 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,
}

-- Създава по една TextChatCommand за всяка команда. Резултат получават само админите; за останалите
-- командата не прави нищо и съобщението също не се показва в чата.
for name, handler in commands do
	local command = Instance.new("TextChatCommand")
	command.Name = "Admin_" .. name
	command.PrimaryAlias = "/" .. name
	command.AutocompleteVisible = false -- командите не се показват в подсказките на останалите играчи
	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

Таблицата commands свързва всяко име с функция. Цикълът най-долу превръща всеки запис в TextChatCommand, затова новата команда е само един запис в таблицата. string.split(unfilteredText, " ") разделя съобщението на думи: args[1] е командата, args[2] е целта, args[3] е число или втора цел.

AutocompleteVisible = false маха командите от подсказките, които всеки играч вижда, когато напише наклонена черта. Ако админ напише командата изцяло, тя пак ще сработи.

Стъпка 2: добави своя команда

Добави запис в таблицата commands. Например команда /jump Name 100, която задава силата на скока:

  • Копирай записа speed и го преименувай на jump.
  • Вътре задай humanoid.UseJumpPower = true и humanoid.JumpPower = math.clamp(power, 0, 300).

За съобщение до всички, например обявление, го изпращай чрез RemoteEvent, който всеки клиент показва на екрана. Всичко, което играчите могат да прочетат и което идва от написан текст, първо трябва да мине през филтрирането на текст на Roblox, затова използвай за обявленията фиксирани съобщения или ги филтрирай чрез TextService:FilterStringAsync.

Тествай

  1. Натисни Play в плейс, който е твой. Напиши в чата /speed me 60: тичаш по-бързо, а съобщението не се появява в чата.
  2. След падане напиши /heal me, за да провериш дали здравето се връща.
  3. Пусни тест с 2 играчи (раздел Test, Clients and Servers). От Player1 напиши /tp Player2. От Player2, който не е админ, напиши /kill Player1: нищо няма да стане.

Чести грешки и решения

Ако командата не прави нищо, първо провери прозореца Output и тези точки.

Командата се появява в чата и нищо не става

TextChatCommand е част от TextChatService. Провери свойството ChatVersion на TextChatService, както и дали скриптът е Script в ServerScriptService и дали в Output няма червена грешка.

В живата игра командата не прави нищо при мен

Твоето user ID не е в ADMINS. Изключението за Studio важи само в Studio и само за плейс, който е на личния ти акаунт, а не на група.

/tp не прави нищо

И двамата играчи трябва да имат персонаж в света. Провери името на целта: началото на името или на показваното име стига, но с правописна грешка няма да се намери никой.

Искам рангове, например модератор и собственик

Промени ADMINS така, че user ID да съответства на номер на ранг, и задай на всяка команда минималния ранг, който може да я пуска.

Направи го с RoCode

Ако не искаш да настройваш това ръчно, RoCode може да го сглоби в отворения ти плейс. RoCode е независим ИИ агент за Roblox Studio, не е от Roblox: описваш промяната в уеб чата, а плъгинът му за Studio създава скриптовете в твоя Explorer.

Ти пишеш

Добави админ команди за мен и моя приятел (user ID 111 и 222): /kick, /tp, /speed, /heal, /kill и /fly, с проверка на сървъра.

RoCode прави
  • Пише скрипта с команди с твоите ID на админи и всякакви допълнителни команди, които опишеш
  • Може първо да прочете плейса ти, за да използва това, което вече има, например съществуващата настройка на чата
  • Указано му е да проверява компилирането на всеки скрипт чрез Check Script и поставя точки за отмяна около всеки набор от промени

Тестването на командите в плейтест пак остава за теб, а за проверката на админа трябва втори играч. Как RoCode се свързва със Studio.

Често задавани въпроси

Как да добавя админ команди в моята игра в Roblox?

Създай TextChatCommand в сървърен Script и във всеки обработчик на Triggered проверявай user ID на изпращача по своя списък с админи, преди да направиш каквото и да е. Пълният скрипт е в стъпка 1.

Трябва ли ми HD Admin или Adonis?

Не. Админ системите от Creator Store добавят много команди и панел, но това е голям код, който не си писал ти. Кратък собствен скрипт прави точно това, което ти трябва, и нищо повече.

Как да разбера своето user ID в Roblox?

Отвори профила си в roblox.com: числото в линка между /users/ и /profile е твоето user ID.

Виждат ли играчите админ командите в чата?

Не. Съобщение, което съвпада с TextChatCommand, не се изпраща на другите играчи.

Източници и какво да прочетеш

Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.

Пробвай RoCode в своята игра.

Безплатни кредити всеки ден, без карта. Инсталирай плъгина, опиши функцията и виж какво се е появило в Studio.