מדריך · דיבאג

איך מתקנים שגיאות בסקריפטים ב-Roblox Studio

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

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

בקצרה

פתחו את חלון ה-Output דרך תפריט Window או הלשונית Script, לחצו על Play ולחצו על השגיאה האדומה הראשונה. Studio יפתח את הסקריפט בשורה שבה הוא נפל. ההודעה אומרת מה השתבש: attempt to index nil with 'Humanoid' אומר שהערך ממש לפני .Humanoid היה nil. תקנו את הסיבה שבגללה הערך הזה חסר, והפעילו שוב את המשחק.

  • התחילו מהשגיאה הראשונה ברשימה. שגיאות שמתחתיה הן לעיתים קרובות פשוט התוצאות שלה.
  • שגיאות נפוצות בזמן המשחק מסתכמות בשלוש סיבות: הערך שווה nil, השם כתוב עם שגיאה או עוד לא נטען, או שהקוד רץ בצד הלא נכון (שרת או לקוח).
  • אם אין בכלל שגיאה, בדרך כלל הקוד פשוט לא רץ. בדקו את סוג הסקריפט, איפה הוא נמצא ב-Explorer, את המאפיין Enabled שלו, ואם האירוע שהוא מחכה לו בכלל נורה.
  • כדי לדעת למה הערך באמת שווה בשורה הרלוונטית, הדפיסו אותו דרך print עם תווית, או הציבו בשורה הזו breakpoint.
בעמוד הזה
  1. קוראים את ה-Output
  2. סדר דיבאג
  3. שגיאות נפוצות
  4. אין שגיאות, שום דבר לא קורה
  5. כלי דיבאג
  6. עם RoCode
  7. שאלות נפוצות
  8. מקורות וקריאה נוספת

איך פותחים את ה-Output וקוראים שגיאה

איורהדוגמה עם ה-kill brick מהמדריך, מואצת: השורה השבורה זורקת שגיאה, ואחרי Stop, תיקון ובדיקת משחק חדשה ה-Part נופל בלי שגיאה.

חלון ה-Output הוא המקום שבו Roblox מדווחת על שגיאות בסקריפטים, על אזהרות של המנוע ועל כל מה שהקוד שלכם מדפיס. הוא לא תמיד פתוח, אז פתחו אותו לפני הבדיקה. אם עוד אף פעם לא הרצתם סקריפט, המדריך לסקריפטים למתחילים מתחיל בפתיחת ה-Output ובהדפסת השורה הראשונה מסקריפט.

  1. פתחו את ה-Output דרך תפריט Window ב-Studio או בכפתור בלשונית Script.
  2. נקו הודעות ישנות עם Ctrl+K (⌘K ב-Mac), כדי לראות רק את הבדיקה הזו.
  3. לחצו על Play (F5) ועשו את מה ששובר את המשחק.
  4. מצאו את השורה האדומה הראשונה. שגיאות הן באדום. אזהרות, למשל Infinite yield possible, מוצגות בכתום.

שגיאה בזמן המשחק נראית ב-Output כך. לפי הגדרות התצוגה של ה-Output, לכל שורה יכולים להיות גם זמן, תווית Client או Server ושם הסקריפט.

Output (דוגמה)
ServerScriptService.CoinPad:14: attempt to index nil with 'Coins'
Stack Begin
Script 'ServerScriptService.CoinPad', Line 14 - function award
Script 'ServerScriptService.CoinPad', Line 27
Stack End
  • ServerScriptService.CoinPad הוא המיקום של הסקריפט ב-Explorer: סקריפט בשם CoinPad בתוך ServerScriptService.
  • :14 היא השורה שבה קרתה השגיאה.
  • ההודעה אחרי מספר השורה אומרת מה השתבש. כל אחת מפורטת ברשימת השגיאות הנפוצות שלמטה.
  • ה-stack בין Stack Begin ל-Stack End מראה את הקריאות שהובילו לכאן, החל מהאחרונה: שורה 14 בתוך הפונקציה award, שנקראה משורה 27.

לחצו על שגיאה אדומה, ו-Studio יפתח את הסקריפט הזה עם הסמן בשורה הנכונה. בבדיקה לבד ההודעות של השרת ושל הלקוח שלכם עוברות ל-Output אחד: של השרת מסומנות בירוק, של הלקוח בכחול. המסננים למעלה מצמצמים את הרשימה לפי סוג ההודעה (Error, Warning), לפי ההקשר (Client, Server) או לפי טקסט.

