ניפוי שגיאות במשחקים שנוצרו בעזרת AI

סווגו את הכשל לפני בקשת תיקון

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

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

לכדו את שגיאת המנוע המשמעותית הראשונה

ב-Godot השתמשו בחלונית debugger ובפלט הריצה הרלוונטי. ב-Unity בדקו שגיאות קומפילציה ושגיאות ריצה בנפרד והמתינו שהעורך יהיה מוכן לפני פרשנות תוצאות play. שמרו את ה-stack או את המיקום שמזהה את הסקריפט שנכשל ואת הפעולה שהפעילה אותו.

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

צמצמו את השחזור בלי לשנות את הדרישה

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

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

Project revision: <record actual revision>
Engine and target: <record actual environment>
Steps: launch -> start round -> perform the failing action
Expected state: <specific result>
Observed state: <specific result>
First engine error: <relevant error and location>
Inspect the referenced scene and script before editing.
Propose one cause, make a scoped fix, then repeat these steps.
Preserve the required behavior and report any remaining failure.

חקרו מסך ריק בשכבות

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

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

עקבו אחר קלט דרך מעבר המשחק

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

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

הפרידו טעינת דפדפן מלוגיקת משחק

בייצוא web של Godot בדקו את חלוניות הרשת וה-console בדפדפן לפני עריכת קוד המשחק. ודאו ש-HTML, JavaScript, WebAssembly וחבילת המשחק המיוצאים נטענים מהמיקום המיועד. השוו את הגדרות האירוח לתיעוד הרשמי של web export, כולל דרישות תצורת ה-thread שנבחרה.

שמרו על עקביות בין שמות קובצי העזר המיוצאים ובדקו את ה-artifact, לא תערובת של קבצים ישנים וחדשים. אם מופיע פרויקט שגוי, בדקו caching של service worker בדפדפן הבדיקה. לאחר מכן הפעילו קלט ואמתו תוכן נע. canvas שאינו ריק הוא בדיקת רינדור ראשונית, לא הוכחה שלולאת המשחק עובדת.

בדקו כשלים ייחודיים לייצוא ביעד

כאשר העורך עובד אך ה-build המופץ נכשל, השוו סצנת הפעלה, משאבים שנכללו, תצורה ויומני יעד. שמרו את ה-hash המדויק של ה-artifact כדי שייצוא מאוחר יותר לא יבטל את רשומת השחזור. בדקו ממצב התחלה נקי לפני הסתמכות על שמירות קיימות או caches של העורך.

אל תשנו את המכניקה המרכזית כדי לפתור קובץ ארוז חסר. תקנו את גבול האריזה והריצו שוב את אותו נתיב קבלה ב-build של היעד. עבור artifacts לשולחן עבודה השתמשו במערכת ההפעלה האמיתית; עבור artifacts לדפדפן השתמשו בדפדפן ובהגדרות האירוח המיועדים. ייצוא חוצה פלטפורמות לבדו אינו מוכיח התנהגות ביעד.

סגרו תיקון בתוצאת לפני ואחרי

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

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

שאלות נפוצות