इस प्रोजेक्ट के बारे में

अनरियल बॉक्स (UE Box) एक ओपन-सोर्स डेस्कटॉप एप्लिकेशन है, जिसे सीधे अनरियल एडिटर को संचालित करने वाले AI एजेंट के रूप में डिज़ाइन किया गया है। उपयोगकर्ता द्वारा मॉडल सेवा प्रदाता कॉन्फ़िगर करने के बाद, यह UnrealAgentLink प्लगइन के माध्यम से चल रहे अनरियल एडिटर से जुड़ता है और सौ से अधिक इंजन टूल्स तथा 25 बिल्ट-इन स्किल्स की मदद से कार्य निष्पादित करता है: Actor रखना, ब्लूप्रिंट संशोधित करना, मटीरियल कनेक्ट करना, 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 से संबद्ध नहीं है।