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úng chỉ nhớ Unity API đã học từ năm ngoái và những mẫu hình khái quát hóa. hera-agent-unity cho phép AI thực thi trực tiếp trong Unity Editor đang chạy và lấy kết quả về trước khi phỏng đoán mã — đo đạc thực tế thay vì suy đoán
• 1 binary Go + 1 gói C# UPM, 0 phụ thuộc runtime. Bật 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... (không bị khóa vào một MCP client cụ thể)

Có thể làm gì

• exec — thực thi 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ật theo từng loại, thao tác scene, chạy PlayMode test và đọc profiler từ terminal
• describe_type / find_method / unity_docs — dùng reflection để soi các assembly đang hoạt động, tra cứu offline 31.581 Unity 6 ScriptReference (được nhúng trong package, không cần mạng hay lo 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 C# boilerplate
• batch — chạy nhiều lệnh một cách nguyên tử chỉ trong một lượt HTTP round-trip (cho CI và tự động hóa)
• công cụ tùy chỉnh — chỉ cần đặt một class C# có attribute [HeraTool] là sẽ được tự động phát hiện (không cần đăng ký hay codegen)

Điểm nhấn gần đây — mockup UI → UI Unity trực tiếp (ui_doc)

• Mảng AI yếu nhất là UI (anchor/pivot/layout của uGUI). ui_doc cho phép agent thiết kế bằng JSON IR dạng HTML và Hera sẽ dịch chính xác thành uGUI thực tế
• Vòng lặp "đo đạc thực tế thay vì suy đ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 từ chỉ 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, 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 kết nối lại phức tạp → stateless (filesystem bus)
• Tương thích: chỉ dành cho MCP client → mọi shell, agent hay 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à sản phẩm 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 hiện đã được phát hành theo MIT.