godot-ai

# Godot AI يصل Godot AI عملاء MCP مثل Claude Code وClaude Desktop وCodex وHermes Agent بمحرر Godot الحي. يوفر 46 أداة وأكثر من 120 عملية تتيح للمساعدين الذكاء الاصطناعي بناء المشاهد وتحرير العقد والبرامج النصية وربط الإشارات وتكوين واجهة المستخدم والمواد والرسوم المتحركة والجسيمات والكاميرات والبيئات. ## بدء سريع ### المتطلبات - Godot 4.7+ (ضمن سلسلة 4.x) لإصدار Godot AI v4 - uv (يوفر uvx لخادم Python) - عميل MCP ### التثبيت 1. **مشروع جديد:** قم بتنزيل إصدار منشور من إصدارات GitHub وقم بتثبيت الإضافة في `your-project/addons/godot_ai/` مع وجود `plugin.cfg` داخل هذا الدليل. 2. **تثبيت موجود:** استخدم زر التحديث في رصيف Godot AI. يدعم الإصدار v3 الموقع النهائي الترحيل بنقرة واحدة إلى v4. ### تفعيل الإضافة في Godot: **المشروع ← إعدادات المشروع ← الإضافات ← Godot AI**. تبدأ الإضافة خادم MCP وتعرض حالة الاتصال في رصيف Godot AI. ### توصيل عميل MCP الخاص بك في الرصيف، اضغط على **تكوين** بجوار عميلك، أو **تكوين الكل** لكل عميل تم اكتشافه. يشمل العملاء المدعومون Claude Code وClaude Desktop وCodex وAntigravity وHermes Agent وDeepSeek Harness وCursor وVS Code. ### جربها أمثلة على الأوامر: - "أظهر لي التسلسل الهرمي للمشهد الحالي." - "أنشئ Camera3D باسم MainCamera تحت /Main." - "ابحث في المشروع عن ملفات PackedScene في ui/." - "شغّل مجموعة اختبار المشهد." - "ابنِ لعبة عالم مكعبات مع لاعب ومكعبات لوضعها وتدميرها وفتحات حفظ." ## كيف يعمل ```text عميل MCP ← godot-ai attach (stdio) ← خادم Python (HTTP مصادق، منفذ 8000) ← إضافة محرر Godot (WebSocket مصادق، منفذ 9500) ``` كلا القفزتين المحليتين تستخدمان قدرات دوارة مستقلة؛ لا ترجع أي منهما إلى وصول غير مصادق. يبقى WebSocket المحرر مقتصرًا على الحلقة المحلية فقط. للوكلاء في الحاويات أو على أجهزة أخرى، شغّل الجسر على جهاز المحرر عبر SSH. ## القياس والخصوصية يسجل قياس الاستخدام معرّف تثبيت فريدًا والحدث والنتيجة والمدة والمنصة والإصدار—وليس الكود أو محتويات المشهد أو أسماء المشاريع/الملفات. يتم تجزئة أسماء مجلدات المشروع قبل الإرسال. يمكنك إلغاء الاشتراك باستخدام `GODOT_AI_DISABLE_TELEMETRY=true` أو `DISABLE_TELEMETRY=true`. ## التوثيق والمساعدة ### مشكلة Bazzite / Fedora Atomic Desktop على Bazzite وأسطح Fedora Atomic الأخرى، يكون `/home` عادةً رابطًا رمزيًا إلى `/var/home`. يرفض Godot AI 4.0.2 والإصدارات الأقدم كل مسار دليل قدرة يمر عبر رابط. يتبع الإصدار التالي رابطًا عندما يكون مملوكًا للجذر ويقع في دليل مملوك للجذر لا يمكن للحسابات الأخرى الكتابة فيه. بالنسبة للإصدار 4.0.2 أو الأقدم، اضبط `GODOT_AI_CAPABILITY_DIR` على مسار أساسي وشغّل كلاً من Godot وعميل MCP الخاص بك من ذلك الطرفية. ### المرجع والدعم - الأدوات والعمليات والموارد - كتابة وتشغيل اختبارات للعبتك - تفاصيل تكوين العميل - الترقية من v3 واستعادة الترحيلات المتقطعة - سجل التغييرات - المساهمة وإعداد التطوير - Discord للأسئلة والعروض؛ GitHub Issues لتقارير الأخطاء **الترخيص:** MIT