מדריך · משחקיות

איך ליצור פקודות אדמין ב-Roblox Studio

פקודות אדמין מאפשרות לנהל את המשחק שלכם ישירות מהצ׳אט: להעיף מפריע, להשתגר לחבר, לבדוק מהירות. בצ׳אט הנוכחי של Roblox, TextChatService, פקודות מובנות דרך TextChatCommand. במדריך הזה תוסיפו על בסיסו ערכת פקודות אדמין, וכל אחת נבדקת בשרת מול רשימת user ID, כך שאף אחד אחר לא יוכל להשתמש בהן.

עודכן 20 בנובמבר 20264 דק׳ קריאהמאת:

בקצרה

ב-Script בתוך ServerScriptService צרו TextChatCommand לכל פקודה, תנו לה PrimaryAlias (למשל "/kick") ושימו אותה בתוך TextChatService. האירוע Triggered שלה מעביר את ה-TextSource של השולח ואת הטקסט המלא של ההודעה. מצאו את השחקן דרך Players:GetPlayerByUserId(textSource.UserId), בדקו שה-user ID שלו נמצא ברשימת האדמינים שלכם, ואז פצלו את ההודעה למילים ובצעו את הפעולה.

  • בדקו את רשימת האדמינים בשרת. בדיקה ב-LocalScript אקספלויטר יכול לעקוף.
  • בדקו user ID, לא שמות: שחקנים יכולים לשנות שמות, וה-ID לא משתנה אף פעם.
  • הודעה שתאמה פקודה לא מוצגת בצ׳אט, ולכן הפקודות לא מלכלכות את הצ׳אט לשחקנים אחרים.
בעמוד הזה
  1. איך זה עובד
  2. 1. הסקריפט
  3. 2. פקודה משלכם
  4. Common errors
  5. With RoCode
  6. שאלות נפוצות
  7. מקורות וקריאה נוספת

איך פקודות צ׳אט עובדות

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: הוסיפו את הפקודות

  1. ודאו שהמשחק משתמש ב-TextChatService: סמנו את TextChatService ב-Explorer והסתכלו על ChatVersion בחלון Properties. אם בפלייס ישן עדיין כתוב שם LegacyChatService, בעמוד של Roblox על צ׳אט טקסט במשחק יש פרק על המעבר.
  2. הכניסו Script לתוך ServerScriptService בשם AdminCommands והדביקו את הקוד שלמטה.
  3. החליפו את 123456 ב-ADMINS ב-user ID שלכם.
Script בתוך ServerScriptService בשם AdminCommands
-- 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.

בדקו

  1. לחצו על Play בפלייס שבבעלותכם. הקלידו בצ׳אט /speed me 60: אתם רצים מהר יותר, וההודעה לא מופיעה בצ׳אט.
  2. אחרי נפילה הקלידו /heal me כדי לבדוק שהחיים חוזרים.
  3. הריצו בדיקה ל-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, עם בדיקה בשרת.

RoCode עושה
  • כותב את סקריפט הפקודות עם ה-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 לא נשלחת לשחקנים אחרים.

מקורות וקריאה נוספת

איך הקוד נבדק: כל סקריפט בעמוד הזה עובר את בודק הטיפוסים המחמיר של Luau עם הגדרות ה-API של Roblox (luau-lsp, 20 בנובמבר 2026). בדיקת טיפוסים תופסת שגיאות בשמות API וטיפוסים שגויים, אבל לא שגיאות בלוגיקת המשחק, אז בדקו הכול ב-Studio לפני הפרסום.

נסו את RoCode במשחק שלכם.

קרדיטים חינמיים בכל יום, בלי כרטיס אשראי. התקינו את הפלאגין, תארו פיצ'ר ובדקו מה מופיע ב-Studio.