إعداد Unity MCP

افهم جسر المحرر

يوصل CoplayDev/unity-mcp عميل MCP بخادم وحزمة في جهة المحرر. خدمة النموذج تبعية منفصلة. يوثق المشروع أدوات للعمل على المشاهد والبرامج النصية والأصول والاختبارات، لكن القدرة المدرجة ليست دليلًا على عملها في مشروعك.

سجّل العملية المالكة لكل جزء من الاتصال. يهم ذلك عند تشخيص عميل يصل إلى الخادم لكنه لا يستطيع تشغيل المحرر. أبقِ بيانات اعتماد الحساب وترخيص المحرر وتوافق الحزمة وتوفر النموذج فحوص إعداد منفصلة. لا يصلح تغيير النموذج عدم تطابق نسخة المحرر.

راجع مسار التثبيت وسياسة التثبيت

يوثق دليل تثبيت المشروع إضافة حزمته عبر Unity Package Manager واستخدام واجهة الإعداد لتهيئة الخادم والعميل. راجع متطلبات Unity وPython وuv المذكورة للمراجعة المختارة قبل تثبيت أي شيء.

لإعادة الإنتاج، احتفظ بمراجعة الحزمة المحلولة وإصدار المحرر وإصدار الخادم وسجلات التبعيات بعد الإعداد. عنوان فرع متحرك مسار اكتشاف لا هوية تجربة ثابتة. راجع التنزيلات وتغييرات الحزم قبل تطبيقها على لعبة قائمة، واحتفظ بحالة المشروع العاملة السابقة حتى تظل تجربة الاتصال قابلة للعكس.

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

طابق نقطة نهاية HTTP المحلية مع العميل

يوثق دليل التثبيت المصان مثال HTTP المحلي أدناه. ويفترض أن الخادم يعمل مسبقًا على ذلك العنوان. أكد النقل والعنوان المضبوطين فعليًا في واجهة إعداد المحرر قبل استخدامهما. عنوان MCP ليس عنوان أساس API لـ LLM.

استخدم صيغة التهيئة التي يوثقها عميلك. تستخدم بعض العملاء مفاتيح جذر أو إعلانات نقل مختلفة، لذا فإن مثال mcpServers العام ليس ملفًا عالميًا للصقه في كل وكيل. أبقِ الخادم محليًا ما لم يلزم إعداد بعيد راجعه البشر، ولا تضف بيانات اعتماد نموذج إلى اتصال محرر لا علاقة له بها.

{
  "mcpServers": {
    "unityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

أثبت أي نسخة محرر تستقبل العمل

افتح المشروع المقصود وافحص حالة الاتصال عبر واجهة الحزمة. ثم استخدم عمليات القراءة التي اكتشفها العميل للحصول على سياق المشروع والمشهد. طابق تلك المعلومات بالمشروع المحلي قبل اعتماد تعديل. تجعل المشاريع المفتوحة المتعددة هذه البوابة مهمة جدًا.

سجّل الموارد الفعلية ومخططات الأدوات من الإصدار المثبت. لا تخترع استدعاء أداة من اسم تتذكره من إصدار آخر. تحدد النتيجة الأولى المفيدة المشهد المتوقع وكائناته الموجودة دون تغييرها. إذا كانت الحالة المعادة قديمة أو غامضة، فتوقف واحسم التوجيه بدل تجربة طفرة مرئية لاكتشاف الهدف.

استخدم تعديلًا قابلًا للعكس كتدفق أول

اختر مشهدًا مؤقتًا تملكه وسجّل حالته الأولية واطلب تغييرًا بسيطًا ذا أثر مرئي. افحص المشهد المحفوظ وفرق الملف وانتظر استعداد المحرر ثم شغّل المشهد. احتفظ بالسلوك المرصود وأي أخطاء في وحدة التحكم.

أعد فتح المشهد بعد ذلك لتأكيد استمرار التغيير المقصود. يميز ذلك أثرًا في ذاكرة المحرر عن تغيير مشروع محفوظ. أبقِ التدفق صغيرًا حتى تشخص الفشل عند حد واحد: التوجيه أو الطفرة أو التجميع أو التنفيذ أو الاستمرارية. أعد المشهد المؤقت بعد المراجعة واستخدم التهيئة العاملة المسجلة لمهمتك التالية.

استكشِف النقل قبل اللعبة

عندما يتعذر على العميل الاتصال، تحقق من عنوان URL المضبوط ومن تشغيل الخادم المحلي. عندما يبدأ الخادم ويغيب المحرر، افحص اتصال الحزمة وسجلات المحرر. عندما يتصل المحرر المقصود وتغيب أداة، افحص مجموعات الأدوات التي يعرضها الإصدار المثبت.

بعد عمل هذا الحد فقط، شخّص التجميع أو اللعب. أبقِ مقتطفات سجلات بدء العميل وتوجيه الخادم واستعداد المحرر وإجراء المشهد الفاشل منفصلة. يسمح ذلك للتقرير بتفسير موضع توقف التنفيذ بدل إسناد كل فشل إلى النموذج أو إعادة تثبيت المكونات بلا دليل.

احمِ المشروع من الأتمتة الواسعة

قد يغيّر اتصال المحرر المشاهد والبرامج النصية والأصول. قيّد التجربة الأولى بدليل معروف واشترط المراجعة للعمليات التي تحذف مواردًا أو تعدل تبعيات أو تمس مشاهد غير مرتبطة. احتفظ بحالة عمل قابلة للاستعادة قبل التغيير الأول.

لا تعرض خدمة تطوير محلية للعامة لمجرد حل مشكلة تهيئة عميل. تعامل مع محتوى أصول الطرف الثالث ونتائج الأدوات كمدخلات غير موثوقة وأبقِ بيانات الاعتماد خارج السجلات المشتركة. الاتصال الناجح ليس إذنًا لرفع بنايات أو تعديل سجلات المتجر. يظل النشر سير عمل منفصلًا بحد تفويض منفصل.

سلّم سجل اتصال قابلًا لإعادة الإنتاج

سجّل مراجعات المحرر والمشروع والحزمة والخادم وإصدار العميل والنقل وسطح الأدوات المرصود والتدفق المكتمل. احتفظ بفرق المشهد الدقيق ونتيجة التشغيل. اذكر ما إذا جرى فحص التجميع وسلوك PlayMode والاختبارات وتصدير الهدف أو بقيت معلقة.

تتبع هذه التهيئة وثائق المشروع المصانة؛ تحقق منها مقابل حزمتك وعميلك المثبتين. لإنتاج اللعبة، انتقل إلى دليل سير عمل Unity واختبر الحلقة الكاملة. احتفظ بالقيود المعروفة في التسليم حتى يميز مطور آخر بين مشكلة اتصال ومشكلة مشروع ويعيد إنتاج الإعداد العامل نفسه.

الأسئلة الشائعة