منصوبے کے بارے میں

Godot MCP ایک Model Context Protocol (MCP) سرور ہے جو AI ایجنٹس کو Godot گیم انجن سے جوڑتا ہے۔ یہ AI اسسٹنٹس کو ایڈیٹر لانچ کرنے، پروجیکٹس کو ڈیبگ موڈ میں چلانے، کنسول آؤٹ پٹ حاصل کرنے اور ایگزیکیوشن فلو کنٹرول کرنے کے ذریعے Godot پروجیکٹس کے ساتھ براہ راست تعامل کرنے کے قابل بناتا ہے۔ سرور سین مینجمنٹ کی صلاحیات بھی فراہم کرتا ہے، بشمول سین بنانا، کسٹم پراپرٹیز کے ساتھ نوڈز شامل کرنا، اسپرائٹس لوڈ کرنا، 3D سینز کو MeshLibrary ریسورسز کے طور پر ایکسپورٹ کرنا، اور Godot 4.4+ کے لیے UID ریفرنسز کا انتظام کرنا۔ ## اہم خصوصیات - **ایڈیٹر اور پروجیکٹ کنٹرول**: Godot ایڈیٹر لانچ کریں، پروجیکٹس کو ڈیبگ موڈ میں چلائیں اور انہیں پروگرامی طریقے سے روکیں - **ڈیبگ آؤٹ پٹ کیپچر**: حقیقی وقت کے فیڈبیک کے لیے کنسول آؤٹ پٹ اور ایرر میسیجز حاصل کریں - **پروجیکٹ تجزیہ**: کسی ڈائریکٹری میں پروجیکٹس کی فہرست حاصل کریں، تفصیلی پروجیکٹ اسٹرکچر معلومات حاصل کریں، اور انسٹال شدہ Godot ورژن معلوم کریں - **سین مینجمنٹ**: - مخصوص روٹ نوڈ ٹائپس کے ساتھ نئے سین بنائیں - موجودہ سینز میں حسب ضرورت پراپرٹیز کے ساتھ نوڈز شامل کریں - Sprite2D نوڈز میں اسپرائٹس/ٹیکسچرز لوڈ کریں - GridMap کے لیے 3D سینز کو MeshLibrary ریسورسز کے طور پر ایکسپورٹ کریں - مختلف آپشنز کے ساتھ سین محفوظ کریں - **UID مینجمنٹ** (Godot 4.4+): فائلوں کے لیے UIDs حاصل کریں اور ریسورسز کو دوبارہ محفوظ کر کے UID ریفرنسز اپ ڈیٹ کریں ## فن تعمیر سرور ایک ہائبرڈ طریقہ استعمال کرتا ہے: 1. **براہ راست کمانڈز**: سادہ آپریشنز (ایڈیٹر لانچ کرنا، ورژن حاصل کرنا) Godot کی بلٹ ان CLI کمانڈز استعمال کرتے ہیں 2. **بنڈلڈ آپریشنز اسکرپٹ**: پیچیدہ آپریشنز (سین کی تخلیق، نوڈ مینیپولیشن) ایک جامع GDScript فائل (godot_operations.gd) استعمال کرتے ہیں جو آپریشن ٹائپ اور پیرامیٹرز کو JSON کے طور پر قبول کرتی ہے، جو عارضی فائلیں بنائے بغیر لچکدار ایگزیکیوشن کو ممکن بناتی ہے ## ضروریات - Godot انجن انسٹال ہونا چاہیے - Node.js (>=18.0.0) اور npm - ایک MCP مطابق AI ایجنٹ (مثلاً Claude Code، Cursor) ## فوری آغاز Claude Code کے لیے: claude mcp add godot -- npx @coding-solo/godot-mcp Cursor کے لیے، سیٹنگز میں کمانڈ npx @coding-solo/godot-mcp کے ساتھ MCP سرور شامل کریں۔ ## کنفیگریشن ماحولیاتی متغیرات: - GODOT_PATH: Godot ایگزیکیوٹبل کا راستہ (آٹو ڈٹیکشن کو اووررائیڈ کرتا ہے) - DEBUG: تفصیلی سرور سائیڈ لاگنگ کے لیے "true" سیٹ کریں ## مسئلہ حل کرنا - **Godot نہیں ملا**: GODOT_PATH ماحولیاتی متغیر سیٹ کریں - **کنکشن مسائل**: یقینی بنائیں کہ سرور چل رہا ہے اور اپنا AI اسسٹنٹ دوبارہ شروع کریں - **غلط پروجیکٹ راستہ**: یقینی بنائیں کہ راستے میں project.godot فائل موجود ہے - **بلڈ مسائل**: انحصار انسٹال کرنے کے لیے npm install چلائیں ## لائسنس MIT لائسنس