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

虚幻盒子 (UE Box) ایک اوپن سورس ڈیسک ٹاپ ایپلیکیشن ہے، جس کی حیثیت براہ راست虚幻 ایڈیٹر کو چلانے والے AI ایجنٹ کی ہے۔ صارف کے ماڈل سروس فراہم کنندہ کو کنفیگر کرنے کے بعد، یہ UnrealAgentLink پلگ ان کے ذریعے چل رہے虚幻 ایڈیٹر سے جڑتا ہے اور سو سے زائد انجن ٹولز اور 25 بلٹ ان مہارتوں کی مدد سے کام انجام دیتا ہے: ایکٹر رکھنا، بلیو پرنٹ میں تبدیلی، میٹریل جوڑنا، C++ کمپائل کرنا وغیرہ۔ معمول کے کام براہ راست انجام دیے جاتے ہیں، جبکہ خطرناک کام عارضی طور پر روک کر صارف کی تصدیق کا انتظار کرتے ہیں؛ کام مکمل ہونے کے بعد ایجنٹ صرف پڑھنے والے ٹولز سے انجن میں واپس جا کر تبدیلیوں کی تصدیق کرتا ہے اور پائے گئے مسائل کا ایک ایک کر کے جواب دیتا ہے۔ دائرہ کار میں لیول، بلیو پرنٹ، میٹریل، اثاثے، C++ کے علاوہ اینیمیشن ری ٹارگٹنگ، UMG، Sequencer کیمرہ، PIE رن ٹائم تصدیق، جیومیٹری ایڈیٹنگ اور پروجیکٹ ہیلتھ چیک بھی شامل ہیں۔ مصنوعات کا مرکزی حصہ ایجنٹ ہے، پروجیکٹ لائبریری، اثاثہ لائبریری، بلیو پرنٹ لائبریری اور میٹریل لائبریری، نوٹس اور نالج بیس کے الگ الگ انٹرفیس ہیں، جو الگ سے بھی استعمال کیے جا سکتے ہیں، لیکن مصنوعات کی ساخت میں ایجنٹ کی خدمت کرتے ہیں: ہدف کا اندراج، مواد فراہم کرنا، اور نتائج وصول کرنا۔ یہ ریپوزٹری کمیونٹی کور ورژن ہے: اکاؤنٹ کی ضرورت نہیں، سرکاری سرور پر انحصار نہیں، مکمل طور پر خود بنایا جا سکتا ہے۔ شروع کرنے کا عمل: GitHub Releases یا سرکاری ویب سائٹ سے ڈاؤن لوڈ اور انسٹال کریں (Windows)، سیٹنگز میں ماڈل سروس فراہم کنندہ شامل کریں اور اپنی API Key درج کریں، ڈیفالٹ چیٹ ماڈل کو اسی کی طرف اشارہ کریں؛ ماڈل کو ٹول کالنگ کی سہولت ہونی چاہیے۔ مقامی انفرنس (Ollama، LM Studio، llama.cpp) اور خود ساختہ گیٹ وے (LiteLLM، One API) کی سہولت موجود ہے۔ اس کے بعد پروجیکٹ لائبریری میں .uproject درآمد کریں، کنیکشن پلگ ان خود بخود پروجیکٹ کی Plugins/UnrealAgentLink/ ڈائریکٹری میں انسٹال ہو جائے گا، جسے بند یا ہٹایا جا سکتا ہے۔ پروجیکٹ کھولنے کے بعد پلگ ان خود بخود جڑ جاتا ہے، سائیڈ بار AI سیشن میں پہلے صرف پڑھنے والے سوالات (جیسے لیول میں روشنی کے ذرائع کی تعداد) سے کنیکشن کی تصدیق کی جا سکتی ہے۔ Codex، Claude Code یا Cursor استعمال کرنے والے صارفین MCP سوئچ آن کر کے虚幻盒子 کو ٹول سروس کے طور پر شامل کر سکتے ہیں، جس سے سو سے زائد UE ٹولز دستیاب ہو جاتے ہیں؛ MCP صرف مقامی طور پر جڑ سکتا ہے، ٹوکن درکار ہے، ڈیفالٹ میں لکھنے کی اجازت ہے۔ نیٹ ورک اور ڈیٹا کے حوالے سے: اکاؤنٹ استعمال نہیں ہوتا، کلیدیں مقامی طور پر خفیہ محفوظ ہوتی ہیں، درخواستیں براہ راست صارف کے کنفیگر کردہ سروس فراہم کنندہ تک جاتی ہیں، پروجیکٹ فریق کے سرور سے نہیں گزرتیں۔ ڈیفالٹ میں صرف اپ ڈیٹ کی جانچ ہوتی ہے، ڈاؤن لوڈ نہیں؛ خود پیک کی گئی اور اپ ڈیٹ ذریعہ نہ بھری گئی بلڈز کوئی نیٹ ورک درخواست نہیں بھیجتیں۔ AI، آن لائن تلاش، تصویر سازی، کلاؤڈ اسٹوریج وغیرہ کی سہولیات ضرورت کے مطابق جڑتی ہیں، مقامی ماڈل استعمال کرنے پر AI ڈیٹا مشین سے باہر نہیں جاتا۔ پلیٹ فارم سپورٹ: Windows کے لیے انسٹالر دستیاب ہے، انجن کی دریافت اور پہلے سے کمپائل شدہ UnrealAgentLink پلگ ان کی سہولت موجود ہے، یہی مرکزی پلیٹ فارم ہے؛ macOS کے لیے سورس بلڈ درکار ہے، عام مشترکہ انسٹالیشن ڈائریکٹریوں میں انجن اسکین کیے جا سکتے ہیں، انجن ڈائریکٹری یا ایڈیٹر .app دستی طور پر بھی شامل کی جا سکتی ہے، اور چل رہے UE4/UE5 ایڈیٹرز اور ان کے پروجیکٹ پاتھ کا پتہ لگایا جا سکتا ہے، پہلے سے کمپائل شدہ پلگ ان کی بلڈ اور ریلیز کی منظوری ابھی مکمل نہیں ہوئی؛ Linux کے لیے سورس بلڈ درکار ہے، انجن کی دریافت ابھی موافق نہیں بنائی گئی۔ ٹیک اسٹیک Electron + Vue 3 + TypeScript ہے، جو Unreal Engine 5.0 سے 5.8 تک کی سہولت دیتا ہے۔ سورس سے چلانے کے لیے pnpm install اور pnpm dev استعمال کریں؛ جمع کرانے سے پہلے pnpm verify چلائیں، ایک ہی کمانڈ میں کلید اسکین، lint، تبدیل شدہ لائنوں کی lint، ٹائپ چیک اور یونٹ ٹیسٹ انجام پاتے ہیں، اور یہ ایپلیکیشن چلنے کے دوران بھی چلائی جا سکتی ہے۔ ریپوزٹری AI کوڈنگ اسسٹنٹس کے لیے AGENTS.md کی تفصیلات اور منظوری گیٹ فراہم کرتی ہے، صارف قدرتی زبان میں ضرورت بیان کر سکتا ہے اور AI اسسٹنٹ کو آرکیٹیکچر پڑھنے، کوڈ تبدیل کرنے، ٹیسٹ شامل کرنے اور تصدیق مکمل کرنے دے سکتا ہے۔ لائسنس: ایپلیکیشن Apache License 2.0 کے تحت ہے، UnrealAgentLink پلگ ان کا سورس کوڈ plugin/UnrealAgentLink میں موجود ہے اور الگ MIT لائسنس کے تحت ہے۔ Unreal Engine Epic Games, Inc. کا ٹریڈ مارک ہے، یہ پروجیکٹ Epic Games سے وابستہ نہیں۔