Pengembangan game Godot dengan AI

Tentukan batas project sebelum edit

Mulai dari direktori project milik sendiri dan daftar perubahan yang diizinkan secara tertulis. Inventarisasi scene, script, aset, dan plugin yang ada agar agen memperluas struktur sekarang, bukan membuat implementasi kedua. Pertahankan keadaan awal project agar dapat dipulihkan dan catat binary engine yang membukanya.

Pilih potongan gameplay sederhana dengan transisi eksplisit. Misalnya, layar judul yang menuju satu ruangan lalu kembali melalui menang atau kalah memberi Anda tes yang dapat diulang. Tentukan siapa yang meninjau komposisi visual dan kontrol karena parser yang berhasil maupun pesan penyelesaian model tidak membuktikan pengalaman itu koheren.

Identifikasi executable dan argumen yang didukung

Dokumentasi CLI stabil Godot menyediakan perintah di bawah. GODOT_BIN dan PROJECT adalah variabel shell untuk contoh ini, bukan pengaturan Godot; ganti path placeholder dengan executable serta project yang ada. Path project harus berisi project.godot.

Ambil versi dan output bantuan sebelum membuat skrip dengan flag tambahan. Ini mencegah asumsi bahwa perintah di dokumentasi online terbaru ada di build terpasang. Catat identitas binary bersama hasil pengujian berikutnya dan pertahankan saat menyelidiki kegagalan. Perintah ilustratif ini menggunakan bentuk CLI terdokumentasi.

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

Pisahkan impor, parsing, dan permainan aktual

Impor headless memeriksa batas pemrosesan aset. Pemeriksaan parser menelaah script. Peluncuran normal mencapai game dan dapat mengungkap wiring scene serta masalah runtime. Simpan hasil tersebut secara terpisah dalam catatan peninjauan, bukan merangkum semuanya sebagai tes lulus.

Path script ilustratif di bawah harus sudah ada dalam project. Pemeriksaan parser sengaja sempit: tidak membuktikan collision bekerja, input responsif, atau persistensi benar. Setelah edit, ulangi perilaku yang berubah dan transisi tepat sebelum serta sesudahnya. Ini sering lebih informatif daripada membuat banyak pemeriksaan terisolasi untuk helper function yang dibuat.

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

Pilih alat CLI atau MCP secara sengaja

Agen yang memiliki shell dapat mengoperasikan rangkaian CLI yang telah ditinjau. Godot MCP adalah antarmuka alat tambahan yang dikelola project, dengan setup pada halaman khususnya. Dalam kedua kasus, operator harus mengetahui project target sebelum menyetujui penulisan atau peluncuran proses.

Pisahkan pengaturan provider model agen dari tooling engine. Koneksi lokal yang berfungsi tidak membuktikan model tertentu tersedia atau agen mendukung setiap fitur gateway kompatibel. Tetapkan pembacaan terkecil yang diizinkan terlebih dahulu, lalu perubahan scene yang dapat dibalik, dan baru siklus gameplay lengkap dalam eksperimen berotorisasi.

Berikan konteks scene yang cukup untuk kegagalan

Saat interaksi gagal, tangkap scene tree, script, input action, dan error runtime bermakna pertama. Jelaskan transisi yang diharapkan dan status yang diamati. Laporan bahwa player tidak dapat bergerak harus menyebut apakah game memiliki focus, apakah input terdeteksi, dan apakah posisi player berubah.

Minta koreksi kecil yang diusulkan dengan penjelasan terikat bukti tersebut. Setelah menerapkannya, ulangi aksi yang sama dan periksa regresi pada restart serta transisi scene. Jangan menerima perbaikan hanya karena error hilang; menonaktifkan fitur dapat menghapus error sambil meninggalkan persyaratan awal.

Siapkan prasyarat ekspor secara eksplisit

Ekspor memerlukan preset yang sesuai dan export template yang terinstal. Tinjau export_presets.cfg serta inklusi resource sebelum build. Jaga credential ekspor tetap privat. Nama preset contoh bersifat ilustratif dan harus cocok dengan project; direktori output harus sudah ada.

Perlakukan template atau preset yang hilang sebagai masalah lingkungan, bukan bukti bahwa logika game yang dibuat salah. Pertahankan log ekspor dan hash artefak agar temuan platform target merujuk build tertentu. Ekspor berhasil adalah checkpoint penting, tetapi tidak membuktikan player yang dikirim mulai atau menyelesaikan ronde.

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

Jalankan miniflow delivery pada target

Luncurkan game yang diekspor di sistem operasi yang ingin Anda dukung. Uji mulai, input, ronde lengkap, restart, pengaturan, dan persistensi setelah peluncuran ulang. Untuk setiap hasil, simpan identitas artefak, konteks perangkat, dan hasil yang diamati. Ekspor yang dibuat di macOS tidak membuktikan perilaku Windows.

Untuk target web, periksa pula loading browser dan error runtime serta gunakan input nyata pada canvas. Pastikan konten terlihat dan bergerak bila sesuai. Uji konfigurasi hosting yang dimaksud, jangan menganggap run editor lokal mencakup loading resource browser dan batasan platform.

Project sumber dan capture native untuk diperiksa

Contoh Switchyard lokal menyediakan puzzle Godot tiga ruangan, pemeriksaan gameplay otomatis, pemeriksaan buka ulang save, log mentah, ZIP sumber, dan PCK Godot. Capture native-nya menampilkan project yang benar-benar berjalan pada dua ukuran viewport. Mengulangi perintah terdokumentasi merupakan pemeriksaan yang lebih kuat daripada menilai project dari screenshot saja.

Project menggunakan Godot 4.5.1 dalam run Codex yang model generasinya tidak diverifikasi. Karena itu, contoh ini menunjukkan alur kerja engine lokal, bukan benchmark Astra. Ekspor browser terhalang template ekspor yang hilang dan PCK bukan executable Windows mandiri. Batas tersebut dicatat bersama source agar developer berikutnya mengetahui apa yang masih harus diuji.

Tutup loop dengan handoff yang dapat ditinjau

Handoff harus menyebut cakupan gameplay, identitas sumber, versi engine dan template, instruksi build, hasil yang diterima, serta cacat yang belum terselesaikan. Sertakan capture autentik dari artefak yang diuji dan provenance aset yang dikirim. Pertahankan percobaan perbaikan dan intervensi manual, bukan hanya dump kode generatif final.

Saat loop dasar diterima, tambahkan aset dan lokalisasi melalui pemeriksaan impor serta gameplay masing-masing sebelum mempertimbangkan pengiriman platform. Panduan ini berbasis dokumentasi engine; terapkan pada versi terpasang dan simpan hasil aktual. Pertahankan daftar masalah terbuka yang singkat dengan langkah reproduksi agar sesi pengembangan berikutnya dimulai dari status yang sama-sama diketahui.

Pertanyaan umum