סדר דיבאג שמתאים לכל סקריפט

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

  1. שחזרו את הבעיה. נקו את ה-Output, לחצו על Play ועשו בדיוק את מה ששובר את המשחק. רשמו מה ציפיתם ומה קרה במקום זה.
  2. קחו את השגיאה הראשונה. קראו את השורה האדומה החדשה הראשונה: נתיב הסקריפט, מספר השורה וההודעה. אם אין שגיאה, עברו לפרק סקריפטים שעובדים בלי שגיאות.
  3. עברו לשורה. לחצו על השגיאה. קראו את כל השורה ושאלו את עצמכם איזה ערך בה יכול להיות nil, כתוב עם שגיאה או מהסוג הלא נכון.
  4. בדקו את הערך, אל תנחשו. הוסיפו print ממש מעל השורה או הציבו עליה breakpoint והסתכלו על הערכים בחלון Watch. typeof(x) יגיד מה יש לכם: מספר, מחרוזת, Instance או nil.
  5. לכו אחורה בעקבות. אם הערך לא נכון, מצאו איפה הוא נקבע: FindFirstChild שלא מצא כלום, פונקציה שלא החזירה כלום, ארגומנט שהקוד הקורא לא העביר.
  6. תקנו את הסיבה, שינוי אחד בכל פעם. תקנו את השם, חכו לאובייקט או העבירו את הקוד לצד הנכון, ואז הפעילו שוב את המשחק. אל תעטפו את השורה ב-pcall כדי שתשתוק: כך הבאג מוסתר, לא מתוקן.
  7. ודאו. חזרו על שלב 1. השגיאה צריכה להיעלם, והפיצ׳ר צריך לעשות את מה שציפיתם. אם מדובר בשחקנים אחרים, בדקו גם במצב Server & Clients עם שני לקוחות.
  8. נקו אחריכם. מחקו או כבו את ה-print של הדיבאג, כדי שיהיה קל לזהות את הבעיה הבאה.

שגיאות נפוצות בסקריפטים של Roblox ואיך מתקנים אותן

כל הודעה בנויה לפי אותה תבנית, שאליה נכנסים השמות שלכם, ולכן טקסט השגיאה עצמו הוא הרמז הכי טוב. השמות במרכאות שלמטה, למשל 'Health' או "Workspace", הם דוגמאות.

שגיאות נפוצות ב-Output. בחרו הודעה כדי לפתוח את ההסבר המלא.
מה ה-Output כותבמה זה אומראיך בדרך כלל מתקנים
attempt to index nil with 'Health'הערך לפני .Health היה nil.בררו למה הוא nil, ובדקו אותו עם if לפני השימוש.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild מחכה כבר 5 שניות, והאובייקט לא הופיע.תקנו את השם או הנתיב, ודאו שמישהו יוצר את האובייקט, או הוסיפו זמן קיצוב.
Bridge is not a valid member of Workspace "Workspace"כרגע אין שם ילד או מאפיין עם השם המדויק הזה.השוו את האיות והאותיות הגדולות ל-Explorer. בלקוח השתמשו ב-WaitForChild.
attempt to call a nil valueקראתם למשהו שאינו פונקציה.בדקו את שם הפונקציה ושהיא מוגדרת מעל הקריאה.
attempt to perform arithmetic (add) on Instance and numberחשבון עם משהו שאינו מספר.השתמשו ב-.Value באובייקטי ערך וב-tonumber לטקסט.
attempt to concatenate string with nil.. ניסה לחבר טקסט עם nil או עם אובייקט.השתמשו ב-tostring(), ב-.Name או באינטרפולציה של מחרוזות.
Expected 'end' (to close 'function' at line 3), got <eof>שגיאת תחביר. הסקריפט לא רץ בכלל.תקנו את מה שמסומן בקו אדום ב-Script Editor.
Requested module experienced an error while loadingה-ModuleScript עצמו נפל עם שגיאה בזמן שרץ.תקנו את השגיאה של המודול עצמו, היא מוצגת קצת מעל ב-Output.
Argument 1 missing or nilפונקציה של Roblox קיבלה nil במקום שבו היא צריכה ערך.עקבו מאיפה הארגומנט הזה היה אמור להגיע.
FireServer can only be called from the clientקראו ל-RemoteEvent מהצד הלא נכון.השרת משתמש ב-FireClient, LocalScripts משתמשים ב-FireServer.
שגיאת data store 403, StudioAccessToApisNotAllowedל-Studio אסור להשתמש במאגרי הנתונים של המשחק הזה.פרסמו את המשחק והפעילו את Studio Access to API Services.

לכל הודעה מכאן, ולא רק, יש עמוד משלה עם כל סיבה, הקוד שגורם לה והתיקון: ראו הודעות שגיאה של Roblox Studio, למשל attempt to index nil, Infinite yield possible ו-is not a valid member of.

attempt to index nil with 'X'

אינדוקס הוא קריאה של משהו דרך נקודה או סוגריים מרובעים: part.Position, player.Character, list[1]. השגיאה הזו אומרת שמה שמשמאל היה nil, והשם במרכאות הוא מה שניסיתם לקרוא ממנו. כלומר, בשורה player.Character.Humanoid השגיאה attempt to index nil with 'Humanoid' אומרת ש-player.Character היה nil. אם המפתח הוא מספר, ההודעה נגמרת ב-with number.

