Show GN: hera-agent-unity - Giải pháp thay thế MCP để điều khiển Unity bằng CLI (0 phụ thuộc runtime)

• LLM không biết dự án của bạn, chỉ nhớ Unity API đã học từ năm ngoái và những pattern được khái quát hóa. hera-agent-unity cho phép AI chạy trực tiếp trong Unity Editor đang hoạt động và lấy kết quả về trước khi suy đoán mã — đo đạc thực tế thay vì phỏng đoán
• 1 binary Go + 1 gói C# UPM, 0 phụ thuộc runtime. Chỉ cần mở Unity Editor là đã kết nối sẵn qua localhost HTTP. Không cần Python, WebSocket hay JSON-RPC
• Hoạt động với mọi AI agent có thể chạy lệnh shell như Claude Code, Codex, Cursor, v.v. (không bị ràng buộc vào một MCP client cụ thể)

Có thể làm gì

• exec — chạy C# tùy ý bên trong Unity (toàn quyền truy cập editor + runtime). Biên dịch bằng Roslyn rồi cache, cùng một đoạn mã có thể chạy lại ngay lập tức
• console / scene / test / profiler — đọc log console thực theo từng loại, thao tác scene, chạy kiểm thử PlayMode và đọc profiler ngay trong terminal
• describe_type / find_method / unity_docs — dùng reflection để kiểm tra assembly đang hoạt động, và tra cứu offline 31.581 Unity 6 ScriptReference (được nhúng trong package, không cần mạng hay rate limit)
• manage_gameobject / components / prefab / material / ui — chỉnh sửa GameObject, component, prefab, material và uGUI qua API mà không cần boilerplate C#
• batch — thực thi nhiều lệnh một cách nguyên tử chỉ trong một vòng HTTP request/response (cho CI và tự động hóa)
• công cụ tùy chỉnh — chỉ cần đặt một lớp C# có attribute [HeraTool] là sẽ tự động được phát hiện (không cần đăng ký hay codegen)

Điểm nổi bật gần đây — mockup UI → UI Unity thực (ui_doc)

• Điểm yếu nhất của AI là UI (anchor/pivot/layout của uGUI). Với ui_doc, agent thiết kế bằng JSON IR có hình thức giống HTML, rồi Hera chuyển chính xác sang uGUI thực tế
• Vòng lặp "đo đạc thực tế thay vì phỏng đoán": đo màu từ ảnh chụp tham chiếu (sample) → viết IR → áp dụng (apply) → render (capture) → so sánh → chỉnh sửa. Có thể tái tạo HUD game chỉ từ một ảnh chụp màn hình mà không cần con người can thiệp
• Quy trình tạo sprite thủ công với 0 phụ thuộc bên ngoài, và 0 phụ thuộc compile-time vào com.unity.ugui

So với MCP

• Cài đặt: Python + uv + FastMCP + file cấu hình → một binary duy nhất
• Giao thức: JSON-RPC over stdio → HTTP POST trực tiếp
• Domain reload: logic tái kết nối phức tạp → stateless (filesystem bus)
• Tương thích: chỉ dành cho MCP client → mọi shell, agent, script đều dùng được

Hỗ trợ Unity 6 (6000.0+), miễn phí toàn bộ tính năng theo giấy phép MIT. Đây là bản kế thừa hợp nhất của hera-agent (miễn phí) + hera-agent-pro (thương mại), và toàn bộ tính năng Pro nay đã được mở theo MIT.