I-debug ang AI-generated game
Updated 2026-09-05
Hanapin ang unang boundary na nabibigo, bigyan ang agent ng reproducible symptom, at muling subukan ang parehong player action. Magsimula sa engine at build na aktuwal mong pinapatakbo.
I-classify ang failure bago humingi ng fix
Tukuyin ang pinakamaagang nabigong hakbang: project discovery, import, parsing o compilation, scene startup, player input, gameplay state, export, o target launch. Maaaring bunga lamang ng unang failure ang mga susunod na symptom. Panatilihing magkakasama ang engine version, project revision, target, at eksaktong reproduction.
Halimbawa, hindi masasabi ng scene na hindi kailanman nagsisimula kung gumagana ang restart button nito. Hindi masusubok ng browser na hindi makakuha ng game package ang controller. I-route ang error sa tamang boundary bago baguhin ang code; pinipigilan nito ang repair loop na makaipon ng hindi kaugnay na patch habang sira pa rin ang orihinal na prerequisite.
| Sintomas | Suriin muna | Resulta ng retest |
|---|---|---|
| Hindi mabuksan ang project | Path, version, dependency | Inaasahang naglo-load ang project |
| Walang laman na scene | Startup error, scene, camera, visibility | Lumilitaw ang inaasahang content |
| Walang epekto ang input | Focus, action mapping, state, handler | Binabago ng action ang game state |
| Bumibigo ang export | Preset o target prerequisite | Nabubuo ang artifact |
| Sa target lamang nabibigo ang build | Packaged resource at platform log | Nakukumpleto ng target ang parehong loop |
Kunin ang unang makabuluhang engine error
Sa Godot, gamitin ang debugger panel at kaugnay na runtime output. Sa Unity, hiwalay na suriin ang compilation at runtime error at hintaying handa ang editor bago bigyang-kahulugan ang play result. Panatilihin ang stack o location na tumutukoy sa nabigong script at operasyong nag-trigger nito.
Magpadala sa agent ng focused excerpt kasama ng kaugnay na scene o object context. Iwasan ang napakalaking hindi naihiwalay na log na nagtatago sa unang error, ngunit panatilihin nang lokal ang buong record para sa susunod na inspection. I-redact ang credential at personal data. Sinasabi ng kapaki-pakinabang na report kung ano ang ginawa ng player, ano ang dapat mangyari, at ano ang aktuwal na iniulat ng engine.
Bawasan ang reproduction nang hindi binabago ang requirement
Magsimula sa recoverable project state at ihiwalay ang pinakamaliit na scene o action na nagpapakita pa rin ng defect. Panatilihing kasama ang totoong controller, collision rule, o save boundary na sangkot sa problema. Maaaring maging malinis ang run kapag inalis nang buo ang nabigong system, ngunit mawawala ang behavior na kailangan mong ayusin.
Orihinal na diagnostic template ang brief sa ibaba. Punan ito ng naobserbahang detalye sa halip na hilinging magpalagay ng sanhi ang model. Humingi ng isang iminungkahing paliwanag at makitid na pagbabago. Kapag kumpleto na ang test, ibalik ang buong player journey upang hindi maitago ng lokal na repair ang sirang scene transition.
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.Siyasatin nang patong-patong ang blank screen
Tukuyin muna kung nagsimula ang engine at nag-load ang nilalayong scene. Pagkatapos, suriin ang camera selection, viewport dimension, object visibility, position, at anumang overlay na tumatakip sa scene. Gamitin nang magkasama ang engine state at totoong capture: maaaring hindi ipakita ng image lamang kung naka-pause, nasa labas ng camera, o walang laman ang scene.
Maglapat ng input at obserbahan kung nagbabago ang state kahit walang lumilitaw. Kung nagbabago ang position ngunit hindi ang image, ituon ang pagsusuri sa rendering o scene reference. Kung parehong walang pagbabago, siyasatin muna ang startup at input bago ayusin ang artwork. Iugnay ang bawat hypothesis sa isang observation upang hindi muling isulat ng agent ang parehong system nang walang kailangan.
Subaybayan ang input sa gameplay transition
Sundan ang action mula focus at mapping hanggang handler, saka sa state na dapat nitong baguhin. Suriin ang pause state at UI interception bago sisihin ang movement math. Maaaring ang restart failure ay nawawalang handler, lipás na scene reference, o state na hindi kailanman na-reset.
Pagkatapos ng repair, subukan ang action mula sa higit sa isang kaugnay na state: unang launch, pagkatapos ng win, at pagkatapos ng loss kung naaangkop. Suriin kung may duplicate handler o stale object na lumilitaw lamang pagkatapos ng paulit-ulit na round. Mas mahusay na nami-mapa ng maliit na kumpletong miniflow ang lifecycle defect kaysa paulit-ulit na pagsubok sa button nang mag-isa.
Ihiwalay ang browser loading sa game logic
Para sa Godot web export, suriin ang browser network at console panel bago mag-edit ng gameplay code. Kumpirmahin na naglo-load ang exported HTML, JavaScript, WebAssembly, at game package mula sa nilalayong location. Ihambing ang hosting setting sa opisyal na web export documentation, kasama ang requirement ng piniling thread configuration.
Panatilihing pare-pareho ang filename ng exported companion at subukan ang artifact sa halip na halo ng luma at bagong file. Kung maling project ang lumilitaw, siyasatin ang service-worker caching sa test browser. Pagkatapos, subukan ang input at i-verify ang gumagalaw na content. Paunang rendering check lamang ang nonblank canvas, hindi patunay na gumagana ang game loop.
Suriin ang export-specific failure sa target
Kapag gumagana sa editor ngunit bumabagsak ang distributed build, ihambing ang startup scene selection, included resource, configuration, at target log. Panatilihin ang eksaktong artifact hash upang hindi ma-invalid ang reproduction record ng susunod na re-export. Subukan gamit ang malinis na starting state bago umasa sa existing save o editor cache.
Huwag baguhin ang core mechanic para lutasin ang nawawalang packaged file. Ayusin ang packaging boundary at ulitin ang parehong acceptance path sa target build. Para sa desktop artifact, gamitin ang aktuwal na operating system; para sa browser artifact, gamitin ang nilalayong browser at hosting setup. Hindi sapat ang cross-export para mapatunayan ang target behavior.
Isara ang repair gamit ang before-and-after result
Panatilihin ang nabigong reproduction, scoped diff, at paulit-ulit na action na ngayon ay lumilikha ng inaasahang state. Magdagdag ng regression check sa boundary na nagdulot ng defect, saka ulitin ang nakapaligid na game loop. Itala ang manual correction at request na nakonsumo ng mga nabigong repair.
Diagnostic procedure ang mga example dito, hindi published failure-and-fix case. Gamitin ang mga ito para gumawa ng konkretong report mula sa project mo. Kapag nananatili ang parehong symptom matapos ang paulit-ulit na proposal, ihinto ang automatic loop at kunin ang nawawalang observation sa halip na lumipat sa malawak na rewrite na walang bagong ebidensya.
Mga madalas itanong
Sinasabi ng agent na ayos na ang game, pero blank ang screen. Ano ang susunod?
I-reproduce ang symptom at suriin ang startup error, aktibong scene, camera, at input response. Hindi runtime observation ang completion message.
Dapat ko bang i-regenerate ang buong project?
Ihiwalay muna ang pinakamaagang nabigong boundary at panatilihin ang gumaganang state. Karaniwang mas madaling suriin ang focused reproduction kaysa replacement na nagbabago ng maraming system.
Bakit mas lumang game ang ipinapakita ng browser?
Suriin ang artifact identity, served file, at service-worker cache sa test browser. I-verify na aktuwal na nilo-load ang kasalukuyang export.
Pinatutunayan ba ng pumapasang script check na playable ang game?
Saklaw lamang nito ang mga check na isinagawa. Nangangailangan ng runtime evidence ang scene wiring, input, rendering, state transition, at persistence.
Ano ang dapat kasama sa kapaki-pakinabang na bug report?
Project at engine identity, target, step, inaasahan at naobserbahang state, unang kaugnay na error, at pinakamaliit na scene o file na kailangan para i-reproduce.