Astra game development: Circuit Shift

نتیجہ: three-room مکمل gameplay loop

Circuit Shift ایک چھوٹا top-down puzzle game ہے جو macOS پر Godot 4.5.1 میں build اور test ہوا۔ آپ courier CS-07 کو تین relay-station rooms میں guide کرتے ہیں، ہر room میں تین energy cells جمع کرتے ہیں، numbered gates کھولتے ہیں، moving sentries سے بچتے ہیں اور exit تک پہنچتے ہیں۔ Final automated native run نے تینوں rooms مکمل کیے، loss اور restart exercise کیا، campaign progress اور best times save کیے، اور الگ process نے وہ save کامیابی سے reopen کیا۔

AI-assisted game project کے لیے مفید سبق bounded brief، engine-driven gameplay checks اور visual inspection کا مجموعہ ہے۔ Complete small loop مانگنے سے صرف movement نہیں بلکہ sealed exit، room completion سے اگلا sector unlock اور relaunch کے بعد settings بھی test ہوئیں۔ Downloadable project سے آپ ان behaviors کو خود inspect کر سکتے ہیں۔

Initial brief نے completion کو concrete بنایا

Task میں Circuit Shift نام کا original game، تین short levels، engine physics، switches and gates، collectible cells، win/loss/restart، start menu، settings اور saved progress شامل تھے۔ اس میں authentic screenshots، real-engine gameplay miniflow اور saved-state reopen بھی لازم تھے۔ Godot 4.5.1 پہلے سے installed تھا اور دوبارہ استعمال ہوا؛ development نئے game directory اور الگ temporary HOME سے شروع ہوئی۔

نیچے actual initial brief کا excerpt ہے؛ readability کے لیے line breaks ہیں اور original wording محفوظ ہے۔ مکمل initial-prompt.txt source ZIP میں شامل ہے۔ اپنے brief کے لیے سب سے قابل انتقال حصہ observable completion criteria ہے: player کیا کر سکتا ہے اور game بند کرنے کے بعد کیا کام کرتا رہنا چاہیے، یہ واضح لکھیں۔

Task: build an original polished small 2D Godot game called Circuit Shift.
Three short levels; controllable character, enginephysics/collisions,
switches and gates, collectible cells, exit, win/loss/restart,
start menu, smallsettings and savedprogress.

Prompt سے files، engine feedback اور working rooms تک

Agent نے room data، GDScript، menus، settings، local saves اور gameplay harness لکھے، پھر engine بار بار چلایا اور results inspect کیے۔ Movement CharacterBody2D.move_and_slide استعمال کرتی ہے؛ walls اور gates StaticBody2D ہیں؛ cells، hazards اور exits Area2D triggers استعمال کرتے ہیں۔ یہ engine contracts visible room کو collision اور state changes سے جوڑتے ہیں جنہیں harness observe کر سکتا ہے۔

Record میں import، gameplay، regression checks، native capture، reopening، packaging اور pixel inspection سمیت 13 game-engine runs ہیں۔ Sequence میں implementation سے پہلے initial scene-presence failure، headless gameplay، native screenshots، focused visual repair اور final artifact checks شامل تھے۔ Game artwork Godot CanvasItem code سے procedurally draw ہوا اور پانچ PCM sound effects local synthesize ہوئے۔ Observed work agent-authored patches، local commands، native-execution permission requests اور screenshot inspection پر مشتمل تھا؛ مزید human task steering یا human code repair observe نہیں ہوئی۔

اصل defect: keyboard focus نے button پڑھنا مشکل بنا دیا

پہلی native gameplay run نے assertions pass کیں، مگر screenshot inspection نے focused primary button پر low-contrast text دکھایا۔ یہ اہم تھا کیونکہ station menu keyboard navigation بھی support کرتا ہے: working start action readable start control کی ضمانت نہیں تھی۔ Targeted regression check پھر تقریباً 1.36:1 contrast ratio کے ساتھ fail ہوا۔

Repair نے font_focus_color کو primary button کے dark foreground پر explicitly set کیا۔ اگلی check نے تقریباً 10.57:1 measure کیا اور final native run نے passing contrast assertion برقرار رکھی۔ Raw failed اور successful outputs evidence directory میں محفوظ ہیں۔ Gameplay tests کے ساتھ focused اور selected UI states inspect کرنے کی یہ عملی وجہ ہے: state transitions درست ہو سکتی ہیں جبکہ انہیں دکھانے والے controls میں defect رہ سکتا ہے۔

Native tests نے حقیقتاً کیا exercise کیا

Final gameplay miniflow نے normal Godot Input actions اور native Control signals چلائے؛ ایک mapping check نے InputEventKey submit کیا۔ Courier engine physics سے حرکت کرتا رہا۔ Harness نے wall collision، closed-gate blocking، relay opening/closing، all-cell exit requirement، تین room wins، hazard loss، restart، pause، settings اور sound-generation/playback triggers چیک کیے۔ Player کو teleport نہیں کیا گیا، cells براہ راست award نہیں ہوئے اور win state assign نہیں کی گئی۔

