Script biên dịch được nhưng phân cấp UI sai? Checklist bàn giao UI và MCP cho lập trình viên game
Dành cho lập trình viên Unity / Godot / Cocos: vì sao script Cursor không sửa được các lớp UI shell; checklist nghiệm thu sau khi nhập thiết kế, khi nào Unity …
- game-dev-ai
- Unity MCP
- Godot MCP
- Cocos MCP
- Cursor
- game-ui-design
- ui-to-engine
- unity
- godot
- cocos
- mcp
- vberai
- 2026
Trong phát triển indie và đội nhóm nhỏ, rào cản thường gặp không phải là “tôi không viết được C# / GDScript” — mà là script biên dịch được, mở Scene lên thì mọi thứ lệch hết: nút bấm không nhận click.
Nguyên nhân gốc hiếm khi nằm ở mô hình AI yếu. Đó là việc trộn lẫn bàn giao UI shell và logic gameplay trên cùng một toolchain. Dưới đây: các kiểu lỗi thường gặp, checklist nghiệm thu, và thời điểm nên đưa Engine MCP (Unity MCP / Godot MCP / Cocos MCP) vào pipeline.
Hai công việc—đừng ép một công cụ AI làm cả hai
| Công việc | Kết quả điển hình | Công cụ phù hợp hơn |
|---|---|---|
| UI shell | Cây Canvas / Control, Prefab, anchor, đặt tên slice | Nhập thiết kế có cấu trúc (PSD / Figma → engine) |
| Logic gameplay | Sự kiện nút bấm, chỉ số, state machine, debug trong Play | Cursor / Claude Code + Engine MCP |
Cursor, Copilot, Claude Code mặc định chỉ thấy phần text trong repo. Chúng không thấy:
- Các chỉnh sửa scene chưa lưu trong editor
- Vùng chọn hiện tại, các tham chiếu prefab bị hỏng
- Console và trạng thái UI tạm thời trong chế độ Play
Vì vậy AI sửa file .cs trong khi Btn_Start vẫn chưa có OnClick trong Hierarchy—đó không phải vấn đề prompt, mà là thiếu cầu nối với editor. MCP lấp khoảng trống đó. Bản đồ phân loại: Công cụ AI cho Godot / Unity.
Sau khi nhập UI: 10 bước kiểm tra kỹ thuật
Sau khi design hoặc AI Studio xuất Prefab, hãy chạy checklist này trước lần Play đầu tiên (ví dụ với Unity UGUI; Godot / Cocos ánh xạ tương tự):
| # | Kiểm tra | Lỗi thường gặp |
|---|---|---|
| 1 | Canvas / Control gốc và chính sách độ phân giải | Sai Canvas Scaler; Safe Area dọc bị cắt |
| 2 | Vùng nhận click tách khỏi phần trang trí | Ảnh trong suốt chặn Raycast |
| 3 | Trạng thái normal / pressed / disabled của nút | Chỉ có một ảnh tĩnh duy nhất |
| 4 | Text ánh xạ sang TMP / Label | Chữ hiển thị full-screen, không có bản địa hóa |
| 5 | Tên node thân thiện với script (Btn_*, Panel_*) | Layer 47 copy |
| 6 | Quy tắc anchor / 9-slice và stretch | Layout trôi khi đổi độ phân giải |
| 7 | Atlas và draw call ở mức chấp nhận được | Mỗi control một file PNG quá khổ |
| 8 | Đường dẫn import khớp quy ước dự án | MCP không tìm thấy đường dẫn Prefab |
| 9 | Commit trước khi gán logic | AI sửa script; tham chiếu bị mất |
| 10 | Play thử một lần ở 16:9 và tỉ lệ dọc mục tiêu | Chỉ test đúng tỉ lệ cửa sổ Editor |
Nhập có cấu trúc so với cắt slice thủ công: Figma → Unity không cần cắt thủ công, tách UI tại chỗ.
Khi nào nên cài Engine MCP
| Tình huống | Khuyến nghị |
|---|---|
| Thay đổi gameplay hằng ngày, Play / Console thường xuyên | Cài Engine MCP tương ứng |
| UI vẫn phải dựng lại bằng cắt slice thủ công mỗi tuần | Sửa shell trước (bàn giao qua AI Studio / spec), rồi mới đến MCP |
| Chỉ làm script, ít khi chạm vào Scene | Lợi ích từ MCP hạn chế |
| Game Jam, cần chơi được trong ngày | AI Studio lo UI + MCP lo nút bấm (hướng dẫn từng bước) |
Godot MCP là mã nguồn mở—phù hợp để kiểm chứng workflow trước: cài đặt · khi nào thủ công vs MCP. Unity / Cocos: gói Pro chính thức—cài Unity MCP · Cocos 3.x.
Chọn giữa ba engine: Godot MCP vs Unity MCP vs Cocos MCP.
Phân chia khuyến nghị (góc nhìn kỹ thuật)
File thiết kế / ảnh UI full-screen
→ AI Studio: nhập · tách · xuất Prefab (Unity / Godot / Cocos)
→ Kỹ thuật chạy 10 bước kiểm tra ở trên
→ Cursor + Engine MCP: gán OnClick, HUD, chỉ số, debug trong Play
| Loại thay đổi | Hướng xử lý |
|---|---|
| Đổi theme / nội dung bản địa hóa / reskin full-screen | AI Studio xuất lại (reskin, dịch) |
| Cảm giác, va chạm, AI, lưu game, bug | MCP + code được review thủ công |
| Số sát thương, chữ pixel | Bitmap font hoặc TMP |
Nguyên tắc chung: AI Studio lo shell, MCP lo nối dây. Đừng yêu cầu MCP dựng cả HUD từ đầu; cũng đừng viết combat FSM bên trong công cụ canvas.
Sau khi nối MCP: 3 thực hành
- Prompt phải kiểm chứng được—đường dẫn Prefab.
- Commit nhỏ—mỗi lần một thay đổi: “nút Start → load level,” rồi mới đến AI kẻ địch.
- MCP không thay thế QA—các chỉnh sửa node do model tạo vẫn cần Play thử; nó tiết kiệm click.
Cursor và Claude Code với Unity: hướng dẫn workflow Unity MCP, Claude Code kết nối Unity MCP.
Bộ công cụ kết hợp và lộ trình triển khai một tuần: hiệu quả AI cho game dev 2026.
FAQ
Chỉ dùng Cursor là đủ—có cần MCP không? Đủ cho script; khi bạn chạm vào cây Scene.
MCP có thay thế việc cắt UI không? Không. MCP quản lý các đối tượng trong editor; cấu trúc UI vẫn cần bàn giao ở mức Prefab (qua AI Studio hoặc luồng PSD / Figma theo spec).
Chỉ dùng một engine—có nên học AI Studio không? Đáng học nếu việc sửa UI ngốn thời gian dựng lại Canvas; nếu UI tối giản.
Dự án Godot nhỏ—nên cài gì trước? Thử Godot MCP (mã nguồn mở) trước; thêm AI Studio khi khâu bàn giao UI bắt đầu gây đau đầu.
Có xung đột với Unity AI UI Generator không? Không xung đột. Unity AI thiên về sprite trong editor; với đa engine hoặc nhập PSD/Figma có cấu trúc.
Đọc tiếp
Các bài hướng dẫn bạn có thể thích
Cocos Creator MCP là gì? Khả năng so với 'Cocos Creator AI'
Cocos Creator MCP của VberAI: kết nối trình soạn thảo mở với Cursor để thao tác scene, node, component—khác biệt với 'Cocos Creator AI' mơ hồ, AI Studio và trợ…
- cocos
- cocos-creator
- mcp
- cocos-mcp
VberAI Studio làm được gì: tạo ảnh, cắt UI, đổi giao diện, dịch và tách nền
Một trang về những gì VberAI Studio làm được: tạo ảnh AI, cắt tại chỗ, đổi giao diện, dịch UI, pixel hóa, tách nền, khung hình, âm thanh, 3D và font bitmap, xu…
- vberai
- ai-studio
- game-ui
- image-gen
Vùng An Toàn UI Game và QA Thiết Bị: Thứ Tự Debug và Sửa Prefab cho Kỹ Sư
Khi Unity Editor trông ổn nhưng notch cắt HUD hoặc chạm bị lệch: phân loại lỗi, debug Canvas Scaler và Screen.safeArea, sửa Prefab so với tái xuất Studio—với d…
- game-ui-design
- game-dev-ai
- ui-to-engine
- safe-area