Astra game development: Circuit Shift

Result: একটি complete three-room gameplay loop

Circuit Shift হলো macOS-এ Godot 4.5.1 দিয়ে build ও test করা একটি ছোট top-down puzzle game। Courier CS-07-কে তিনটি relay-station room-এর মধ্যে নিয়ে যান, প্রতিটি room-এ তিনটি energy cell collect করুন, numbered gate খুলুন, moving sentry এড়িয়ে exit-এ পৌঁছান। Final automated native run তিনটি room complete করেছে, loss ও restart exercise করেছে এবং campaign progress ও best time save করেছে। Separate process সেই save সফলভাবে reopen করেছে।

AI-assisted game project-এর জন্য ব্যবহারিক takeaway হলো bounded brief, engine-driven gameplay check ও visual inspection-এর combination। Complete ছোট loop চাইলে movement-এর চেয়েও বেশি test করা যায়: collection-এর আগে exit sealed থাকতে হবে, room completion পরের sector unlock করবে এবং relaunch-এর পর setting টিকে থাকবে। Downloadable project-এ আপনি নিজে এই behavior inspect করতে পারবেন।

Initial brief completion-কে concrete করেছিল

Task-এ Circuit Shift নামের original game, তিনটি short level, engine physics, switch ও gate, collectible cell, win/loss/restart, start menu, setting ও saved progress specify করা হয়েছিল। Authentic screenshot, real-engine gameplay miniflow ও saved-state reopen-ও required ছিল। Godot 4.5.1 আগে থেকেই installed ছিল এবং reuse করা হয়েছে; separate temporary HOME-সহ নতুন game directory-তে development শুরু হয়।

নিচের snippet actual initial brief-এর excerpt, readability-র জন্য line break যোগ করা এবং original wording অক্ষুণ্ণ রাখা হয়েছে। Complete initial-prompt.txt source ZIP-এ আছে। নিজের brief-এর জন্য সবচেয়ে transferable অংশ observable completion criteria: player কী করতে পারে এবং game বন্ধ করার পরও কী কাজ করতে হবে তা specify করুন।

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 থেকে file, engine feedback ও working room পর্যন্ত

Agent room data, GDScript, menu, setting, local save ও gameplay harness লিখেছে, তারপর বারবার engine run করে result inspect করেছে। Movement CharacterBody2D.move_and_slide ব্যবহার করে; wall ও gate StaticBody2D; cell, hazard ও exit Area2D trigger। এই engine contract-গুলো visible room-কে harness যে collision ও state change observe করতে পারে তার সঙ্গে যুক্ত করে।

Record-এ import, gameplay, regression check, native capture, reopen, packaging ও pixel inspection মিলিয়ে 13টি game-engine run আছে। Sequence-এ implementation-এর আগে initial scene-presence failure, headless gameplay, native screenshot, focused visual repair এবং final artifact check ছিল। Game-specific artwork Godot CanvasItem code দিয়ে procedurally আঁকা হয়েছে এবং পাঁচটি PCM sound effect locally synthesize করা হয়েছে। Observed work ছিল agent-authored patch, local command, native-execution permission request ও screenshot inspection; অতিরিক্ত human task steering বা human code repair দেখা যায়নি।

বাস্তব defect: keyboard focus button পড়া কঠিন করেছিল

প্রথম native gameplay run assertion pass করেছিল, কিন্তু screenshot inspection focused primary button-এর low-contrast text প্রকাশ করে। এটি গুরুত্বপূর্ণ, কারণ station menu keyboard navigation-ও support করে: start action কাজ করলেই readable start control নিশ্চিত হয় না। Targeted regression check-এ পরে contrast ratio আনুমানিক 1.36:1-এ fail করে।

Repair-এ font_focus_color-কে primary button-এর dark foreground হিসেবে explicit set করা হয়। পরের check আনুমানিক 10.57:1 মাপে এবং final native run passing contrast assertion ধরে রাখে। Raw failed ও successful output evidence directory-তে আছে। Focused ও selected UI state inspection-এর সঙ্গে gameplay test জোড়ার বাস্তব কারণ এটি: state transition সঠিক হলেও যে control তা প্রকাশ করে তার আরও কাজ লাগতে পারে।

Native test আসলে কী exercise করেছে