הסיבות הרגילות שבגללן ערך היה nil:

  • FindFirstChild, FindFirstChildOfClass או FindFirstAncestor לא מצא כלום, כי השם אחר או שהאובייקט עוד לא קיים.
  • השתמשו ב-Players.LocalPlayer ב-Script של שרת. הוא קיים רק ב-LocalScript וב-ModuleScript שהם טוענים דרך require; בשרת הוא תמיד nil. השתמשו במקומו ב-player ש-PlayerAdded או handler של RemoteEvent נותנים.
  • קראו את player.Character לפני שהדמות נולדה, או בזמן שהיא נולדת מחדש.
  • רשומה בטבלה אף פעם לא נקבעה, למשל playerData[player] לפני שהנתונים של השחקן הזה נטענו, או שהפונקציה שנקראה לא החזירה כלום.

המקרה הקלאסי הוא kill brick. הגרסה השבורה מניחה שכל מה שנוגע ב-Part שייך לדמות, ולכלים שנזרקו, ל-Parts לא מעוגנים ולאביזרים זה לא נכון.

Script בתוך Part ב-Workspace בשם KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- הגרסה השבורה:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- אם ה-Part שנגע אינו חלק מגוף הדמות, FindFirstChild
	-- מחזיר nil, וה-Output מציג:
	--   attempt to index nil with 'Health'

	-- מתוקן: בודקים כל שלב לפני השימוש
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

אם כותבים hit.Parent.Humanoid, תהיה הודעה אחרת, Humanoid is not a valid member of ..., והיא מפורטת למטה. FindFirstAncestorOfClass("Model") מוצא את הדמות גם כשה-Part שנגע נמצא בתוך אביזר או כלי ביד של הדמות, כך שגם כלי ביד שנגע בבלוק נחשב.

התבנית שמתקנת את השגיאה הזו: קבלו את הערך, בדקו אותו, ורק אז השתמשו בו. בשרת FindFirstChild עם בדיקת if מתאים לדברים שבהחלט עשויים לא להיות. ב-LocalScript השתמשו ב-WaitForChild לדברים שהשרת יוצר, כי הם יכולים להופיע רק אחרי שהסקריפט התחיל.

Infinite yield possible on ...

WaitForChild("Name") משהה את הסקריפט עד שמופיע ילד עם השם הזה. אם הוא מחכה יותר מ-5 שניות ולא קבעתם זמן קיצוב, Roblox מדפיסה את האזהרה הזו. זו אזהרה, לא שגיאה: הסקריפט עדיין מחכה, ושום דבר אחרי השורה הזו לא ירוץ עד שהאובייקט יופיע, וזה עלול לא לקרות אף פעם. הסיבות הרגילות:

  • שם או הורה לא נכונים. WaitForChild("leaderStats") אף פעם לא ימצא את התיקייה leaderstats.
  • אף אחד לא יוצר את האובייקט: סקריפט השרת שיוצר אותו כבוי, נמצא במקום הלא נכון או נפל עם שגיאה קודם. חפשו שגיאה מוקדמת יותר ב-Output.
  • LocalScript מחכה למשהו ב-ServerStorage או ב-ServerScriptService. התוכן שלהם אף פעם לא נשלח לשחקנים, ולכן ההמתנה לא תיגמר.
  • אתם מחכים למאפיין, לא לילד. דוגמה נפוצה היא player:WaitForChild("Character"): Character הוא מאפיין של Player, לא אובייקט בתוכו.
  • סטרימינג של אובייקטים מופעל (Workspace.StreamingEnabled), וה-Part רחוק מדי מהשחקן, ולכן עוד לא נשלח ללקוח הזה.
LocalScript בתוך StarterPlayerScripts בשם DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- הגרסה השבורה:
--   local character = player:WaitForChild("Character")
-- Character הוא מאפיין של Player, לא ילד, ולכן ה-Output מזהיר:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- עם זמן קיצוב WaitForChild מחזיר nil, ולא מחכה לנצח
	local humanoid = character:WaitForChild("Humanoid", 10)
	if not (humanoid and humanoid:IsA("Humanoid")) then
		warn(`[DeathMessage] no Humanoid in {character:GetFullName()} after 10 seconds`)
		return
	end
	humanoid.Died:Connect(function()
		print(`[DeathMessage] {player.Name} died`)
	end)
end

-- מטפלים בדמות שאולי כבר קיימת, ואחר כך בכל לידה מחדש
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

המספר שבארגומנט השני של WaitForChild הוא זמן קיצוב בשניות. אז הסקריפט יכול לדווח על הבעיה דרך warn ולהיעצר בצורה מסודרת, ולא להיתקע בשקט.

X is not a valid member of Y

