Röviden
Egy Scriptben a ServerScriptService-ben hozz létre egy TextChatCommand-ot minden parancshoz, add meg a PrimaryAlias értékét (például "/kick"), és tedd a TextChatService-be. A Triggered eseménye átadja a küldő TextSource-át és az üzenet teljes szövegét. Keresd meg a játékost a Players:GetPlayerByUserId(textSource.UserId) hívással, ellenőrizd, hogy a user ID-ja szerepel-e az adminlistádon, majd bontsd szavakra az üzenetet, és hajtsd végre a műveletet.
- Az adminlistát a szerveren ellenőrizd. A LocalScriptben végzett ellenőrzést egy exploiter megkerülheti.
- User ID-t ellenőrizz, ne nevet: a játékosok megváltoztathatják a nevüket, az ID viszont soha nem változik.
- A parancsra illeszkedő üzenet nem jelenik meg a chatben, így a parancsok nem szemetelik tele a chatet a többi játékosnak.
Ezen az oldalon
Hogyan működnek a chatparancsok
A TextChatService-ben lévő TextChatCommand figyeli a chatüzeneteket. Ha egy üzenet a PrimaryAlias vagy SecondaryAlias értékével kezdődik, és utána szóköz jön vagy semmi, a Roblox nem küldi el az üzenetet a többi játékosnak, hanem meghívja a Triggered eseményt. Az aliasszal való összevetés nem érzékeny a kis- és nagybetűkre. A Roblox egyéni parancsokról szóló példája egy szerveroldali Scriptben csatlakozik a Triggeredhez, és pont ott a helye az adminellenőrzésnek.
| Mit írj a chatbe | Mi történik |
|---|---|
/kick Name | Eltávolítja ezt a játékost a szerverről. |
/tp Name | Odateleportál hozzá. A /tp Name1 Name2 Name1-et Name2-höz küldi. |
/speed Name 50 | Beállítja a WalkSpeed értékét (0 és 200 között). Szám nélkül 16-ra állítja vissza. |
/heal Name | Teljesen visszatölti az életerejét. |
/kill Name | Megöli a karakterét. |
A név helyett írhatsz me, all vagy others szót, és elég a név eleje is: a /heal ro minden játékost meggyógyít, akinek a neve vagy megjelenített neve „ro” betűkkel kezdődik.
1. lépés: add hozzá a parancsokat
- Győződj meg róla, hogy a játék a TextChatService-t használja: jelöld ki a TextChatService-t az Explorerben, és nézd meg a ChatVersion értékét a Properties ablakban. Ha egy régi place-ben még mindig LegacyChatService szerepel, a Roblox játékon belüli szöveges chatről szóló oldalán van egy rész az átállásról.
- Tegyél egy Scriptet a ServerScriptService-be
AdminCommandsnéven, és illeszd be az alábbi kódot. - Cseréld le az
ADMINSlistában a123456értéket a saját user ID-dra.
-- Script a ServerScriptService-ben AdminCommands néven.
-- Chatparancsok az ADMINS listában szereplő user ID-knak: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")
-- A user ID-d a profilod linkjében lévő szám: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
[123456] = true,
}
local function isAdmin(userId: number): boolean
-- Studio playtestben egy saját, személyesen birtokolt place-ben te is adminnak számítasz
local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
return ADMINS[userId] == true or ownerInStudio
end
-- Játékosokat keres a név vagy a megjelenített név eleje alapján, vagy "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: hozzá. /tp name1 name2: name1-et name2-höz küldi.
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,
}
-- Parancsonként egy TextChatCommandot hoz létre. Eredményt csak az adminok kapnak; a többieknél
-- a parancs semmit sem csinál, és az üzenet sem jelenik meg a chatben.
for name, handler in commands do
local command = Instance.new("TextChatCommand")
command.Name = "Admin_" .. name
command.PrimaryAlias = "/" .. name
command.AutocompleteVisible = false -- a parancsok nem kerülnek a többi játékos javaslatai közé
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
A commands tábla minden névhez egy függvényt rendel. A lenti ciklus minden bejegyzésből TextChatCommandot készít, így egy új parancs mindössze egy bejegyzés a táblában. A string.split(unfilteredText, " ") szavakra bontja az üzenetet: az args[1] a parancs, az args[2] a célpont, az args[3] egy szám vagy a második célpont.
Az AutocompleteVisible = false kiveszi a parancsokat azok közül a javaslatok közül, amelyeket minden játékos lát, amikor perjelet ír. Ha egy admin teljesen beírja a parancsot, az ettől még működik.
2. lépés: add hozzá a saját parancsodat
Adj hozzá egy bejegyzést a commands táblához. Például egy /jump Name 100 parancsot, amely az ugrás erejét állítja be:
- Másold le a
speedbejegyzést, és nevezd átjump-ra. - Belül állítsd be:
humanoid.UseJumpPower = trueéshumanoid.JumpPower = math.clamp(power, 0, 300).
Ha mindenkinek szóló üzenetet akarsz, például egy bejelentést, küldd el egy RemoteEventen keresztül, amelyet minden kliens megjelenít a képernyőn. Mindent, amit a játékosok elolvashatnak, és begépelt szövegből származik, előbb át kell engedni a Roblox szövegszűrésén, ezért bejelentésekhez használj rögzített üzeneteket, vagy szűrd őket a TextService:FilterStringAsync segítségével.
Teszteld
- Nyomd meg a Play gombot egy saját place-ben. Írd be a chatbe:
/speed me 60: gyorsabban futsz, és az üzenet nem jelenik meg a chatben. - Egy esés után írd be:
/heal me, hogy lásd, visszajön-e az életerő. - Indíts 2 játékosos tesztet (Test fül, Clients and Servers). Player1-ként írd be:
/tp Player2. Player2-ként, aki nem admin, írd be:/kill Player1: semmi sem történik.
Gyakori hibák és megoldásaik
Ha egy parancs semmit sem csinál, először nézd meg az Output ablakot és ezeket a pontokat.
A parancs megjelenik a chatben, és semmi sem történik
A TextChatCommand a TextChatService-hez tartozik. Ellenőrizd a TextChatService ChatVersion tulajdonságát, és azt is, hogy a script egy Script a ServerScriptService-ben, és nincs piros hiba az Outputban.
Az élő játékban a parancs nálam semmit sem csinál
A user ID-d nincs benne az ADMINS listában. A Studio-kivétel csak a Studióban érvényes, és csak olyan place-re, amelyet a személyes fiókod birtokol, nem egy csoport.
A /tp semmit sem csinál
Mindkét játékosnak kell, hogy legyen karaktere a világban. Ellenőrizd a célpont nevét: elég a név vagy a megjelenített név eleje, de elírással senkit sem talál meg.
Rangokat szeretnék, például moderátort és tulajdonost
Módosítsd az ADMINS listát úgy, hogy a user ID egy rangszámhoz tartozzon, és adj minden parancsnak egy minimális rangot, amellyel futtatható.
Építsd meg a RoCode-dal
Ha nincs kedved kézzel beállítani, a RoCode megépítheti a nálad nyitott place-ben. A RoCode egy független AI-ügynök a Roblox Studióhoz, nem a Robloxtól: a webes chatben leírod a módosítást, a Studio pluginja pedig létrehozza a scripteket az Explorerben.
Adj hozzá admin parancsokat nekem és a barátomnak (user ID 111 és 222): /kick, /tp, /speed, /heal, /kill és /fly, szerveroldali ellenőrzéssel.
- Megírja a parancsscriptet az admin ID-iddal és bármilyen további paranccsal, amelyet leírsz
- Először elolvashatja a place-edet, hogy felhasználja, ami már megvan, például a meglévő chatbeállítást
- Azt az utasítást kapta, hogy minden script fordítását ellenőrizze a Check Scripttel, és minden módosításcsoport köré visszavonási pontot tesz
A parancsokat playtestben neked kell kipróbálnod, az adminellenőrzéshez pedig kell egy második játékos. Hogyan csatlakozik a RoCode a Studióhoz.
Gyakori kérdések
Hogyan adhatok admin parancsokat a Roblox játékomhoz?
Hozz létre TextChatCommandot egy szerveroldali Scriptben, és minden Triggered kezelőben ellenőrizd a küldő user ID-ját az adminlistádon, mielőtt bármit csinálnál. A teljes script az 1. lépésben van.
Kell HD Admin vagy Adonis?
Nem. A Creator Store adminrendszerei sok parancsot és egy panelt adnak, de ez nagy mennyiségű kód, amelyet nem te írtál. Egy rövid saját script pontosan azt csinálja, amire szükséged van, és semmi mást.
Hogyan tudom meg a Roblox user ID-mat?
Nyisd meg a profilodat a roblox.com oldalon: a linkben a /users/ és a /profile közötti szám a user ID-d.
Látják a játékosok az admin parancsokat a chatben?
Nem. A TextChatCommandra illeszkedő üzenetet a Roblox nem küldi el a többi játékosnak.
Források és további olvasnivaló
- Roblox Creator Docs: TextChatCommand (angolul). aliasok, AutocompleteVisible és Triggered
- Roblox Creator Docs: Custom text chat commands (angolul). a parancsot kezelő szerveroldali Script
- Roblox Creator Docs: Player:Kick (angolul). játékos eltávolítása üzenettel
- Roblox Creator Docs: Text filtering (angolul). mikor kell szűrni a begépelt szöveget
Hogyan ellenőriztük a kódot: az oldalon minden script átmegy a Luau szigorú típusellenőrzésén a Roblox API definícióival (luau-lsp, 2026. november 20.). A típusellenőrzés kiszűri az elírt API-neveket és a rossz típusokat, de a játéklogikai hibákat nem, ezért publikálás előtt mindent tesztelj a Studióban.