בקצרה
פתחו את חלון ה-Output דרך תפריט Window או הלשונית Script, לחצו על Play ולחצו על השגיאה האדומה הראשונה. Studio יפתח את הסקריפט בשורה שבה הוא נפל. ההודעה אומרת מה השתבש: attempt to index nil with 'Humanoid' אומר שהערך ממש לפני .Humanoid היה nil. תקנו את הסיבה שבגללה הערך הזה חסר, והפעילו שוב את המשחק.
- התחילו מהשגיאה הראשונה ברשימה. שגיאות שמתחתיה הן לעיתים קרובות פשוט התוצאות שלה.
- שגיאות נפוצות בזמן המשחק מסתכמות בשלוש סיבות: הערך שווה
nil, השם כתוב עם שגיאה או עוד לא נטען, או שהקוד רץ בצד הלא נכון (שרת או לקוח). - אם אין בכלל שגיאה, בדרך כלל הקוד פשוט לא רץ. בדקו את סוג הסקריפט, איפה הוא נמצא ב-Explorer, את המאפיין
Enabledשלו, ואם האירוע שהוא מחכה לו בכלל נורה. - כדי לדעת למה הערך באמת שווה בשורה הרלוונטית, הדפיסו אותו דרך print עם תווית, או הציבו בשורה הזו breakpoint.
בעמוד הזה
איך פותחים את ה-Output וקוראים שגיאה
חלון ה-Output הוא המקום שבו Roblox מדווחת על שגיאות בסקריפטים, על אזהרות של המנוע ועל כל מה שהקוד שלכם מדפיס. הוא לא תמיד פתוח, אז פתחו אותו לפני הבדיקה. אם עוד אף פעם לא הרצתם סקריפט, המדריך לסקריפטים למתחילים מתחיל בפתיחת ה-Output ובהדפסת השורה הראשונה מסקריפט.
- פתחו את ה-Output דרך תפריט Window ב-Studio או בכפתור בלשונית Script.
- נקו הודעות ישנות עם Ctrl+K (⌘K ב-Mac), כדי לראות רק את הבדיקה הזו.
- לחצו על Play (F5) ועשו את מה ששובר את המשחק.
- מצאו את השורה האדומה הראשונה. שגיאות הן באדום. אזהרות, למשל
Infinite yield possible, מוצגות בכתום.
שגיאה בזמן המשחק נראית ב-Output כך. לפי הגדרות התצוגה של ה-Output, לכל שורה יכולים להיות גם זמן, תווית Client או Server ושם הסקריפט.
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) או לפי טקסט.
סדר דיבאג שמתאים לכל סקריפט
לנחש ולשנות כמה דברים בבת אחת זו דרך איטית לתקן סקריפט. הסדר הזה מצמצם את הבעיה צעד אחר צעד, בין אם יש הודעת שגיאה ובין אם לא.
- שחזרו את הבעיה. נקו את ה-Output, לחצו על Play ועשו בדיוק את מה ששובר את המשחק. רשמו מה ציפיתם ומה קרה במקום זה.
- קחו את השגיאה הראשונה. קראו את השורה האדומה החדשה הראשונה: נתיב הסקריפט, מספר השורה וההודעה. אם אין שגיאה, עברו לפרק סקריפטים שעובדים בלי שגיאות.
- עברו לשורה. לחצו על השגיאה. קראו את כל השורה ושאלו את עצמכם איזה ערך בה יכול להיות
nil, כתוב עם שגיאה או מהסוג הלא נכון. - בדקו את הערך, אל תנחשו. הוסיפו
printממש מעל השורה או הציבו עליה breakpoint והסתכלו על הערכים בחלון Watch.typeof(x)יגיד מה יש לכם: מספר, מחרוזת, Instance או nil. - לכו אחורה בעקבות. אם הערך לא נכון, מצאו איפה הוא נקבע:
FindFirstChildשלא מצא כלום, פונקציה שלא החזירה כלום, ארגומנט שהקוד הקורא לא העביר. - תקנו את הסיבה, שינוי אחד בכל פעם. תקנו את השם, חכו לאובייקט או העבירו את הקוד לצד הנכון, ואז הפעילו שוב את המשחק. אל תעטפו את השורה ב-
pcallכדי שתשתוק: כך הבאג מוסתר, לא מתוקן. - ודאו. חזרו על שלב 1. השגיאה צריכה להיעלם, והפיצ׳ר צריך לעשות את מה שציפיתם. אם מדובר בשחקנים אחרים, בדקו גם במצב Server & Clients עם שני לקוחות.
- נקו אחריכם. מחקו או כבו את ה-print של הדיבאג, כדי שיהיה קל לזהות את הבעיה הבאה.
שגיאות נפוצות בסקריפטים של Roblox ואיך מתקנים אותן
כל הודעה בנויה לפי אותה תבנית, שאליה נכנסים השמות שלכם, ולכן טקסט השגיאה עצמו הוא הרמז הכי טוב. השמות במרכאות שלמטה, למשל 'Health' או "Workspace", הם דוגמאות.
| מה ה-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 לא מעוגנים ולאביזרים זה לא נכון.
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 רחוק מדי מהשחקן, ולכן עוד לא נשלח ללקוח הזה.
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.
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, ולכן הסדר בהודעה יכול להיות הפוך מהקוד שלכם.
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: שני מודולים טוענים זה את זה. הוציאו את החלק המשותף למודול שלישי, ששניהם טוענים.
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 של מודול שמחכה, אתם עלולים להיכנס לפני שהחיבור מופיע. טפלו גם בשחקנים חדשים וגם במי שכבר נכנס:
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 ו-warn עם הקשר
print כותב שורה ל-Output, ו-warn כותב אזהרה. זו הדרך הכי מהירה לענות על השאלות "זה בכלל רץ?" ו"למה הערך הזה שווה?". print(x) ערום קשה למצוא אחר כך, ולכן הוסיפו תווית ופרטים חשובים. typeof(x) מראה איזה ערך זה: מספר, מחרוזת, Instance או nil, ו-GetFullName() מראה איזה אובייקט בדיוק יש לכם.
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'. תמצא את הסיבה ותתקן.
- קורא את ה-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. הוא מציג שגיאות מהמכשיר שלכם, ומהשרת אם אתם הבעלים של המשחק או חברי קבוצה שיכולים לערוך אותו.
מקורות וקריאה נוספת
- Roblox Creator Docs: Output (באנגלית). איפה נמצא ה-Output, המסננים שלו והגדרות התצוגה
- Roblox Creator Docs: Debugging (באנגלית). breakpoints, הרצה צעד אחר צעד, Watch, Call Stack, ה-command bar ו-Developer Console
- Roblox Creator Docs: Script Editor (באנגלית). חלון Script Analysis
- Roblox Creator Docs: Studio interface (באנגלית). איפה נפתחים ה-Output וה-command bar
- Roblox Creator Docs: Script types and locations (באנגלית). איפה כל סוג סקריפט רץ, ו-RunContext
- Roblox Creator Docs: Studio testing modes (באנגלית). Play, התצוגות Client ו-Server, ובדיקות Server & Clients
- Roblox Engine API: Instance (באנגלית). WaitForChild, זמן הקיצוב שלו והאזהרה אחרי 5 שניות
- Roblox Creator Docs: Reuse code (באנגלית). ModuleScript ו-require רקורסיבי
- Roblox Creator Docs: Data store error codes and limits (באנגלית). שגיאה 403, StudioAccessToApisNotAllowed
- Roblox Creator Docs: Data stores (באנגלית). הפעלת גישה מ-Studio ועותק בדיקה נפרד
- Roblox Engine API: BasePart (באנגלית). מתי Touched נורה, ו-CanTouch
- Roblox Creator Docs: Type checking (באנגלית). מצב strict
- Roblox Creator Docs: Developer Console (באנגלית). מי רואה את הפלט של השרת במשחק חי
- Roblox Creator Docs: Build your first game with Assistant (באנגלית). הדבקת שגיאה מה-Output כדי ש-Assistant יפרק אותה
איך הקוד נבדק: כל סקריפט בעמוד הזה עובר את בודק הטיפוסים המחמיר של Luau עם הגדרות ה-API של Roblox (luau-lsp, 20 בנובמבר 2026). בדיקת טיפוסים תופסת שגיאות בשמות API וטיפוסים שגויים, אבל לא שגיאות בלוגיקת המשחק, אז בדקו הכול ב-Studio לפני הפרסום.