פניתם דרך נקודה לילד או למאפיין שלא קיים באותו רגע, למשל workspace.Bridge כשב-Workspace אין Part בשם Bridge. בהודעה מופיע קודם מה שביקשתם, ואחר כך המחלקה והנתיב המלא של האובייקט שבו חיפשו. בדקו שלושה דברים:

  • האיות והאותיות הגדולות תואמים בדיוק ל-Explorer. התיקייה נקראת leaderstats, כולה באותיות קטנות, ו-humanoid זה לא Humanoid.
  • שמות מאפיינים נכתבים באנגלית אמריקאית. part.Colour נופל עם Colour is not a valid member of Part "Workspace.Part"; המאפיין נקרא Color.
  • האובייקט נטען. בלקוח, אובייקטים שהשרת יוצר יכולים להגיע רק אחרי שה-LocalScript התחיל, ולכן שם השתמשו ב-WaitForChild.
LocalScript בתוך StarterPlayerScripts בשם CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- הגרסה השבורה:
--   local coins = player.leaderstats.Coins
-- את leaderstats השרת יוצר, והוא יכול להגיע ללקוח הזה רק אחרי
-- שהסקריפט הזה התחיל. אז ה-Output מציג:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- השרת יוצר את Coins כ-IntValue

print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
	print(`[CoinsWatcher] coins changed to {newValue}`)
end)

כאן צריך סקריפט שרת שיוצר leaderstats עם IntValue בשם Coins, כמו במדריך לטבלת מובילים.

attempt to call a nil value

הקוד שם סוגריים אחרי משהו ששווה nil, ולכן לא היה מה להריץ. הסיבות הרגילות:

  • שם הפונקציה כתוב עם שגיאה או שונה באותיות גדולות. המודול מגדיר Format.clock, והקוד הקורא כותב Format.Clock(95).
  • קוראים ל-local function בשורה שמעל ההגדרה שלה. ברגע הזה השם עוד לא קיים, אז העבירו את ההגדרה למעלה.
  • ה-ModuleScript אף פעם לא מוסיף את הפונקציה לטבלה שהוא מחזיר.

שתי הודעות דומות מצביעות על אותה שגיאה. קריאה למתודה לא קיימת של טבלה דרך נקודתיים נותנת attempt to call missing method 'Kill' of table. שגיאת הקלדה במתודה של אובייקט Roblox, למשל part:Destory(), נותנת Destory is not a valid member of Part "Workspace.Part".

attempt to perform arithmetic (add) on ...

Luau ניסה לחשב (add, sub, mul, div וכן הלאה), ואחד הצדדים לא היה מספר. שמות הסוגים בסוף ההודעה רומזים איזה מקרה יש לכם:

  • on Instance and number: חישבתם עם אובייקט ערך, ולא עם המספר שלו. coins + 10 צריך להיות coins.Value + 10.
  • on nil and number: משתנה או רשומה בטבלה אף פעם לא נקבעו. תנו להם ערך התחלתי, או כתבו (x or 0) במקום שבו היעדר ערך באמת אומר אפס.
  • on string and number: טקסט שאינו מספר, לעיתים קרובות מ-TextBox. המירו אותו דרך tonumber(text) ובדקו שהתוצאה לא nil. טקסט שכתוב בו מספר, למשל "5", מומר אוטומטית.

השוואות נשברות באותה דרך, עם attempt to compare nil < number. Luau משכתב את a > b כ-b < a, ולכן הסדר בהודעה יכול להיות הפוך מהקוד שלכם.

Script בתוך ServerScriptService בשם CoinDrip
local Players = game:GetService("Players")

local REWARD = 5
local INTERVAL_SECONDS = 60

local function addCoins(player: Player, amount: number)
	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	if not (coins and coins:IsA("IntValue")) then
		-- כותבים למה שום דבר לא קרה, ולא שותקים
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- הגרסה השבורה:
	--   coins = coins + amount
	-- coins הוא אובייקט IntValue, לא המספר שלו, ולכן ה-Output מציג:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- בכל דקה נותנים לכל שחקן בשרת קצת מטבעות
while true do
	task.wait(INTERVAL_SECONDS)
	for _, player in Players:GetPlayers() do
		addCoins(player, REWARD)
	end
end

attempt to concatenate string with nil

האופרטור .. מחבר רק מחרוזות ומספרים. לחבר עם nil לא יעבוד, וגם לא עם אובייקט: "Hi " .. player נותן attempt to concatenate string with Instance. השתמשו ב-player.Name, עטפו את הערך ב-tostring(), או השתמשו באינטרפולציה של מחרוזות עם גרשיים הפוכים, print(`Coins: {coins}`), שתדפיס nil ולא תעצור את הסקריפט.

Expected 'end' ושגיאות תחביר אחרות

