عن المشروع

Godot RL Agents هي حزمة مفتوحة المصدر بالكامل تعمل كجسر بين محرك Godot وخوارزميات التعلم الآلي القائمة على بايثون، مما يسمح لمطوري الألعاب وباحثي الذكاء الاصطناعي والهواة بتدريب سلوكيات معقدة للشخصيات غير اللاعبة (NPCs) أو الوكلاء. توفر المستودع: - واجهة بين الألعاب التي تم إنشاؤها في محرك Godot وخوارزميات التعلم الآلي التي تعمل في بايثون. - أغلفة لأربعة أطر تعلم معزز معروفة: StableBaselines3 وSample Factory وRay RLLib وCleanRL. - دعم للوكلاء القائمين على الذاكرة باستخدام واجهات LSTM أو واجهات قائمة على الانتباه. - دعم لكل من الألعاب ثنائية الأبعاد وثلاثية الأبعاد. - مجموعة من أجهزة استشعار الذكاء الاصطناعي لتعزيز قدرة الوكيل على ملاحظة عالم اللعبة. - Godot وGodot RL Agents مجانيان ومفتوحان المصدر بالكامل بموجب ترخيص MIT المتساهل. المشروع موثق في ورقة بحثية لورشة عمل AAAI-2022 (arXiv:2112.03636). ## دليل البدء السريع دليل البدء السريع يساعد المستخدمين على البدء مع خلفية StableBaselines3، التي تدعم ويندوز وماك ولينكس. يتوفر أيضًا برنامج تعليمي بالفيديو. ### التثبيت والتدريب الأول 1. تثبيت المكتبة: `pip install godot-rl` 2. تنزيل بيئات الأمثلة من المركز، على سبيل المثال: `gdrl.env_from_hub -r edbeeching/godot_rl_JumperHard` 3. إضافة أذونات التشغيل للملف التنفيذي للعبة إذا لزم الأمر. 4. التدريب والتصور باستخدام سكربت مثال Stable Baselines 3: ```bash python examples/stable_baselines3_example.py --env_path=examples/godot_rl_JumperHard/bin/JumperHard.x86_64 --experiment_name=Experiment_01 --viz ``` ### التدريب التفاعلي داخل المحرر يمكن للمستخدمين أيضًا تدريب الوكلاء مباشرة في محرر Godot دون تصدير الملف التنفيذي للعبة. تتضمن الخطوات تنزيل إصدار Godot 4 .NET، واستيراد مشروع المثال، وتشغيل سكربت التدريب. ### الدروس التعليمية - درس البيئة المخصصة - درس البيئة البسيطة باستخدام أجهزة استشعار جديدة - درس لعبة عبور الطريق المصغرة - درس التعلم بالمحاكاة ### تصدير وتحميل الوكلاء المدربين بتنسيق ONNX توفر أحدث إصدارات دعمًا تجريبيًا لنماذج ONNX مع Stable Baselines 3 وRLLib وCleanRL. يمكن للمستخدمين تصدير نموذج مدرب وتحميله في محرر Godot باستخدام إصدار mono والمكوّن الإضافي. ## الاستخدام المتقدم يدعم Godot RL Agents أربعة أطر تدريب تعلم معزز مختلفة، لكل منها أدلة مفصلة: - StableBaselines3 (ويندوز، ماك، لينكس) - SampleFactory (ماك، لينكس) - CleanRL (ويندوز، ماك، لينكس) - Ray RLLib (ويندوز، ماك، لينكس) ## المساهمة المساهمات مرحب بها، بما في ذلك البيئات الجديدة، وتحسينات ملف README، وإضافات إلى قاعدة كود بايثون. تتضمن العملية عمل fork للمستودع، واستنساخه، وإنشاء بيئة افتراضية، وإجراء تثبيت قابل للتحرير. يمكن تشغيل الاختبارات باستخدام `make test`، وتنسيق الكود باستخدام `make style` و`make quality`. ## الأسئلة الشائعة - **لماذا تطوير Godot RL Agents؟** لتوفير أداة مجانية ومفتوحة المصدر لأبحاث التعلم المعزز العميق وتطوير الألعاب، وتمكين سلوكيات NPC فريدة، والسماح باختبار اللعب الآلي. - **كيف تساهم؟** جرّبه، واعثر على الأخطاء، وارفع القضايا، أو أرسل طلبات السحب. - **دعم ماك؟** يجب أن يعمل الآن. - **التشابه مع Unity ML Agents؟** مستوحى من Unity ML Agents ولكنه يهدف إلى أن يكون أكثر إحكامًا وإيجازًا وقابلية للتعديل مع قدر أقل من التجريد. - **تجميد دوري أثناء التدريب؟** طبيعي مع سكربت SB3 الافتراضي أثناء تحديث النموذج؛ التصدير إلى ONNX يسمح باستدلال أسرع. ## الترخيص Godot RL Agents مرخص بموجب MIT. أصل "Cartoon Plane" مرخص بموجب Creative Commons Attribution. ## الاستشهاد يتم توفير إدخال BibTeX للاستشهاد بالورقة البحثية. ## الإقرارات شكرًا لمؤلفي محرك Godot، ومطوري Sample Factory وCleanRL وRay وStable Baselines، ومبتكري Unity ML Agents Toolkit للإلهام.