Godot AI game development

Edits سے پہلے project boundary define کریں

Owned project directory اور permitted changes کی written list سے شروع کریں۔ Existing scenes، scripts، assets اور plugins inventory کریں تاکہ agent دوسری implementation بنانے کے بجائے current structure بڑھائے۔ Initial project state recoverable رکھیں اور record کریں کہ کون سا engine binary اسے کھولتا ہے۔

Explicit transitions والا modest playable slice چنیں۔ مثلاً title screen سے ایک room، پھر win یا loss کے ذریعے واپس آنا repeatable test دیتا ہے۔ Visual composition اور controls کا reviewer پہلے طے کریں، کیونکہ successful parser یا model completion message experience کے coherent ہونے کا ثبوت نہیں۔

Executable اور supported arguments identify کریں

Godot کی stable CLI documentation نیچے والے commands دیتی ہے۔ GODOT_BIN اور PROJECT اس example کے shell variables ہیں، Godot settings نہیں؛ placeholder paths کو اپنی existing executable اور project سے بدلیں۔ Project path میں project.godot ہونا چاہیے۔

مزید flags script کرنے سے پہلے version اور help output capture کریں۔ اس سے installed build میں موجود نہ ہونے والے command کو فرض کرنے سے بچیں گے۔ Binary identity کو بعد کے test results کے ساتھ record کریں اور failure کی investigation میں اسے stable رکھیں۔ یہ illustrative commands documented CLI forms استعمال کرتی ہیں۔

GODOT_BIN="/absolute/path/to/godot"
PROJECT="/absolute/path/to/project"
"$GODOT_BIN" --version
"$GODOT_BIN" --help
"$GODOT_BIN" --headless --path "$PROJECT" --import

Import، parsing اور actual play الگ رکھیں

Headless import asset-processing boundary چیک کرتا ہے۔ Parser check script دیکھتا ہے۔ Normal launch game تک پہنچ کر scene wiring اور runtime problems دکھا سکتا ہے۔ Review record میں تینوں outcomes الگ رکھیں، انہیں ایک ہی passed tests summary نہ بنائیں۔

نیچے والا illustrative script path project میں پہلے سے موجود ہونا چاہیے۔ Parser check جان بوجھ کر narrow ہے: یہ working collisions، responsive input یا persistence ثابت نہیں کر سکتا۔ Edit کے بعد بدلے ہوئے behavior اور اس سے فوراً پہلے اور بعد والی transition دوبارہ چلائیں۔ یہ generated helper functions کے بہت سے isolated checks سے زیادہ informative ہو سکتا ہے۔

"$GODOT_BIN" --headless --path "$PROJECT" \
  --script res://scripts/player.gd --check-only
"$GODOT_BIN" --path "$PROJECT" --debug

CLI tools یا MCP سوچ سمجھ کر چنیں

Shell-capable agent reviewed CLI sequence چلا سکتا ہے۔ Godot MCP ایک additional project-maintained tool interface ہے، جس کا setup dedicated page پر ہے۔ دونوں صورتوں میں write یا process launch approve کرنے سے پہلے operator کو معلوم ہونا چاہیے کہ کون سا project target ہے۔

Agent کی model-provider settings کو engine tooling سے الگ رکھیں۔ Local connection چلنے سے کسی model کی availability یا compatible gateway کی ہر feature support ثابت نہیں ہوتی۔ پہلے smallest permitted read، پھر reversible scene change اور اس کے بعد authorized experiment میں complete gameplay cycle قائم کریں۔

Failures کو کافی scene context دیں

Interaction fail ہو تو متعلقہ scene tree، script، input action اور first meaningful runtime error capture کریں۔ Expected transition اور observed state واضح کریں۔ Player move نہیں کر رہا کی report میں focus، input detection اور player position بدلنے کی معلومات شامل ہونی چاہییں۔

چھوٹی proposed correction مانگیں جس کی explanation اسی evidence سے جڑی ہو۔ Apply کرنے کے بعد وہی action دوبارہ کریں اور restart اور scene transitions میں regression دیکھیں۔ صرف error ختم ہونے پر repair قبول نہ کریں؛ affected feature disable کرنے سے error مٹ سکتا ہے مگر requirement نامکمل رہتی ہے۔

Export prerequisites واضح طور پر تیار کریں

Export کے لیے matching preset اور installed export templates درکار ہیں۔ Build سے پہلے export_presets.cfg اور resource inclusion review کریں۔ Export credentials private رکھیں۔ Example میں preset name illustrative ہے اور project سے match ہونا چاہیے؛ output directory پہلے سے موجود ہو۔

Missing template یا preset کو environment problem سمجھیں، generated game logic کے غلط ہونے کا evidence نہیں۔ Export logs اور artifact hash محفوظ کریں تاکہ target findings مخصوص build سے جڑیں۔ Successful export اہم checkpoint ہے، مگر delivered player کے start یا round complete کرنے کا ثبوت نہیں۔

"$GODOT_BIN" --headless --path "$PROJECT" \
  --export-release "Windows Desktop" "/absolute/existing-build-dir/game.exe"

Target پر delivery miniflow چلائیں

Exported game اس operating system پر launch کریں جسے support کرنا ہے۔ Start، input، complete round، restart، settings اور relaunch کے بعد persistence test کریں۔ ہر result کے ساتھ artifact identity، device context اور outcome رکھیں۔ macOS پر بنایا export خود Windows behavior verify نہیں کرتا۔

Web target کے لیے browser loading اور runtime errors inspect کریں اور real input سے canvas exercise کریں۔ Content visible ہو اور مناسب جگہ حرکت کرے۔ Local editor run پر بھروسا کرنے کے بجائے intended hosting configuration میں resource loading اور platform restrictions test کریں۔

Inspect کرنے کے لیے source project اور native capture

Local Switchyard example three-room Godot puzzle، automated gameplay checks، save-reopen checks، raw logs، source ZIP اور Godot PCK فراہم کرتا ہے۔ اس کے native captures دو viewport sizes پر actual running project دکھاتے ہیں۔ Documented commands repeat کرنا صرف screenshot دیکھنے سے مضبوط check ہے۔

Project نے Godot 4.5.1 استعمال کیا، Codex run میں exact generation model verify نہیں ہوئی۔ اس لیے یہ local engine workflow ہے، Astra benchmark نہیں۔ Missing export templates نے browser export block کیا اور PCK standalone Windows executable نہیں ہے۔ یہ boundaries source کے ساتھ record ہیں تاکہ اگلا developer جان سکے کیا باقی ہے۔

Reviewable handoff کے ساتھ loop بند کریں

Handoff میں playable scope، source identity، engine اور template versions، build instructions، accepted results اور unresolved defects لکھیں۔ Tested artifact کے authentic captures اور shipped assets کی provenance شامل کریں۔ Repair attempts اور manual interventions محفوظ رکھیں؛ صرف final generated code dump پیش نہ کریں۔

Basic loop accepted ہو تو platform submission سے پہلے assets اور localization کو ان کے اپنے import اور gameplay checks سے گزاریں۔ یہ walkthrough engine documentation پر مبنی ہے؛ اپنی installed version پر apply کریں اور actual results رکھیں۔ Reproduction steps کے ساتھ مختصر unresolved-issues list رکھیں تاکہ اگلا session اسی known state سے شروع ہو۔

عمومی سوالات