הודעות שמתחילות ב-Expected הן שגיאות תחביר: הקוד הוא לא Luau תקין, Roblox לא יכולה לקמפל אותו, ואף שורה בסקריפט הזה לא רצה, גם לא אלה שמעל השגיאה. Script Editor מסמן אותן בקו אדום כבר בזמן ההקלדה, כך שאפשר לתקן אותן לפני שלוחצים על Play.

  • Expected 'end' (to close 'function' at line 3), got <eof>: ל-function, ל-if, ל-for או ל-while שמתחיל בשורה 3 אין end משלו. מספר השורה לפני ההודעה מצביע לעיתים קרובות על סוף הקובץ, ולכן הסתכלו על השורה שמצוינת בסוגריים.
  • Expected 'then' when parsing if statement, got '=': = בודד בתנאי. להשוואה צריך ==.
  • Expected ')' (to close '(' at line 1), got 'local': סוגריים שאף פעם לא נסגרו.
  • Expected <eof>, got 'end': end אחד מיותר.

עם הזחה מסודרת קל לזהות end חסר או מיותר, כי כל בלוק עומד באותה רמה כמו ה-end שסוגר אותו.

Requested module experienced an error while loading

ה-require() הראשון של ModuleScript מריץ את הקוד שלו. אם המודול נופל עם שגיאה בזמן הריצה, הסקריפט שטען אותו מקבל את ההודעה הזו. הבעיה האמיתית היא השגיאה של המודול עצמו, שורה או שתיים מעל ב-Output: תקנו אותה. שתי הודעות דומות:

  • Module code did not return exactly one value: המודול לא נגמר ב-return. ModuleScript חייב להחזיר ערך אחד, לא nil, בדרך כלל את הטבלה שלו.
  • Requested module was required recursively: שני מודולים טוענים זה את זה. הוציאו את החלק המשותף למודול שלישי, ששניהם טוענים.
ModuleScript בתוך ReplicatedStorage בשם Format
local Format = {}

