Astra ile oyun geliştirme: Circuit Shift

Sonuç: eksiksiz üç odalı oynanış döngüsü

Circuit Shift, macOS üzerinde Godot 4.5.1 ile oluşturulup test edilmiş küçük bir yukarıdan görünümlü bulmaca oyunudur. Kurye CS-07'yi üç röle istasyonu odasında yönlendirir, her odada üç enerji hücresi toplar, numaralı kapıları açar, hareketli nöbetçilerden kaçınır ve çıkışa ulaşırsınız. Son otomatik yerel koşu üç odayı tamamladı, kaybetme ve yeniden başlama durumlarını çalıştırdı, kampanya ilerlemesini ve en iyi süreleri kaydetti. Ayrı bir işlem bu kaydı başarıyla yeniden açtı.

Yapay zekâ destekli bir oyun projesi için yararlı sonuç, sınırlı bir özetin, motor güdümlü oynanış kontrollerinin ve görsel incelemenin birleşimidir. Küçük ama eksiksiz bir döngü istemek yalnızca hareketi değil, daha fazlasını test etmeyi mümkün kıldı: çıkış toplama öncesinde kapalı kalmalı, oda tamamlanması sonraki sektörü açmalı ve ayarlar yeniden başlatmadan sonra korunmalıydı. İndirilebilir proje bu davranışları kendiniz incelemenize izin verir.

İlk özet tamamlanmayı somutlaştırdı

Görev; Circuit Shift adlı özgün bir oyun, üç kısa seviye, motor fiziği, anahtarlar ve kapılar, toplanabilir hücreler, kazanma/kaybetme/yeniden başlama, başlangıç menüsü, ayarlar ve kaydedilmiş ilerleme belirtti. Ayrıca gerçek ekran görüntüleri, gerçek motorla oynanış mini akışı ve kaydedilmiş durumun yeniden açılması istendi. Godot 4.5.1 zaten kuruluydu ve yeniden kullanıldı; geliştirme ayrı bir geçici HOME ile yeni bir oyun dizininde başladı.

Aşağıdaki parça, okunabilirlik için satır sonları eklenmiş gerçek ilk özetten alınmıştır ve özgün ifadesini korur. Eksiksiz initial-prompt.txt kaynak ZIP'ine dahil edilmiştir. Eksiksiz özetiniz için en taşınabilir bölüm gözlemlenebilir tamamlanma ölçütleridir: oyuncunun ne yapabildiğini ve oyun kapatıldıktan sonra neyin hâlâ çalışması gerektiğini belirtin.

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.

İstemden dosyalara, motor geri bildirimine ve çalışan odalara

Ajan oda verilerini, GDScript'i, menüleri, ayarları, yerel kayıtları ve bir oynanış harness'ini yazdı; ardından motoru tekrar tekrar çalıştırıp sonuçları inceledi. Hareket CharacterBody2D.move_and_slide kullanır; duvarlar ve kapılar StaticBody2D kullanır; hücreler, tehlikeler ve çıkışlar Area2D tetikleyicileridir. Bu motor sözleşmeleri görünen odayı harness'in gözlemleyebildiği çarpışma ve durum değişikliklerine bağlar.

Kayıt, içe aktarma, oynanış, regresyon kontrolleri, yerel yakalama, yeniden açma, paketleme ve piksel incelemesi boyunca 13 oyun motoru çalışması içerir. Sıra; uygulama öncesinde ilk bir sahne varlığı başarısızlığını, başsız oynanışı, yerel ekran görüntülerini, odaklanmış bir görsel düzeltmeyi ve son varlık kontrollerini içerdi. Oyuna özgü sanat Godot CanvasItem koduyla prosedürel çizildi, beş PCM ses efekti yerel olarak sentezlendi. Gözlenen çalışma ajan yamalarından, yerel komutlardan, yerel yürütme izin taleplerinden ve ekran görüntüsü incelemesinden oluştu; başka insan görev yönlendirmesi veya insan kod onarımı gözlemlenmedi.

Gerçek kusur: klavye odağı bir düğmenin okunmasını zorlaştırdı

İlk yerel oynanış koşusu iddialarını geçti, ancak ekran görüntüsü incelemesi odaklanmış birincil düğmede düşük kontrastlı metin gösterdi. Bu önemliydi çünkü istasyon menüsü klavye gezinmesini de destekler: çalışan bir başlat eylemi okunabilir bir başlat kontrolünü garanti etmez. Hedefli bir regresyon kontrolü yaklaşık 1.36:1 kontrast oranıyla başarısız oldu.

Düzeltme font_focus_color değerini birincil düğmenin koyu ön planına açıkça ayarladı. Sonraki kontrolde yaklaşık 10.57:1 ölçüldü ve son yerel koşu geçen kontrast iddiasını korudu. Ham başarısız ve başarılı çıktılar kanıt dizininde tutuluyor. Bu, oynanış testlerini odaklanmış ve seçilmiş arayüz durumlarının incelemesiyle eşleştirmek için somut bir nedendir: durum geçişleri doğru olabilirken onları gösteren kontroller hâlâ sorunlu olabilir.

Yerel testlerin gerçekten çalıştırdığı şeyler

Son oynanış mini akışı normal Godot Input eylemlerini ve yerel Control sinyallerini çalıştırdı; bir eşleme kontrolü InputEventKey gönderdi. Kurye motorun fiziğiyle hareket etti. Harness duvar çarpışmasını, kapalı kapı engelini, röle açma ve kapanmasını, tüm hücreler için çıkış gereksinimini, üç oda kazanımını, tehlike kaybını, yeniden başlamayı, duraklatmayı, ayarları ve ses üretimi/oynatma tetikleyicilerini kontrol etti. Oyuncuyu ışınlamadı, hücreleri doğrudan vermedi veya kazanma durumu atamadı.

