Phát triển game Godot bằng AI

Updated 2026-09-05

Dùng phản hồi CLI Godot để đi từ chỉnh sửa project tới vòng lặp có thể chơi và bản xuất đã kiểm thử. Kiểm tra import, hành vi scene và đóng gói như các bước riêng.

Định nghĩa ranh giới project trước khi sửa

Bắt đầu từ thư mục project sở hữu và danh sách thay đổi được phép đã viết. Lập inventory cảnh, script, tài nguyên và plugin hiện có để agent mở rộng cấu trúc hiện tại thay vì tạo triển khai thứ hai. Giữ trạng thái project ban đầu có thể khôi phục và ghi binary engine nào mở nó.

Chọn lát cắt có thể chơi vừa phải với chuyển tiếp rõ. Ví dụ, màn hình tiêu đề dẫn tới một phòng rồi quay lại qua thắng hoặc thua cho bạn kiểm tra lặp lại. Quyết định ai rà soát bố cục trực quan và điều khiển, vì parser thành công hay message hoàn tất của model đều không chứng minh trải nghiệm mạch lạc.

Brief game dẫn tới thay đổi có thể rà soát, thực thi engine, rà soát gameplay và kiểm tra xuất đích.
Dùng vòng lặp để tách phản hồi engine khỏi kết quả có thể chơi và đã xuất.

Xác định executable và argument được hỗ trợ

Tài liệu CLI ổn định của Godot cung cấp các lệnh bên dưới. GODOT_BIN và PROJECT là biến shell được chọn cho ví dụ, không phải cài đặt Godot; thay path placeholder bằng executable và project hiện có. Path project phải chứa project.godot.

Chụp version và output help trước khi viết thêm flag. Điều này tránh giả định lệnh có trong tài liệu online hiện tại tồn tại trong build đã cài. Ghi danh tính binary cùng kết quả test sau và giữ ổn định khi điều tra lỗi. Các lệnh minh họa dùng dạng CLI được ghi nhận.

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

Tách import, parse và chơi thực

Import headless kiểm tra ranh giới xử lý tài nguyên. Kiểm tra parser xem xét script. Khởi chạy bình thường tới game và có thể bộc lộ wiring scene cùng vấn đề runtime. Giữ các kết quả riêng trong hồ sơ rà soát thay vì tóm tắt cả ba là test đạt.

Path script minh họa bên dưới phải tồn tại trong project. Kiểm tra parser có phạm vi hẹp: không xác lập va chạm hoạt động, input phản hồi hay persistence đúng. Sau chỉnh sửa, chạy lại hành vi nó thay đổi và chuyển tiếp ngay trước cùng sau. Cách này thường nhiều thông tin hơn tạo nhiều kiểm tra riêng cho helper function.

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

Chọn CLI hoặc MCP có chủ ý

Agent có shell có thể vận hành chuỗi CLI đã rà soát. Godot MCP là giao diện công cụ do project duy trì bổ sung, được thiết lập ở trang riêng. Trong cả hai trường hợp, người vận hành phải biết project nào được nhắm trước khi duyệt ghi hoặc chạy process.

Giữ cài đặt provider model của agent riêng với tooling engine. Kết nối local hoạt động không chứng minh model cụ thể khả dụng hay agent hỗ trợ mọi tính năng gateway tương thích. Xác lập lượt đọc được phép nhỏ nhất trước, rồi thay đổi scene có thể hoàn tác và chỉ sau đó chạy chu kỳ gameplay đầy đủ trong thí nghiệm được ủy quyền.

Cung cấp đủ ngữ cảnh scene cho lỗi

Khi tương tác thất bại, chụp scene tree, script, input action và lỗi runtime có ý nghĩa đầu tiên. Giải thích chuyển tiếp dự kiến và trạng thái quan sát. Báo cáo rằng người chơi không di chuyển phải nói game có focus không, input có được phát hiện không và vị trí player có thay đổi không.

Yêu cầu sửa đề xuất nhỏ với giải thích gắn bằng chứng. Sau khi áp dụng, lặp hành động và kiểm tra hồi quy ở restart cùng chuyển tiếp scene. Đừng chấp nhận sửa chỉ vì lỗi biến mất; vô hiệu tính năng có thể xóa lỗi mà vẫn không đáp ứng yêu cầu gốc.

Chuẩn bị điều kiện xuất rõ ràng