-- ממיר מספר שניות לדקות ושניות: 95 הופך ל-"1:35"
function Format.clock(seconds: number): string
	local whole = math.max(0, math.floor(seconds))
	return string.format("%d:%02d", whole // 60, whole % 60)
end

-- המודול חייב להחזיר בסוף את הטבלה שלו. בלי השורה הזו כל
-- require של המודול הזה נופל עם: Module code did not return exactly one value
return Format

הסקריפט טוען אותו דרך local Format = require(ReplicatedStorage:WaitForChild("Format")), ואז קורא ל-Format.clock(95). אם כותבים Format.Clock(95), תתקבל השגיאה attempt to call a nil value.

Argument 1 missing or nil

פונקציה של Roblox קיבלה nil בארגומנט שהיא צריכה, והמספר אומר באיזה בדיוק. workspace:FindFirstChild(itemName) נופל כך כש-itemName שווה nil. הבאג נמצא לעיתים רחוקות בשורה הזו. הוא במקום שממנו הערך היה אמור להגיע: משתנה עם שגיאת הקלדה, Attribute שאף פעם לא נקבע, או ארגומנט של RemoteEvent שהלקוח לא שלח. ארגומנטים של RemoteEvent מגיעים מהמכשיר של השחקן, ולכן השרת חייב לבדוק אותם לפני השימוש. איך עושים את זה, מראה המדריך ל-RemoteEvent.

FireServer can only be called from the client

ל-RemoteEvent יש כיוון. LocalScript קורא ל-FireServer, ו-Script של שרת מאזין דרך OnServerEvent. Script של שרת קורא ל-FireClient או ל-FireAllClients, ו-LocalScripts מאזינים דרך OnClientEvent. קריאה למתודה מהצד הלא נכון נותנת את השגיאה הזו או את המראה שלה, FireClient can only be called from the server. בדרך כלל התיקון הוא להעביר את הקוד לסקריפט מהסוג הנכון: ראו Script, LocalScript ו-ModuleScript.

שגיאת data store 403 ב-Studio

קריאות ל-data store ב-Studio נופלות עם קוד השגיאה 403 (StudioAccessToApisNotAllowed) עד שתתירו אותן. פרסמו את הפלייס, פתחו File, Experience Settings, Security, הפעילו את Enable Studio Access to API Services ושמרו. אחרי זה Studio משתמש באותם data stores כמו המשחק החי, ולכן Roblox ממליצה לעשות את זה בעותק בדיקה נפרד, ולא במשחק שכבר משחקים בו. עטפו כל קריאה ל-data store ב-pcall, כי קריאות כאלה יכולות להיכשל מסיבות מחוץ לקוד שלכם. איך שומרים בבטחה, מפורט במדריך ל-DataStore.

הסקריפט רץ בלי שגיאות, אבל לא עושה כלום

סקריפט שותק בדרך כלל לא רץ בכלל, עדיין מחכה למשהו, או רץ בצד הלא נכון. לפני שמשנים קוד, הפכו את print(script:GetFullName(), "started") לשורה הראשונה שלו והפעילו את המשחק. אם השורה הזו לא הופיעה אף פעם ב-Output, הבעיה היא במקום שבו הסקריפט נמצא או באיך הוא מוגדר, לא במה שכתוב בו.

למה סקריפט יכול לא לעשות כלום בלי שגיאה
מה לבדוקמה משתבשאיך מתקנים
סוג הסקריפט והמיקום שלוLocalScript רץ רק אם שמים אותו ב-StarterPlayerScripts, ב-StarterCharacterScripts, ב-StarterGui, ב-StarterPack או ב-ReplicatedFirst (ממכלי ה-Starter הוא רץ כעותק של השחקן). אם שמים אותו ב-Workspace, ב-ServerScriptService או ב-ReplicatedStorage, הוא לא ירוץ אף פעם. Script עם RunContext כברירת מחדל רץ רק ב-Workspace או ב-ServerScriptService.העבירו אותו, או קחו סוג סקריפט אחר. קוד של ממשק ושליטה הולך ל-LocalScript, חוקי המשחק הולכים ל-Script ב-ServerScriptService.
Enabledסקריפט שהסימון Enabled שלו הוסר לא רץ.סמנו אותו וסמנו Enabled בחלון Properties.
RunContextה-RunContext של Script קובע איפה הוא רץ. Legacy, ערך ברירת המחדל, רץ בשרת מ-Workspace או מ-ServerScriptService. Server רץ בשרת, Client רץ במכשיר של כל שחקן, למשל מ-ReplicatedStorage.קבעו אותו במודע. התיעוד של Roblox ממליץ לשים Client Script ב-ReplicatedStorage או ב-ReplicatedFirst, ו-LocalScript במכלי ה-Starter.
האירוע לא נורהTouched נורה רק מתנועה פיזיקלית, צריך שלפחות אחד משני ה-Parts לא יהיה מעוגן, וצריך CanTouch בשניהם. PlayerAdded לא נורה לשחקנים שכבר היו בשרת כשהתחברתם לאירוע. handler של RemoteEvent לא ירוץ אם הצד השני אף פעם לא מפעיל את האירוע.שימו print בתוך ה-handler כדי לדעת בוודאות אם הוא רץ, ואז תקנו את מה שאמור להפעיל אותו.
קוד אחרי לולאה או המתנהשורות מתחת ללולאת while true do אף פעם לא רצות, כי הלולאה לא נגמרת. גם שורות מתחת ל-WaitForChild שאף פעם לא מוצא את האובייקט לא רצות.חברו אירועים לפני הלולאה, או הפעילו את הלולאה דרך task.spawn. תנו להמתנות זמן קיצוב.
בדיקה שיוצאת בשקטהגנה כמו if not coins then return end עוצרת את הפונקציה בשקט כשהאובייקט לא קיים.הוסיפו warn עם פרטים לפני ה-return.
המסננים של ה-Outputאת ה-Output אפשר לסנן לפי סוג ההודעה, לפי Client או Server ולפי טקסט. מסנן שנשכח עלול להסתיר את השגיאה שאתם מחפשים.אפסו את המסננים ונקו את שדה החיפוש.
רק אתם רואיםאת השינוי עשה LocalScript, ולכן רק השחקן הזה רואה אותו. השרת ושחקנים אחרים לא רואים אותו.עשו את השינוי בשרת. ראו איפה סקריפטים רצים.

במקרה של PlayerAdded נופלים רבים, כי בבדיקה ב-Studio אתם נכנסים כמעט מיד אחרי שהשרת עולה. אם משהו מעל השורה עם Connect מחכה, למשל WaitForChild, task.wait או require של מודול שמחכה, אתם עלולים להיכנס לפני שהחיבור מופיע. טפלו גם בשחקנים חדשים וגם במי שכבר נכנס:

Script בתוך ServerScriptService בשם Welcome
local Players = game:GetService("Players")

local function onPlayerAdded(player: Player)
	print(`[Welcome] {player.Name} joined`)
end

Players.PlayerAdded:Connect(onPlayerAdded)

-- לשחקנים שכבר היו כאן כשהשורה שלמעלה רצה,
-- PlayerAdded בסקריפט הזה לא יירה, ולכן מטפלים בהם עכשיו
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

כלי דיבאג ב-Roblox Studio

print כותב שורה ל-Output, ו-warn כותב אזהרה. זו הדרך הכי מהירה לענות על השאלות "זה בכלל רץ?" ו"למה הערך הזה שווה?". print(x) ערום קשה למצוא אחר כך, ולכן הוסיפו תווית ופרטים חשובים. typeof(x) מראה איזה ערך זה: מספר, מחרוזת, Instance או nil, ו-GetFullName() מראה איזה אובייקט בדיוק יש לכם.

Script בתוך ServerScriptService בשם ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- קבעו false כשתסיימו
local TAG = "[ShopServer]"

local function debugPrint(...: any)
	if DEBUG then
		print(TAG, ...)
	end
end

Players.PlayerAdded:Connect(function(player: Player)
	debugPrint("joined:", player.Name, player.UserId)

	local leaderstats = player:WaitForChild("leaderstats", 10)
	if not leaderstats then
		warn(TAG, "no leaderstats for", player.Name, "after 10 seconds")
		return
	end

	local coins = leaderstats:FindFirstChild("Coins")
	-- typeof ו-ClassName מראים מה הערך באמת
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

שדה החיפוש ב-Output מסנן לפי טקסט, ולכן תווית קבועה כמו [ShopServer] מאפשרת להציג רק את השורות של המערכת הזו. אם צריך לדעת איך הקוד הגיע לשורה, debug.traceback() מחזיר את ה-stack הנוכחי של הקריאות כמחרוזת.

Breakpoints והרצה צעד אחר צעד

Breakpoint משהה את המשחק בשורה, כדי שאפשר יהיה להסתכל על הכול באותו רגע. ב-Script Editor לחצו על השוליים שמימין למספר השורה (יופיע עיגול אדום), ואז הפעילו בדיקת משחק. כשהביצוע יגיע לשורה הזו, המשחק יושהה, וחץ צהוב יראה את השורה הבאה. משם כפתורי ההרצה צעד אחר צעד מזיזים אתכם בקוד:

  • Step Over (F10) מבצע את השורה הנוכחית ונעצר בבאה.
  • Step Into (F11) נכנס לתוך הפונקציה שנקראת בשורה הזו.
  • Step Out (Shift+F11) מריץ את הפונקציה הנוכחית עד הסוף ונעצר בקוד שקרא לה.
  • Resume Scripts ממשיך עד ה-breakpoint הבא.

לחיצה ימנית על השוליים נותנת עוד שני סוגים שימושיים. Breakpoint מותנה משהה רק כשביטוי כמו amount < 0 הוא אמת. Logpoint מדפיס הודעה ל-Output בלי השהיה, כך שאפשר לרשום ערך בלי לשנות את הסקריפט.

Watch ו-Call Stack

כשהמשחק מושהה, רחפו מעל משתנה ב-Script Editor כדי לראות את הערך שלו. חלון ה-Watch בלשונית Variables מציג את כל המשתנים בטווח, ובלשונית My Watches אפשר להקליד כל ביטוי, למשל coins.Value + amount, ולראות את הערך הנוכחי שלו. חלון ה-Call Stack מראה איזו פונקציה קראה לאיזו כדי להגיע לשורה המושהית. שניהם נפתחים דרך הלשונית Script או תפריט Window.

Script Analysis ומצב strict

Script Editor מסמן בעיות כבר בזמן ההקלדה, וחלון Script Analysis, שנפתח בכפתור Analysis בלשונית Script, מציג שגיאות ואזהרות בכל הסקריפטים. הוא תופס שגיאות תחביר ושמות לא מוכרים לפני שלוחצים על Play. אם שמים בשורה הראשונה של סקריפט --!strict, מופעלת בדיקת הטיפוסים המחמירה של Luau, שמדווחת גם על שגיאות הקלדה במאפיינים, על סוגים שגויים של ארגומנטים ועל ערכים שעלולים להיות nil. אבל היא לא רואה את המשחק שרץ: Part שלא קיים ב-Workspace יראה רק ה-Output.

Command bar

ה-Command bar (בלשונית Script או Ctrl+9, ⌘9 ב-Mac) מריץ Luau מיד. כשהמשחק רץ, זו דרך מהירה לשאול שאלה: print(workspace:FindFirstChild("Bridge")) יגיד אם Part כזה קיים, ו-print(#game:GetService("Players"):GetPlayers()) יספור את השחקנים. במצב עריכה קוד מה-command bar משנה את הפלייס שלכם באמת, אז היזהרו עם כל מה שמזיז או מוחק אובייקטים.

Developer Console במשחק חי

ה-Output ב-Studio עובד רק ב-Studio. במשחק חי לחצו על F9 או כתבו /console בצ׳אט כדי לפתוח את Developer Console. ה-Log שלו מציג פלט מהמכשיר שלכם, ופלט מהשרת אם אתם הבעלים של המשחק או חברי קבוצה עם הרשאה לערוך אותו.

גם ה-Assistant המובנה ב-Roblox יכול לעזור עם הודעה מסוימת: המדריך של Roblox עצמה ממליץ להדביק את השגיאה מה-Output ולבקש מ-Assistant לפרק אותה. אם Assistant הפסיק לענות או כותב שהגעתם למגבלה, ראו מגבלות ושגיאות של Assistant.

תיקון שגיאות עם RoCode

RoCode הוא סוכן AI עצמאי ל-Roblox Studio: אתם מתארים את הבעיה בצ׳אט באתר, והפלאגין ל-Studio קורא ועורך את הפלייס שפתוח אצלכם. עם שגיאות הוא יכול לקחת על עצמו את שלבי הקריאה מהסדר שלמעלה, על סמך בדיקת משחק שכבר הרצתם.

אתם כותבים

לחצתי על Play, ולחיצה על כפתור החנות לא עושה כלום. ה-Output מציג attempt to index nil with 'Coins'. תמצא את הסיבה ותתקן.

RoCode עושה
  • קורא את ה-Output ב-Studio עם הכלי Check Output שלו, כולל שורות Server ו-Client מבדיקת המשחק האחרונה שלכם, גם אחרי שלחצתם על Stop
  • פותח את הסקריפט מהשגיאה דרך Read Script וקורא את הקוד סביב השורה הזו, ודרך Search Scripts יכול למצוא איפה הערך החסר היה אמור להיווצר
  • עושה עריכה ממוקדת דרך Edit Script, חיפוש והחלפה מדויקים בסקריפט הזה, ואז מריץ Check Script, שמקמפל את הסקריפט בתוך Studio (הוא לא בודק טיפוסים, לא מריץ linter ולא מבצע את הקוד שלכם)
  • שולח את השינויים ל-Studio בקבוצות, וכל קבוצה היא נקודת ביטול בהיסטוריה של Studio

לחצו שוב על Play ועל כפתור החנות, כדי לוודא בעצמכם שהתיקון עובד: עם פלאגין 3.9 ומעלה RoCode יכול להריץ בדיקת משחק קצרה ולקרוא את השגיאות, ועם פלאגין 3.9.15 ומעלה דמות הבדיקה שלו יכולה ללחוץ על כפתורים במסך, אבל הוא בודק רק את מה שהוא עצמו החליט לבדוק, ובדיקת קומפילציה לא תגיד אם הלוגיקה של המשחק נכונה. קריאת שגיאות היא חלק מכל בנייה: מחזור הבנייה, הבדיקה וההרצה למשחק שלם חוזר על הבדיקה הזו אחרי כל מערכת. איך RoCode מתחבר ל-Studio.

שאלות נפוצות

למה סקריפט ב-Roblox לא עובד, למרות שאין שגיאות?

בדרך כלל הסקריפט בכלל לא רץ (סוג סקריפט או מכל לא נכונים, או ש-Enabled כבוי), הוא עדיין מחכה למשהו, או שהאירוע שהוא מאזין לו אף פעם לא נורה. Print בשורה הראשונה יראה איזו מהאפשרויות. ראו את רשימת הבדיקה שלמעלה.

מה זה "attempt to index nil" ב-Roblox?

הערך לפני הנקודה או הנקודתיים היה nil, ולכן Roblox לא יכלה להציץ פנימה. בשורה player.Character.Humanoid השגיאה attempt to index nil with 'Humanoid' אומרת ש-player.Character היה nil: הוא לא קיים או עוד לא נטען. בדקו את הערך עם if לפני השימוש, וב-LocalScript חכו לאובייקטים שהשרת יוצר דרך WaitForChild. עוד על הסיבות.

מה זה "infinite yield possible" ב-Roblox?

WaitForChild מחכה יותר מ-5 שניות לילד שלא הופיע, וממשיך לחכות. לעיתים קרובות שם או הורה לא נכונים, או שאף אחד לא יוצר את האובייקט. עוד על הסיבות.

למה חלון ה-Output ריק או לא מוצג?

פתחו אותו דרך תפריט Window או הלשונית Script. אם הוא פתוח אבל נשאר ריק בזמן הבדיקה, אפסו את המסננים ואת שדה החיפוש, ואז בדקו שהסקריפטים שאמורים להדפיס משהו באמת רצים.

יש ב-Roblox בדיקה של סקריפטים לשגיאות?

כן, היא מובנית ב-Studio: Script Editor מסמן בעיות בזמן ההקלדה, וחלון Script Analysis מציג אותן ברשימה. הם מוצאים שגיאות תחביר ושגיאות טיפוסים, אבל לא אובייקטים חסרים ולא לוגיקת משחק שגויה: את זה רואים רק כשהקוד רץ.

צריך לעטוף קוד ב-pcall כדי שלא יהיו שגיאות?

רק קריאות שיכולות להיכשל מסיבות מחוץ לקוד שלכם, למשל בקשות ל-data stores, ל-HTTP או ל-MarketplaceService. אם עוטפים ב-pcall שגיאה עם nil, ההודעה נעלמת, והפונקציה עדיין לא תעבוד.

איך רואים שגיאות בסקריפטים במשחק חי?

לחצו על F9 במשחק או כתבו /console בצ׳אט כדי לפתוח את Developer Console. הוא מציג שגיאות מהמכשיר שלכם, ומהשרת אם אתם הבעלים של המשחק או חברי קבוצה שיכולים לערוך אותו.

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

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

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

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