בקצרה
ב-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 הוא סוכן AI עצמאי ל-Roblox Studio, לא של Roblox: אתם מתארים את השינוי בצ׳אט באתר, והפלאגין שלו ל-Studio יוצר סקריפטים ב-Explorer שלכם.
תוסיף פקודות אדמין בשבילי ובשביל החבר שלי (user ID 111 ו-222): /kick, /tp, /speed, /heal, /kill ו-/fly, עם בדיקה בשרת.
- כותב את סקריפט הפקודות עם ה-ID של האדמינים שלכם וכל פקודה נוספת שתתארו
- יכול לקרוא קודם את הפלייס שלכם כדי להשתמש במה שכבר קיים, למשל הגדרת צ׳אט קיימת
- הוא מונחה לבדוק את הקומפילציה של כל סקריפט עם Check Script, ומציב נקודות ביטול סביב כל קבוצת שינויים
לבדוק את הפקודות בבדיקת משחק עדיין צריכים אתם, ולבדיקת האדמין צריך שחקן שני. איך RoCode מתחבר ל-Studio.
שאלות נפוצות
איך מוסיפים פקודות אדמין למשחק Roblox שלי?
צרו TextChatCommand ב-Script של שרת, ובכל handler של 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 עם הגדרות ה-API של Roblox (luau-lsp, 20 בנובמבר 2026). בדיקת טיפוסים תופסת שגיאות בשמות API וטיפוסים שגויים, אבל לא שגיאות בלוגיקת המשחק, אז בדקו הכול ב-Studio לפני הפרסום.