Xuất cần preset tương ứng và export template đã cài. Rà soát export_presets.cfg cùng việc bao gồm tài nguyên trước khi build. Giữ credential xuất riêng tư. Tên preset trong ví dụ chỉ minh họa và phải khớp project; thư mục output phải tồn tại.

Coi template hoặc preset thiếu là vấn đề môi trường, không phải bằng chứng logic game tạo sai. Giữ log xuất và hash artifact để phát hiện nền tảng đích gắn với build cụ thể. Xuất thành công là checkpoint quan trọng nhưng không chứng minh player bàn giao khởi động hay hoàn tất vòng.

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

Chạy miniflow bàn giao trên đích

Chạy game đã xuất trong hệ điều hành dự định hỗ trợ. Kiểm tra bắt đầu, input, vòng hoàn chỉnh, restart, cài đặt và persistence sau khi mở lại. Với mỗi kết quả, giữ danh tính artifact, ngữ cảnh thiết bị và kết quả quan sát. Bản xuất trên macOS không tự xác minh hành vi Windows.

Với đích web, kiểm tra thêm tải browser và lỗi runtime, rồi dùng input thực để thao tác canvas. Xác minh nội dung hiển thị và di chuyển khi phù hợp. Kiểm thử cấu hình hosting dự kiến thay vì cho rằng lần chạy editor local bao phủ tải tài nguyên browser và hạn chế nền tảng.

Một project nguồn và ảnh chụp native để kiểm tra

Ví dụ Switchyard local cung cấp puzzle Godot ba phòng, kiểm tra gameplay tự động, kiểm tra mở lại file lưu, log thô, ZIP mã nguồn và PCK Godot. Ảnh native cho thấy project đang chạy thực ở hai kích thước viewport. Lặp lệnh có tài liệu là kiểm tra mạnh hơn phán đoán chỉ từ ảnh.

Project dùng Godot 4.5.1 trong lần chạy Codex có model tạo chính xác chưa xác minh. Vì vậy nó minh họa workflow engine local, không phải benchmark Astra. Xuất browser bị chặn vì thiếu template và PCK không phải executable Windows độc lập. Các ranh giới này được ghi cùng source để developer tiếp theo biết còn gì cần test.

Render Godot native của Switchyard với player, công tắc A và B, cửa, ô nguồn và lối ra.
Ảnh chụp engine local thực; source, test và giới hạn build đi cùng nguyên mẫu.

Khép vòng bằng handoff có thể rà soát

Handoff nên nêu phạm vi có thể chơi, danh tính nguồn, phiên bản engine và template, hướng dẫn build, kết quả chấp nhận và lỗi chưa giải quyết. Bao gồm ảnh chụp xác thực từ artifact đã test cùng nguồn gốc asset phát hành. Giữ lần sửa và can thiệp thủ công thay vì chỉ đưa dump mã được tạo cuối.

Khi vòng cơ bản được chấp nhận, thêm tài nguyên và bản địa hóa qua kiểm tra import cùng gameplay riêng trước khi cân nhắc gửi nền tảng. Hướng dẫn này dựa tài liệu engine; áp dụng với phiên bản đã cài và giữ kết quả thật. Giữ danh sách vấn đề ngắn với bước tái tạo để phiên phát triển tiếp theo bắt đầu từ trạng thái đã biết.

Câu hỏi thường gặp

Import headless có phải test gameplay không?

Không. Nó thực thi import tài nguyên. Input, hình ảnh, chuyển tiếp trạng thái và persistence cần kiểm tra quan sát riêng.

Có thể dùng export template làm executable editor không?

Dùng binary editor Godot cho lệnh xuất được ghi nhận. Export template là điều kiện riêng, không thay thế editor.

Vì sao preset xuất không giải quyết được?

Kiểm tra tên khớp chính xác export_presets.cfg, gồm khoảng trắng, và bạn chọn đúng thư mục project.

Agent nên chạy lệnh ở đâu?

Dùng path project sở hữu rõ và executable engine đã chọn. Tránh phụ thuộc thư mục hoặc binary đang hoạt động trong terminal khác.

Flow chấp nhận hữu ích nhỏ nhất là gì?

Khởi chạy từ tiêu đề, thực hiện hành động chính, hoàn tất vòng, restart rồi mở lại để kiểm tra persistence. Mở rộng khi game thêm hành vi.