Aşağıdaki sayılar bağımsız karşılaştırma görevleri değil; ara noktalar ve yakalamalar dahil bu akışlardaki iddialardır. Son üç yerel koşunun tümü boş stderr ile başarıyla çıktı. Kaynak oynanış kampanyası en geniş testtir; PCK koşusu paket yüklemeyi ve kaydedilmiş durumun sürdürülmesini kanıtlar, paketlenmiş oyunda ikinci bir tam kampanyayı değil.

Yeniden açma kalıcılığı ve kompakt düzeni test etti

Yeni bir yerel işlem unlocked=3, completed=true, üç pozitif en iyi süre, volume=0.35 ve reduced_motion=true değerlerini yükledi. Continue üçüncü sektöre girdi. Bu, kalıcılığı oyun çalışırken bellekte kalan bir değerden ayırır. Oyun ilerlemeyi oda tamamlanınca kaydettiğinden amaçlanan devam noktası kuryenin son konumu değil, bir odadır.

Kompakt koşu ikinci bir düzen kontrolü de sağladı: oda, HUD, zamanlayıcı ve kontroller 720 x 540 boyutunda tamamen çerçevelenmiş kaldı. Masaüstü yakalamaları 1280 x 960'tır. Son kaynak ve paket koşuları boyunca on iki yerel yakalama boş olmayan piksel örneklemesini geçti; görsel inceleme çerçeveyi ve okunabilirliği kontrol etti. Bunlar gerçek yerel görünüm yakalamalarıdır; küçük görüntü kompakt masaüstü penceresini gösterir.

Zamanlama ve yapılandırma: koşu kaydı nasıl okunur

İstenen başlangıç 5 Eylül 2026'da 05:35:51 UTC, tamamlanma 06:00:11.007 UTC olarak kaydedildi. Bu 1,460.007 saniye, yaklaşık 24 dakika 20 saniye geçen duvar saatidir. Mevcut bir motorun kullanılabildiği ortamda uygulamayı, araç yürütmesini, testleri, onarımları, yakalamayı ve paketlemeyi kapsar. Model yanıt gecikmesi veya başka bir oyunun geliştirme süresi tahmini değildir. Tek bir ilk görev özeti birden fazla uygulama ve araç iterasyonuna yol açtı.

Bu, Astra yapılandırmalı bir Codex çalışmasıdır: koordinatör spawn_agent.model=gpt-6-astra ve reasoning_effort=xhigh kaydetti. Bu yalnızca istenen yapılandırmayı kurar. API yanıt modelinin kimliği, token kullanımı, maliyet ve model/API çağrısı sayıları açığa çıkmadı ve run-summary.json içinde null kaldı; doğrudan APIsRouter isteği veya faturalandırma gözlemlenmedi. 5 Eylül kamu kataloğu kontrolünde de APIsRouter'da Astra listesi bulunmadı. Resmî model dokümantasyonu ve bu yerel yapılandırma ağ geçidi erişimini kanıtlamaz.

Circuit Shift'i Godot'ta indirin ve çalıştırın

Uygulamayı, eksiksiz özeti, kontrolleri, test harness'ini ve korunan kanıtı incelemek için kaynak ZIP'ini indirin. ZIP'i çıkarın, game/project.godot dosyasını Godot 4.5.1'e içe aktarın ve projeyi çalıştırın. WASD veya ok tuşlarıyla hareket edin, yakındaki bir röleyi E veya Space ile çalıştırın, R ile yeniden başlayın ve Escape ile duraklatın. Çıkışın etkinleşmesi için tüm hücreleri toplayın; bir nöbetçiye temas denemeyi bitirir.

Paketlenmiş sürüm için circuit-shift.pck dosyasını indirin ve aşağıdaki komutla uyumlu bir Godot çalışma zamanında başlatın. PCK Godot gerektirir ve bağımsız bir çalıştırılabilir değildir. ZIP bütünlüğü, kritik arşiv dosyası eşitliği, son yerel koşuya göre kaynak eşitliği ve kopyalanmış varlık SHA-256 eşitliği doğrulandı. PCK, kaynak projenin dışındaki geçici bir dizinden başlatıldı. Her iki varlık için indirme bağlantıları, run-summary.json ve SHA-256 manifesti aşağıda listelenmiştir.

godot --main-pack circuit-shift.pck

Bu prototipin sonraki adıma hazır olduğu şeyler

Sonraki yararlı adım üç odalı döngünün insan oyun testidir: yeni bir oyuncu röle numaralarını anlayabiliyor mu, çıkışın neden mühürlü olduğunu fark ediyor mu ve kayıptan sonra toparlanabiliyor mu? Bu vakada insan oyun testi, dinleme testi veya gerçek kullanıcı verisi toplanmadı. Otomatik tamamlanma ve üretilmiş ses tamponları işlevsel yolları kanıtlar; keyfi, zorluk dengesi, ses kalitesi, elde tutma veya geniş kullanılabilirliği kanıtlamaz.

Windows, tarayıcı, Steam, dokunma ve oyun kumandası test edilmedi; tarayıcı dışa aktarma şablonları yerel olarak yoktu. Hızlandırılmış başsız koşular macOS sertifika tanılarını ve ses kaynağı kapanış uyarılarını yine üretti, ancak son yerel günlüklerde stderr boştu. Bir yayım hedefi seçmeden önce ilgili çalışma zamanı sorunlarını giderin ve o hedefin kendi girdi, kayıt, paketleme ve performans kontrollerini çalıştırın. Buradaki pratik sonuç incelenebilir bir yerel prototip ve sonraki geliştirme turuna yön verecek tekrarlanabilir bir doğrulama iş akışıdır.

Sık sorulan sorular