Коротко
У Script у ServerScriptService створіть TextChatCommand для кожної команди, задайте їй PrimaryAlias (наприклад "/kick") і помістіть у TextChatService. Її подія Triggered передає TextSource відправника та повний текст повідомлення. Знайдіть гравця через Players:GetPlayerByUserId(textSource.UserId), перевірте, що його user ID є у вашому списку адмінів, потім розбийте повідомлення на слова й виконайте дію.
- Перевіряйте список адмінів на сервері. Перевірку в LocalScript експлойтер може обійти.
- Перевіряйте user ID, а не імена: гравці можуть змінювати імена, а ID не змінюється ніколи.
- Повідомлення, яке збіглося з командою, не показується в чаті, тому команди не засмічують чат іншим гравцям.
На цій сторінці
Як працюють команди чату
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: додайте команди
- Переконайтеся, що гра використовує TextChatService: виділіть TextChatService в Explorer і подивіться ChatVersion у вікні Properties. Якщо в старому плейсі там досі LegacyChatService, на сторінці Roblox про текстовий чат у грі є розділ про перехід.
- Вставте Script у ServerScriptService з назвою
AdminCommandsі вставте код нижче. - Замініть
123456вADMINSна свій user ID.
-- 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.
Перевірте
- Натисніть Play у плейсі, яким ви володієте. Введіть у чат
/speed me 60: ви бігаєте швидше, а повідомлення в чаті не з'являється. - Після падіння введіть
/heal me, щоб перевірити, що здоров'я повертається. - Запустіть тест на 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, з перевіркою на сервері.
- Пише скрипт команд з вашими 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, не надсилається іншим гравцям.
Джерела та що почитати
- Roblox Creator Docs: TextChatCommand (англійською). аліаси, AutocompleteVisible і Triggered
- Roblox Creator Docs: Custom text chat commands (англійською). серверний Script, який обробляє команду
- Roblox Creator Docs: Player:Kick (англійською). видалення гравця з повідомленням
- Roblox Creator Docs: Text filtering (англійською). коли набраний текст треба фільтрувати
Як перевірявся код: кожен скрипт на цій сторінці проходить сувору перевірку типів Luau з визначеннями Roblox API (luau-lsp, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.