godot-ai

# Godot AI Godot AI MCP کلائنٹس جیسے Claude Code، Claude Desktop، Codex، اور Hermes Agent کو لائیو Godot ایڈیٹر سے جوڑتا ہے۔ یہ 46 ٹولز اور 120+ آپریشنز فراہم کرتا ہے جو AI معاونین کو مناظر بنانے، نوڈس اور اسکرپٹس میں ترمیم کرنے، سگنلز جوڑنے، اور UI، میٹریلز، اینیمیشن، پارٹیکلز، کیمرے اور ماحول کو ترتیب دینے کی اجازت دیتے ہیں۔ ## فوری آغاز ### تقاضے - Godot 4.7+ (4.x لائن کے اندر) Godot AI v4 کے لیے - uv (Python سرور کے لیے uvx فراہم کرتا ہے) - ایک MCP کلائنٹ ### تنصیب 1. **نیا پروجیکٹ:** GitHub Releases سے ایک شائع شدہ ورژن ڈاؤن لوڈ کریں اور ایڈ آن کو `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 شامل ہیں۔ ### آزمائیں مثالی پرامپٹس: - "مجھے موجودہ منظر کی درجہ بندی دکھائیں۔" - "/Main کے تحت MainCamera نامی ایک Camera3D بنائیں۔" - "پروجیکٹ میں ui/ میں PackedScene فائلیں تلاش کریں۔" - "منظر ٹیسٹ سوٹ چلائیں۔" - "ایک ووکسل بلاک ورلڈ گیم بنائیں جس میں کھلاڑی، رکھنے اور تباہ کرنے کے لیے بلاکس، اور محفوظ سلاٹ ہوں۔" ## یہ کیسے کام کرتا ہے ```text MCP کلائنٹ → godot-ai attach (stdio) → Python سرور (مصدقہ HTTP، پورٹ 8000) → Godot ایڈیٹر پلگ ان (مصدقہ WebSocket، پورٹ 9500) ``` دونوں مقامی ہاپس آزاد گھومنے والی صلاحیتیں استعمال کرتے ہیں؛ کوئی بھی غیر مصدقہ رسائی پر واپس نہیں جاتا۔ ایڈیٹر WebSocket صرف لوپ بیک رہتا ہے۔ کنٹینرز یا دوسری مشینوں میں ایجنٹوں کے لیے، ایڈیٹر مشین پر SSH کے ذریعے برج چلائیں۔ ## ٹیلی میٹری اور رازداری استعمال کی ٹیلی میٹری ایک تنصیب UUID، واقعہ، نتیجہ، دورانیہ، پلیٹ فارم اور ورژن ریکارڈ کرتی ہے—کوڈ، منظر کے مواد، یا پروجیکٹ/فائل کے نام نہیں۔ پروجیکٹ ڈائرکٹری کے سلگ منتقلی سے پہلے ہیش کیے جاتے ہیں۔ اختیار باہر: `GODOT_AI_DISABLE_TELEMETRY=true` یا `DISABLE_TELEMETRY=true`۔ ## دستاویزات اور مدد ### Bazzite / Fedora Atomic ڈیسک ٹاپ مسئلہ 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