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