Накратко
В 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, преди да публикуваш.