Unity MCP مع Claude Code و Cursor: تشغيل المحرر دون كتابة كل تغيير يدويًا
اربط Claude Code و Cursor و Codex بـ Unity عبر Model Context Protocol—ثبّت جسرًا محليًا، واستعرض التغييرات، وصحح أخطاء المشاهد بما يتجاوز تعديلات الملفات بالذك…
- unity-mcp
- mcp-for-unity
- claude-unity-mcp
- unity-claude-code
- unity-ai
- claude-code
- cursor
- vberai
حدود “الذكاء الاصطناعي يكتب C# في مجلد”
أدوات البرمجة القائمة على الدردشة جيدة في إنشاء السكربتات. الذكاء الاصطناعي الذي يعدل الملفات فقط لا يزال يفتقد حالة المحرر الحية—المشاهد المفتوحة، GameObjects المحددة، متغيرات البريفاب، سلوك وضع التشغيل، وأخطاء Console.
إذا كان النموذج يرى الملفات على القرص فقط، فإنه يخمن التسلسل الهرمي ولا يمكنه النقر على Play، أو إعادة تسمية عقدة في Hierarchy، أو فحص مرجع مفقود. تحتاج الفرق إلى مساعد داخل حلقة المحرك، وليس فقط في المستودع.
Model Context Protocol (MCP) هو معيار لتمكين عملاء الذكاء الاصطناعي من استدعاء الأدوات. يكشف خادم Unity MCP عن إجراءات المحرر عبر جسر محلي بحيث يمكن لعملاء مثل Claude Code و Cursor وسير عمل بأسلوب Codex قراءة المشروع وتغييره أثناء تشغيل Unity.
توفر VberAI مكونًا إضافيًا لـ Unity MCP لهذا الجسر. هذا الدليل هو مسار إعداد واستخدام عملي—وليس عرضًا للميزات.
ما الذي يغيّره Unity MCP في العمل اليومي
| بدون MCP | مع Unity MCP |
|---|---|
| الصق السكربتات المولدة، ثم أصلح أخطاء الترجمة بنفسك | اطلب من العميل إنشاء سكربت و إرفاقه بـ GameObject مسمى |
| كرر لوحات الواجهة يدويًا | موجه: “استنسخ Panel_Shop تحت Canvas وأعد تسمية الأطفال” |
| صف أخطاء Console في الدردشة | دع العميل يقرأ السجلات الأخيرة / سياق التحديد (حيث يسمح المكون الإضافي بذلك) |
| خمن تخطيط المشهد من YAML | استعلم عن التسلسل الهرمي، ثم عدّل مع التأكيد |
ما زلت تراجع الاختلافات ونتائج وضع التشغيل. تتوقف عن كتابة كل نقرة محرر يمكن للوكيل القيام بها بأمان.
المتطلبات الأساسية
- مشروع Unity مفتوح (يوصى بـ LTS للعمل الجماعي)
- عميل يدعم MCP: Claude Code أو Cursor أو Windsurf أو ما شابه
- وصول شبكة محلي إلى
127.0.0.1(يبقى الجسر عادة على loopback) - حزمة VberAI Unity MCP لإصدار Unity الخاص بك (تنزيل / وثائق)
مفيد لكن اختياري: مشهد عينة صغير (Canvas فارغ + زران) بحيث يسهل التحقق من الموجّهات الأولى.
قائمة التحقق للإعداد
1. تثبيت مكون Unity MCP الإضافي
- استورد الحزمة إلى مشروعك (أو ثبّتها عبر سير عمل الحزم لفريقك)
- فعّل الامتداد / إدخال القائمة (تختلف الأسماء قليلاً حسب البناء—ابحث عن MCP أو AI Bridge)
- أعد تحميل المحرر إذا طلب Unity ذلك
2. بدء جسر MCP المحلي
افتح لوحة المكون الإضافي وابدأ الخادم. تأكد من:
- تظهر الحالة قيد التشغيل
- المضيف هو localhost (لا تعرض المنفذ للعامة)
- مسار المشروع يطابق مشروع Unity الذي تنوي تعديله
3. تسجيل الخادم في عميل الذكاء الاصطناعي الخاص بك
في Cursor أو Claude Code، أضف إدخال خادم MCP يشير إلى جسر Unity المحلي (stdio أو HTTP/SSE—اتبع الوثائق الحالية للمكون الإضافي).
أعد تشغيل العميل إذا لم تظهر الأدوات. يجب أن ترى أدوات متعلقة بـ Unity مدرجة (قراءة المشهد، عمليات العقد، إلخ).
4. قم باختبار دخان للقراءة فقط
اسأل:
اذكر GameObjects الجذرية في المشهد النشط.
إذا كان الرد يطابق Hierarchy، فإن الجسر يعمل. عندها فقط جرب إجراءات الكتابة.
5. قم باختبار كتابة صغير
اسأل:
أنشئ GameObject فارغًا باسم
MCP_SmokeTestتحت جذر المشهد.
ابحث عنه في Hierarchy، ثم احذفه. فضّل الاختبارات القابلة للعكس قبل إعادة هيكلة كبيرة.
أنماط الموجّهات التي تعمل بشكل جيد
البنية أولاً
اعرض أبناء
Canvas/HUDولخص أي منها هي LayoutGroups.
كتابات مركزة
تحت
Canvas/Menu، أعد تسميةButtonإلىBtn_Startواضبط نص تسمية TMP إلىStart.
حلقة التصحيح
بعد أن أضغط Play، لخص أخطاء Console المتعلقة بـ
PlayerControllerواقترح أصغر إصلاح.
الاقتران مع واجهة مولدة
إذا استوردت شاشة من AI Studio، استخدم MCP لربط مستمعات onClick أو مواءمة التسمية مع اصطلاحات C# الخاصة بك—دون إعادة بناء البريفاب يدويًا.
عادات السلامة
- أبقِ الجسر على localhost فقط
- فضّل القراءة ← التخطيط ← الكتابة على موجه واحد ضخم “أعد بناء اللعبة”
- التزم قبل تعديلات الوكيل الكبيرة
- لا تضع أسرارًا في الموجّهات؛ MCP لا يحل محل التحكم في الوصول
- تعامل مع وضع التشغيل وتحديث قاعدة الأصول كنقاط تفتيش بشرية
يقلل MCP من النقر اليدوي على المحرر. لا يزيل مراجعة الكود.
كيف يرتبط هذا بمساعدي Unity المدمجين
يحل مساعدو Unity المدمجون ومكونات Unity MCP الإضافية من جهات خارجية مهامًا متداخلة. قم بتقييمها بنفس الطريقة:
- هل يمكن للأداة رؤية المباشر Hierarchy / التحديد؟
- هل يمكنها إجراء تعديلات قابلة للعكس يمكنك تدقيقها؟
- هل تعمل مع عميل الذكاء الاصطناعي الذي يستخدمه فريقك بالفعل (Claude Code، Cursor، …)؟
Unity MCP هو الأقوى عندما يعيش فريقك بالفعل في هؤلاء العملاء ويريد بروتوكولًا واحدًا عبر المحركات (تشغل العديد من الاستوديوهات أيضًا Godot أو Cocos MCP بنفس العادة).
الأسئلة الشائعة
هل ما زلت أكتب C#؟
نعم. MCP هو الأفضل في عمليات المحرر والهيكلة. لا تزال أنظمة اللعب والشبكات والأداء بحاجة إلى مهندسين.
Claude Code مقابل Cursor؟
كلاهما يعمل إذا كانا يدعمان MCP وقمت بتوجيههما إلى نفس خادم Unity المحلي. اختر العميل الذي يستخدمه مستودعك بالفعل؛ الجسر هو القطعة المشتركة.
هل هذا للواجهة فقط؟
لا. تنطبق عمليات Hierarchy والمكونات والمشهد على كائنات اللعب أيضًا. الواجهة هي مجرد عرض توضيحي أول سهل.
أين الفيديو التعليمي؟
انظر Unity Game Engine MCP Plugin (video guide) على مسار قناة VberAI لإعداد مسجل.
الخطوات التالية
- ثبّت Unity MCP في مشهد تجريبي
- اربط Claude Code أو Cursor واجتاز اختبار الدخان للقراءة فقط
- أتمتة مهمة تكرهها (إعادة تسمية دفعة، تكرار لوحة، إرفاق سكربت)
عندما يكون التصميم إلى بريفاب هو عنق الزجاجة بدلاً من عمليات المحرر، اقرن هذا بسير عمل Figma → Unity AI Studio.
تابع القراءة
أدلة أخرى قد تعجبك
نماذج ثلاثية الأبعاد بالذكاء الاصطناعي في VberAI Studio: من النص إلى 3D ومن الصورة إلى 3D (Meshy، Tripo، Hunyuan3D) — تحرير، عرض، تصدير إلى المحرك
VberAI Studio: من النص إلى 3D ومن الصورة إلى 3D مع Meshy وTripo وHunyuan3D — PBR وGLB/FBX/USDZ وإعادة الطوبولوجيا والتجهيز والعرض والتصدير إلى Unity وGodot وCo…
- vberai
- ai-studio
- 3d-model
- text-to-3d
كيفية استيراد PSD إلى Unity UI في 5 دقائق باستخدام AI Studio
سير عمل سريع وعملي لتحويل ملفات PSD ذات الطبقات إلى prefabs لواجهة Unity، باستخدام VberAI Studio للاستيراد المراعي للبنية، مع نصائح لإعداد Canvas والتكرار.
- vberai
- ai-studio
- unity
- psd
أي أداة ذكاء اصطناعي لفن تصميم الألعاب؟ مولّدات أصول الألعاب مقابل فن الذكاء الاصطناعي العام (2026)
أي أداة ذكاء اصطناعي لفن تصميم الألعاب؟ مقارنة Layer AI وPicLumen وMeshy وMorphic وUnity AI UI وأدوات عامة مثل Midjourney حسب نوع المخرجات.تنقسم الأدوات إلى فئ…
- game-art
- ai-tools
- concept-art
- game-ui