عن المشروع

UnrealAgentPlayer هي مجموعة أدوات مصممة لتمكين وكلاء البرمجة المعتمدين على الذكاء الاصطناعي (مثل Claude Code أو Cursor أو Claude Desktop) من التفاعل مع Unreal Editor بشكل مستقل. تتكون من إضافة للمحرر مكتوبة بلغة C++ وخادم Python MCP (Model Context Protocol)، مما يسمح للوكلاء بتنفيذ دورة كاملة من التحرير، والترجمة، والتشغيل، والتحقق من التغييرات دون تدخل بشري. تشمل القدرات الرئيسية ما يلي: - التحكم في PIE: بدء وإيقاف وتجميد واستئناف جلسات Play-In-Editor. - حقن المدخلات: حقن مدخلات لوحة المفاتيح والماوس ويد التحكم وأجهزة تحكم VR مباشرة في نافذة عرض اللعبة، بشكل مستقل عن تركيز النافذة. - المراقبة: التقاط السجلات مع التصفية، وقراءة نصوص واجهة المستخدم UMG على الشاشة، وأخذ لقطات شاشة لنافذة العرض. - الاستبطان: البحث عن الـ actors، وجلب/تعيين الخصائص، وتنفيذ نصوص Python برمجية عشوائية للمحرر أو أوامر وحدة التحكم. - تتبع الأداء: قراءة توقيتات الرسم/GPU في الوقت الفعلي وحفظ/مقارنة خطوط الأساس للأداء للكشف عن التراجعات. - إطار عمل الاختبار: الاكتشاف التلقائي لمساعدات اختبار Blueprint/C++ الخاصة بالمشروع وإنشاء تقارير تشغيل مفصلة بتنسيق HTML. - أتمتة المحرر: تشغيل قوائم المحرر الأصلية عبر Windows UIAutomation. يدعم النظام Unreal Engine 5.6 و 5.7 و 5.8 (بما في ذلك Meta 5.7 fork) على نظام Windows. وهو يستخدم Remote Control HTTP و Python Remote Execution للتواصل بين خادم MCP والمحرر.