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

Як зробити адмін-команди в 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.