نیچے کے counts ان flows کے اندر assertions ہیں، جن میں waypoints اور captures بھی شامل ہیں؛ یہ independent benchmark tasks نہیں ہیں۔ تینوں final native runs empty stderr کے ساتھ کامیاب exit ہوئیں۔ Source gameplay campaign سب سے وسیع test ہے؛ PCK run pack loading اور saved-state continuation ثابت کرتی ہے، packaged game میں دوسری full campaign نہیں۔

Reopening نے persistence اور compact layout test کیا

Fresh native process نے unlocked=3، completed=true، تین positive best times، volume=0.35 اور reduced_motion=true load کیا۔ Continue نے sector three کھولا۔ اس سے persistence اس value سے الگ ثابت ہوتی ہے جو game چلتے وقت صرف memory میں رہتی ہے۔ Game room completion پر progress save کرتا ہے، اس لیے intended resume point room ہے، courier کی آخری position نہیں۔

Compact run نے دوسرا layout check بھی دیا: 720 x 540 پر room، HUD، timer اور controls مکمل frame میں رہے۔ Desktop captures 1280 x 960 ہیں۔ Final source اور pack runs میں بارہ native captures نے nonblank pixel sampling pass کی اور visual inspection نے framing اور readability چیک کی۔ یہ genuine native viewport captures ہیں؛ چھوٹی image compact desktop window دکھاتی ہے۔

Timing اور configuration: run record کیسے پڑھیں

Requested start September 5, 2026 at 05:35:51 UTC تھا؛ completion 06:00:11.007 UTC پر record ہوئی۔ یہ 1,460.007 seconds، تقریباً 24 minutes 20 seconds elapsed wall time ہے۔ اس میں implementation، tool execution، tests، repairs، capture اور packaging شامل ہیں، جبکہ engine پہلے سے available تھا۔ یہ model response latency یا کسی دوسری game کے development time کی forecast نہیں ہے۔ ایک initial task brief سے کئی implementation اور tool iterations نکلیں۔

یہ Astra-configured Codex run ہے: coordinator نے spawn_agent.model=gpt-6-astra اور reasoning_effort=xhigh record کیا۔ یہ صرف requested configuration ثابت کرتا ہے۔ API response model identity، token usage، cost اور model/API-call counts exposed نہیں ہوئے اور run-summary.json میں null ہیں؛ کوئی direct APIsRouter request یا billing observe نہیں ہوئی۔ 5 ستمبر کی public-catalog check میں بھی APIsRouter پر Astra listing نہیں ملی۔ Official model documentation اور local configuration gateway access ثابت نہیں کرتے۔

Circuit Shift کو Godot میں download اور run کریں

Implementation، complete brief، controls، test harness اور preserved evidence inspect کرنے کے لیے source ZIP download کریں۔ اسے extract کریں، Godot 4.5.1 میں game/project.godot import کریں اور project run کریں۔ WASD یا arrow keys سے move کریں، nearby relay کو E یا Space سے operate کریں، R سے restart اور Escape سے pause کریں۔ Exit activate کرنے کے لیے ہر cell جمع کریں؛ sentry سے contact attempt ختم کر دیتا ہے۔

Packed version کے لیے circuit-shift.pck download کریں اور compatible Godot runtime کے ساتھ نیچے والا command استعمال کریں۔ PCK کو Godot درکار ہے اور یہ standalone executable نہیں ہے۔ ZIP integrity، critical archived-file equality، final native run کے ساتھ source equality اور copied-asset SHA-256 equality verify ہو چکی ہے۔ PCK کو source project سے باہر temporary directory سے launch کیا گیا۔ دونوں artifacts، run-summary.json اور SHA-256 manifest کے download links نیچے درج ہیں۔

godot --main-pack circuit-shift.pck

یہ prototype اگلے کس کام کے لیے تیار ہے

اگلا مفید قدم تین-room loop کا human playtest ہے: کیا نیا player relay numbering سمجھتا ہے، دیکھتا ہے کہ exit کیوں sealed ہے، اور loss کے بعد recover کر سکتا ہے؟ اس case میں human playtest، listening test یا real-user usage data جمع نہیں ہوا۔ Automated completion اور generated audio buffers functional paths ثابت کرتے ہیں؛ enjoyment، difficulty balance، sound quality، retention یا broad usability نہیں۔

Windows، browser، Steam، touch اور gamepad untested ہیں؛ browser export templates local طور پر available نہیں تھے۔ Accelerated headless runs نے macOS certificate diagnostics اور audio-resource shutdown warnings بھی دیں، اگرچہ final native logs کا stderr empty تھا۔ Release target منتخب کرنے سے پہلے متعلقہ runtime issues address کریں اور اس target کے اپنے input، save، packaging اور performance checks چلائیں۔ یہاں کا عملی نتیجہ inspectable native prototype اور repeatable verification workflow ہے۔

عمومی سوالات