Туториал · Геймплей

Как сделать админ-команды в Roblox Studio

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

Обновлено 12 ноября 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, 12 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.

Попробуйте RoCode в своей игре.

Бесплатные кредиты каждый день, без карты. Установите плагин, опишите функцию и проверьте, что появилось в Studio.