عن المشروع

Unreal Box (UE Box) هو تطبيق مفتوح المصدر لسطح المكتب، ويُعرَّف كعامل ذكاء اصطناعي (AI Agent) يعمل مباشرة على محرر Unreal. بعد أن يكوّن المستخدم مزود خدمة النماذج، يتصل التطبيق بمحرر Unreal الجاري تشغيله عبر إضافة UnrealAgentLink، ويستخدم أكثر من مئة أداة للمحرك و25 مهارة مدمجة لتنفيذ المهام: وضع الأصول (Actors)، تعديل المخططات (Blueprints)، ربط المواد (Materials)، ترجمة C++، وغيرها. تُنفَّذ العمليات الروتينية مباشرة، بينما تتوقف العمليات الخطرة مؤقتًا بانتظار تأكيد المستخدم؛ وبعد اكتمال المهمة، يستخدم العامل أدوات قراءة فقط للعودة إلى المحرك للتحقق من التغييرات، والرد على أي مشكلات مكتشفة عنصرًا بعنصر. نطاق التغطية لا يقتصر على المستويات والمخططات والمواد والأصول وC++، بل يشمل أيضًا إعادة توجيه الرسوم المتحركة، وUMG، وكاميرات Sequencer، والتحقق من التشغيل عبر PIE، وتحرير الهندسة، وفحص صحة المشروع. المنتج الأساسي هو العامل، بينما تحتوي مكتبات المشاريع والأصول والمخططات والمواد، بالإضافة إلى الملاحظات وقاعدة المعرفة، على واجهات مستقلة ويمكن استخدامها منفردة، لكنها في بنية المنتج تخدم العامل: تسجيل الأهداف، توفير المواد، واستقبال المخرجات. هذا المستودع هو الإصدار المجتمعي الأساسي: لا يتطلب حسابًا، ولا يعتمد على خوادم رسمية، ويمكن بناؤه بالكامل ذاتيًا. خطوات البدء: قم بالتنزيل والتثبيت من إصدارات GitHub أو الموقع الرسمي (لنظام Windows)، ثم أضف مزود خدمة النماذج في الإعدادات وأدخل مفتاح API الخاص بك، ووجّه نموذج المحادثة الافتراضي إليه؛ يجب أن يدعم النموذج استدعاء الأدوات. يدعم التطبيق الاستدلال المحلي (Ollama، LM Studio، llama.cpp) والبوابات ذاتية الاستضافة (LiteLLM، One API). بعد ذلك، استورد ملف .uproject في مكتبة المشاريع، وسيتم تثبيت إضافة الاتصال تلقائيًا في دليل Plugins/UnrealAgentLink/ الخاص بالمشروع، ويمكن تعطيلها أو إزالتها. بعد فتح المشروع، تتصل الإضافة تلقائيًا، ويمكنك في جلسة الذكاء الاصطناعي الجانبية استخدام أسئلة للقراءة فقط (مثل عدد مصادر الضوء في المستوى) للتأكد من الاتصال. يمكن للمستخدمين الذين استخدموا Codex أو Claude Code أو Cursor تفعيل مفتاح MCP، واستخدام Unreal Box كخدمة أدوات، مما يتيح الوصول إلى أكثر من مئة أداة UE؛ يتصل MCP محليًا فقط، ويتطلب رمزًا مميزًا، وهو قابل للكتابة افتراضيًا. فيما يتعلق بالشبكة والبيانات: لا يُستخدم حساب، ويتم تخزين المفاتيح مشفرة محليًا، وتصل الطلبات مباشرة إلى مزود الخدمة الذي يحدده المستخدم، دون المرور عبر خوادم المشروع. افتراضيًا، يتم التحقق من التحديثات فقط دون تنزيل؛ والبنيات المخصصة التي لا تحتوي على مصدر تحديث لن ترسل أي طلبات شبكة. تتصل وظائف الذكاء الاصطناعي والبحث عبر الإنترنت وتوليد الصور والتخزين السحابي عند الحاجة، وعند استخدام نموذج محلي، لا تخرج بيانات الذكاء الاصطناعي من الجهاز. دعم المنصات: يوفر Windows حزمة تثبيت، ويدعم اكتشاف المحركات وإضافة UnrealAgentLink المترجمة مسبقًا، وهو المنصة الرئيسية؛ يتطلب macOS البناء من المصدر، ويمكنه فحص المحركات في أدلة التثبيت الشائعة، أو إضافة أدلة المحركات أو ملف .app للمحرر يدويًا، ويمكنه اكتشاف محررات UE4/UE5 قيد التشغيل ومسارات مشاريعها، لكن بناء الإضافة المترجمة مسبقًا والتحقق من الإصدار لم يكتمل بعد؛ يتطلب Linux البناء من المصدر، ولم يتم تكييف اكتشاف المحركات بعد. المكدس التقني هو Electron + Vue 3 + TypeScript، ويدعم Unreal Engine 5.0 حتى 5.8. للتشغيل من المصدر، استخدم pnpm install و pnpm dev؛ قبل الالتزام، شغّل pnpm verify، وهو أمر واحد ينفذ فحص المفاتيح، والفحص اللغوي، وفحص الأسطر المعدلة، والتحقق من الأنواع، واختبارات الوحدة، ويمكن تشغيله أثناء عمل التطبيق. يوفر المستودع ملف AGENTS.md مع مواصفات وبوابات قبول موجهة لمساعدي البرمجة بالذكاء الاصطناعي، ويمكن للمستخدمين وصف المتطلبات بلغة طبيعية، والسماح للمساعد بقراءة البنية، وتعديل الكود، وإضافة الاختبارات، وتشغيل التحقق. الترخيص: التطبيق مرخص بموجب Apache License 2.0، بينما يقع كود إضافة UnrealAgentLink في plugin/UnrealAgentLink ويخضع لترخيص MIT مستقل. Unreal Engine علامة تجارية لشركة Epic Games, Inc.، وهذا المشروع ليس له أي انتماء لشركة Epic Games.