bwapi

The Brood War API {#bwapi}

[TOC]

معلومات المشروع {#project}

نظرة عامة {#overview}

واجهة برمجة تطبيقات حرب Brood War (BWAPI) هي إطار عمل مجاني ومفتوح المصدر C ++ يستخدم للتفاعل مع لعبة StarCraft في الوقت الحقيقي (RTS): Brodwar. باستخدام BWAPI ، يمكن للطلاب والباحثين والهواة إنشاء وكلاء الذكاء الاصطناعي (AI) الذين يلعبون اللعبة.

يكشف BWAPI فقط عن الأجزاء المرئية من حالة اللعبة إلى وحدات الذكاء الاصطناعي افتراضيًا. يتم رفض المعلومات عن الوحدات التي عادت إلى ضباب الحرب إلى الذكاء الاصطناعي. يمكّن ذلك المبرمجين من كتابة AIS غير التنافسية التي يجب أن تخطط وتعمل في ظل ظروف المعلومات الجزئية. يحرم BWAPI أيضًا إدخال المستخدم بشكل افتراضي ، مما يضمن أن المستخدم لا يمكنه التحكم في وحدات اللعبة أثناء تشغيل الذكاء الاصطناعي. يمكن تغيير هذه الإعدادات الافتراضية للمرونة ، ما لم يتم فرضها بواسطة وحدة بطولة (حكم اللعبة لبطولات الذكاء الاصطناعي). سيتم الإعلان عن الإعدادات الافتراضية المتغيرة عندما تبدأ المباراة.

القدرات {#capability}

• اكتب AIS التنافسية لـ StarCraft: Broodwar عن طريق التحكم في الوحدات الفردية.
• اقرأ جميع الجوانب ذات الصلة لحالة اللعبة.
• تحليل إعادة الإطار كلها الإطار ، واستخراج الاتجاهات ، بناء أوامر ، والاستراتيجيات المشتركة.
• احصل على معلومات شاملة عن أنواع الوحدات والترقيات والتقنيات والأسلحة والمزيد.
• دراسة وبحث خوارزميات الذكاء الاصطناعي في الوقت الحقيقي في بيئة RTS التجارية القوية.

البدء {#ابدأ}

• تطوير روبوت في C ++؟ ثم قم بتنزيل أحدث إصدار.
• إذا كنت ترغب في تطوير روبوت في جافا ، فيرجى اتباع هذا البرنامج التعليمي.
• تريد المساعدة في تحسين BWAPI؟ شوكة فرع develop .

بداية سريعة {#Quick-Start}

1. تثبيت
   1. تثبيت Visual Studio 2017
   2. تثبيت StarCraft: حرب الحضنة
   3. تحديث Starcraft: حرب الحضنة إلى 1.16.1
   4. تثبيت BWAPI
2. ترجمة
   1. فتح ExampleProjects.sln في دليل تثبيت BWAPI
   2. بناء مشروع exampleaimodule في وضع الإصدار
   3. نسخ ExampleAIModule.dll إلى bwapi-data/AI داخل مجلد تثبيت starcraft
3. قم بتشغيل StarCraft عبر Chaoslauncher
   1. Run Chaoslauncher.exe كمسؤول
      • تم العثور على Chaoslauncher في دليل ChaoSlauncher من دليل تثبيت BWAPI
   2. تحقق من حاقن BWAPI XXX [الإصدار]
   3. انقر فوق ابدأ
      • تأكد من تعيين الإصدار على StarCraft 1.16.1 ، وليس ICCUP 1.16.1
4. قم بتشغيل لعبة ضد بليزارد من الذكاء الاصطناعي
   1. انتقل إلى لاعب واحد -> التوسع
   2. حدد أي مستخدم وانقر فوق "موافق"
   3. انقر فوق تشغيل مخصص ، وحدد خريطة ، وابدأ لعبة
5. قم بتشغيل لعبة ضد نفسك
   1. Run Chaoslauncher - MultiInstance.exe كمسؤول
   2. يبدأ
      1. انتقل إلى multiplayer -> التوسع -> الكمبيوتر المحلي
      2. حدد أي مستخدم وانقر فوق "موافق"
      3. انقر فوق إنشاء لعبة ، وحدد خريطة ، وانقر فوق "موافق"
   3. ابدأ - قم بإلغاء تحديد حاقن BWAPI XXX [إطلاق] للسماح للعب البشري ، اترك بمفردك لجعل الذكاء الاصطناعى تلعب نفسه
      1. انتقل إلى multiplayer -> التوسع -> الكمبيوتر المحلي
      2. حدد أي مستخدم وانقر فوق "موافق"
      3. انضم إلى اللعبة الحالية التي أنشأها العميل الآخر

روابط مهمة ومعلومات الاتصال {#Contact}

• الوثائق: http://bwapi.github.io/
• المستودع: https://github.com/bwapi/BWAPI
• تعقب المشكلات: https://github.com/bwapi/bwapi/issues
• الإصدارات: https://github.com/bwapi/Bwapi/Releases
• SSCait Discord: https://discord.gg/dqvhsq9
• قناة IRC: http://webchat.freenode.net/؟channels=bwapi
• Facebook: https://www.facebook.com/groups/bwapi/
• روابط إلى المسابقات ، الروبوتات ، إلخ

المسابقات {#Competition}

تستضيف مختلف الأماكن مسابقات منظمة العفو الدولية عن بُعد التي تسمح للمطورين من جميع أنحاء العالم بالمشاركة. غالبًا ما تقام هذه الأماكن سنويًا وستقدم أحيانًا جوائز للفائزين. إنها أيضًا طريقة رائعة لاختبار قدرات الروبوت الخاصة بك.

• مؤتمر AAAI للذكاء الاصطناعي والترفيه الرقمي التفاعلي (AIIDE)
• مؤتمر IEEE على الألعاب (COG)
• بطولة الطالب StarCraft AI (SSCAI)
• BWAPI BOTS LADDER

القضايا {#issues}

قد تواجه مشكلات عند العمل مع BWAPI. فيما يلي بعض الخطوات التي قد ترغب في متابعتها من أجل حلها.

1. تحقق من ملفات السجل الموجودة في Starcraft/Errors/ .
2. اسأل في قناة IRC إذا كان أي شخص قد عانى مشكلتك من قبل.
3. تحقق من تعقب المشكلة لمعرفة ما إذا كان قد تم الإبلاغ عن مشكلتك بالفعل.
4. إرسال مشكلة إلى تعقب القضية. بعض المعلومات التي يجب مراعاتها هي

• ملفات السجل
• لقطات الشاشة
• إصدار أو رقم المراجعة
• نظام التشغيل
• خطوات لإعادة إنتاج المشكلة

انتقل إلى تعقب القضية

قانوني {#Legal}

Starcraft و Starcraft: Broodwar هي علامات تجارية لترفيه Blizzard. BWAPI هي طرف ثالث "اختراق" ينتهك اتفاقية ترخيص المستخدم النهائي (EULA). يوصى بشدة بشراء نسخة مشروعة من StarCraft: Broodwar من Blizzard Entertainment قبل استخدام BWAPI.