Final gameplay miniflow normal Godot Input action ও native Control signal চালিয়েছে; একটি mapping check InputEventKey submit করেছে। Courier engine-এর physics-এর মধ্য দিয়ে চলেছে। Harness wall collision, closed-gate blocking, relay open ও close, all-cell exit requirement, তিনটি room win, hazard loss, restart, pause, setting এবং sound-generation/playback trigger check করেছে। Player teleport, সরাসরি cell award বা win state assign করা হয়নি।

নিচের count-গুলো এই flow-এর assertion, waypoint ও capture-সহ; independent benchmark task নয়। তিনটি final native run 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 time, volume=0.35 এবং reduced_motion=true load করেছে। Continue sector three-এ ঢুকেছে। এতে game চলার সময় memory-তে value থেকে যাওয়া এবং persistence আলাদা হয়। Room completion-এ game progress save করে, তাই intended resume point হলো room, courier-এর শেষ position নয়।

Compact run দ্বিতীয় layout check দিয়েছে: 720 x 540-এ room, HUD, timer ও control পুরো frame-এ ছিল। Desktop capture 1280 x 960। Final source ও pack run মিলিয়ে twelve native capture nonblank pixel sampling pass করেছে এবং visual inspection framing ও readability check করেছে। এগুলো genuine native viewport capture; ছোট image compact desktop window দেখায়।

Timing ও configuration: run record কীভাবে পড়বেন

Requested start September 5, 2026 at 05:35:51 UTC; completion recorded at 06:00:11.007 UTC। এটি 1,460.007 seconds, প্রায় 24 minutes 20 seconds elapsed wall time। Existing engine available থাকা অবস্থায় implementation, tool execution, test, repair, capture ও packaging জুড়ে সময়টি লেগেছে। এটি model response latency নয় বা অন্য game-এর development time forecast নয়। একটি initial task brief থেকে বহু implementation ও tool iteration হয়েছে।

এটি Astra-configured Codex run: coordinator spawn_agent.model=gpt-6-astra এবং reasoning_effort=xhigh record করেছে। এটি কেবল requested configuration establish করে। API response model identity, token usage, cost ও model/API-call count exposed হয়নি এবং run-summary.json file-এ null আছে; কোনো direct APIsRouter request বা billing observe করা হয়নি। September 5 public-catalog check-এ APIsRouter-এ Astra listing-ও পাওয়া যায়নি। Official model documentation ও local configuration gateway access establish করে না।

Godot-এ Circuit Shift download ও run করুন

Implementation, complete brief, control, test harness ও preserved evidence inspect করতে source ZIP download করুন। Extract করে Godot 4.5.1-এ game/project.godot import করুন এবং project run করুন। WASD বা arrow key দিয়ে move, কাছের relay E বা Space দিয়ে operate, R দিয়ে restart এবং Escape দিয়ে pause করুন। Exit activate করতে সব cell collect করুন; sentry-র সঙ্গে contact attempt শেষ করে।

Packed version-এর জন্য circuit-shift.pck download করে নিচের command দিয়ে compatible Godot runtime-এ launch করুন। PCK-এর জন্য Godot দরকার এবং এটি standalone executable নয়। ZIP integrity, critical archived-file equality, final native run-এর বিরুদ্ধে source equality ও copied-asset SHA-256 equality verify করা হয়েছে। Source project-এর বাইরের temporary directory থেকে PCK launch করা হয়েছিল। দুই artifact, run-summary.json ও SHA-256 manifest-এর download link নিচে আছে।

godot --main-pack circuit-shift.pck

এই prototype-এর পরের প্রস্তুত step

পরের useful step হলো three-room loop-এর human playtest: নতুন player relay numbering বোঝে কি না, exit কেন sealed তা notice করে কি না এবং loss থেকে recover করতে পারে কি না। এই case-এ কোনো human playtest, listening test বা real-user usage data collect করা হয়নি। Automated completion ও generated audio buffer functional path establish করে; enjoyment, difficulty balance, sound quality, retention বা broad usability establish করে না।

Windows, browser, Steam, touch ও gamepad untested; browser export template locally unavailable ছিল। Accelerated headless run-এ macOS certificate diagnostic ও audio-resource shutdown warning এসেছে, যদিও final native log-এর stderr empty ছিল। Release target বেছে নেওয়ার আগে relevant runtime issue address করুন এবং target-এর নিজস্ব input, save, packaging ও performance check চালান। Practical result হলো inspectable native prototype এবং repeatable verification workflow, যা পরের development round guide করতে পারে।

সাধারণ প্রশ্ন