commandcenter

commandcenter : AI Bot لـ Broodwar وStarcraft II

commandcenter هو روبوت StarCraft AI يمكنه تشغيل كل من StarCraft: Broodwar وStarCraft 2.

تمت كتابة commandcenter بلغة C++ باستخدام BWAPI وBlizzard's StarCraft II AI API. يوفر العديد من وظائف التغليف حول كلا واجهات برمجة التطبيقات التي تسمح له بأداء نفس الوظيفة في كلتا اللعبتين عبر نفس كود المصدر. كتبه ديفيد تشرشل، الأستاذ المساعد لعلوم الكمبيوتر في جامعة ميموريال، ومنظم مسابقة AIIDE StarCraft AI.

يعتمد commandcenter على بنية UAlbertaBot، ويهدف إلى أن يكون بنية سهلة الاستخدام لتتمكن من تعديل الروبوت الخاص بك واللعب به وبناءه بسرعة. لا يحتوي الروبوت نفسه على الكثير من الاستراتيجيات أو التكتيكات المضمنة، ولكنه يوفر نقطة انطلاق جيدة لك لتنفيذ استراتيجياتك الخاصة لأي سباق.

يوفر commandcenter حاليا الميزات التالية:

• تشغيل لعبتي Starcraft بنفس كود المصدر
• تلعب جميع السباقات الثلاثة باستخدام وحدات تحكم دقيقة معممة للوحدات القتالية
• يقوم بتحليل الخرائط عبر الإنترنت، واستخراج المعلومات مثل مواقع القواعد والتوسعات
• يتتبع جميع وحدات العدو التي تمت رؤيتها سابقًا وآخر مواقعها المعروفة على الخريطة
• لديه WorkerManager الذي يدير جمع الموارد وتخصيص / بناء العمال
• قادر على تنفيذ أوامر البناء المحددة مسبقًا والمكتوبة في ملف التكوين
• يتيح لك إنشاء أوامر البناء الخاصة بك بسهولة وتعديلها أثناء التنقل داخل اللعبة
• يحتوي على خوارزمية تحديد موضع المبنى، للعثور على أقرب موقع قابل للبناء إلى موضع معين لمبنى معين
• يستكشف الخريطة باستخدام وحدة عاملة، ويكتشف مكان قاعدة العدو
• بمجرد الوصول إلى حالة معينة (وجود 12 وحدة قتالية افتراضيًا)، سيبدأ الهجوم، ويرسل موجات من الوحدات إلى قاعدة العدو
• يمكن تشكيل فرق تتكون من وحدات متعددة تتبع أمرًا محددًا مثل الهجوم أو الدفاع عن موقع معين

يجب أن يتمتع commandcenter في النهاية بجميع وظائف UAlbertaBot، إلا أن الكثير من ميزاته لم تكتمل حاليًا. فيما يلي قائمة محدثة بالميزات المفقودة حاليًا من commandcenter والتي سيتم تنفيذها قريبًا:

• يمكن إنشاء الوحدات والمباني الأساسية فقط عبر مدير الإنتاج. لا توجد إضافات أو أبحاث أو ترقيات حتى الآن.
• لا يوجد نظام تخطيط تلقائي لأمر البناء
• لا توجد حزمة محاكاة قتالية للتنبؤ بانتصار المعركة القتالية
• يلعب الروبوت فقط في وضع 1 ضد 1، وسيكون له سلوك/تعطل غير محدد إذا تم اللعب ضد أعداء متعددين أو ضمن فرق

تنزيل وتشغيل commandcenter

StarCraft BW: يجب أن يكون لديك الإصدار 1.16.1 من StarCraft: Broodwar مثبتًا، بالإضافة إلى BWAPI.

StarCraft 2: يجب أن يكون لديك إصدار تجزئة محدث من StarCraft II مثبتًا لتشغيل الروبوت. يجب عليك أيضًا تنزيل وتثبيت بعض الخرائط لاستخدامها مع الروبوت، والتي يمكنك العثور عليها هنا: https://github.com/Blizzard/s2client-proto#downloads. يرجى ملاحظة أن هناك كلمة مرور متوفرة في تلك الصفحة لاستخراج الخرائط من الملفات المضغوطة.

يأتي الروبوت مزودًا بملف تكوين يسمى BotConfig.txt حيث يمكنك تعديل أوامر البناء وطباعة معلومات تصحيح الأخطاء المختلفة على الشاشة وتعيين بعض معلمات الروبوت. يمكنك تحديد أوامر إنشاءات متعددة في قسم "الاستراتيجيات" بالملف، واختيار الإستراتيجية المسماة التي سيتم تنفيذها عندما يلعب الروبوت سباقًا محددًا. أسماء الوحدات في أمر البناء حساسة لحالة الأحرف، ويجب أن تكون مطابقة تمامًا لما تظهر عليه في اللعبة بدون مسافات. بعض الخيارات الموجودة في ملف التكوين غير مطبقة حاليًا، مثل خيار KiteWithRangedUnits.

يرجى ملاحظة أن ملف التكوين هذا بتنسيق JSON، ولن يعمل الروبوت إلا إذا كان بتنسيق JSON جيدًا. يجب أن يكون ملف التكوين في نفس الدليل مثل commandcenter .exe حتى يعمل الروبوت بشكل صحيح. إذا ارتكبت خطأً في بناء جملة JSON ولم تتمكن من العثور عليه بنفسك، فيمكنك استخدام JSON Validator عبر الإنترنت للتحقق منك.

افتراضيًا، عند تشغيل commandcenter .exe، سيتم تشغيله كسباق عشوائي مقابل سباق عشوائي مدمج في SC2 Easy AI. يمكنك تعديل السباقات التي سيتم لعبها في ملف التكوين عبر خيارات "BotRace" و"EnemyRace". يمكنك أيضًا تعديل الخريطة التي سيتم تشغيلها عن طريق تحديد خيار "MapFile". يرجى ملاحظة أن خيار MapFile مرتبط بدليل خرائط StarCraft II الخاص بك، والذي يقع افتراضيًا في StarCraft_Install_Directory/maps/، ولن يعمل الروبوت دون تحديد ملف خريطة صالح.

إذا تعطل الروبوت أو قام بأشياء سيئة أخرى، فيرجى التحمل بينما أجعله أكثر استقرارًا :)

تعليمات تثبيت/تجميع المطورين (Windows)

• تحميل وتثبيت فيجوال ستوديو 2017
• للعب BW، يجب عليك تنزيل وتثبيت StarCraft BW v1.16.1 بالإضافة إلى BWAPI
• للعب SC2، يجب عليك تنزيل وتثبيت StarCraft II AI API. أسهل طريقة للقيام بذلك هي تنزيل المكتبات المترجمة مسبقًا في أسفل الصفحة، ثم استخراجها ببساطة إلى مجلد على جهاز الكمبيوتر الخاص بك. إذا كنت تحصل على SC2API عبر استنساخ Blizzard github repo وتجميعه من البداية، فقد تحتاج إلى توجيه VS إلى أدلة مختلفة للتضمين وlib غير تلك الموضحة أدناه.
• انسخ مستودع git هذا إلى مجلد على جهاز الكمبيوتر الخاص بك
• افتح " commandcenter /vs/ commandcenter .sln" في VS2017
• إذا قمت بتجميع مشروع commandcenter باستخدام النظام الأساسي x64، فسوف يقوم بتجميع روبوت SC2
• إذا قمت بتجميع مشروع commandcenter باستخدام النظام الأساسي x86 أو Win32، فسوف يقوم بتجميع روبوت BW
• قم بتعيين مجلدات VS Project ومجلدات lib للإشارة إلى الدلائل
  • انقر بزر الماوس الأيمن فوق مشروع commandcenter في VS2017
  • حدد "الخصائص"
  • حدد التكوين الصحيح الذي تريد إنشاءه في الجزء العلوي الأيسر ("الإصدار" أو "التصحيح")
  • حدد النظام الأساسي المستهدف الذي تريد إنشاءه (x64 = SC2، Win32 = BW)
  • حدد "أدلة VC++" على اليسار
  • حدد خيار "تضمين الدلائل" في الجدول الموجود على اليمين
  • انقر فوق سهم القائمة المنسدلة الموجود على اليمين ثم انقر فوق "تحرير"...
  • قم بتعديل إدخال الدليل الموجود للإشارة إلى دليل (SC2API|BWAPI)/التضمين الخاص بك
  • حدد خيار "دلائل المكتبات" في الجدول الموجود على اليمين
  • انقر فوق سهم القائمة المنسدلة الموجود على اليمين ثم انقر فوق "تحرير"...
  • قم بتعديل إدخال الدليل الموجود للإشارة إلى دليل (SC2API|BWAPI)/lib الخاص بك
• من القائمة "إنشاء"، انقر فوق "إنشاء الحل"
• يجب أن يظهر " commandcenter _API.exe" الثنائي في دليل commandcenter /bin/
• قم بتشغيل روبوت commandcenter إما عن طريق:
  • انقر نقرًا مزدوجًا فوق الملف القابل للتنفيذ في دليل commandcenter /bin/
  • تشغيل البرنامج من وحدة التحكم
  • انقر فوق "Local Windows Debugger" في VS لتشغيل البرنامج من داخل VS. للقيام بذلك، تحتاج إلى تعيين خيار "دليل العمل" ضمن "تصحيح الأخطاء" على "$(ProjectDir)/../bin/" (لا أعرف سبب عدم حفظ هذا الخيار)
• إذا كنت تقوم بتشغيل إصدار BW من الروبوت، فيجب عليك بعد ذلك بدء BW عبر Chaoslauncher مع حقن BWAPI
• يجب أن يكون ملف commandcenter /bin/BotConfig.txt في نفس الدليل مثل ملف .exe ليعمل بشكل صحيح

تعليمات تثبيت/تجميع المطورين (Linux وOS X)

من خلال هذه الخطوات، من المفترض أن تكون قادرًا على إنشاء واجهة برمجة تطبيقات SC2 وتثبيتها وإدراجها في commandcenter . لقد تم اختباره بنجاح لـ aba2d3813571c344090f3de5b58a5c912cd5acb3، لذلك إذا لم تنجح تعليمات التثبيت أدناه، فاطلع على هذا الإصدار من SC2 API

$ git checkout aba2d3813571c344090f3de5b58a5c912cd5acb3 .

وكرر التعليمات.

• بناء مشروع SC2 API

$ git clone --recursive https://github.com/Blizzard/s2client-api && cd s2client-api
$ mkdir build && cd build
$ cmake ../
$ make

• قم بتثبيت مكتبات ورؤوس SC2 API على نظامك

 # Assuming that you are located in the 'build' directory
# after you finished the previous step
$ cd ../

# Install SC2 API headers
$ sudo mkdir -p /opt/local/include
$ sudo cp -R include/{sc2api,sc2renderer,sc2utils} /opt/local/include
$ sudo cp -R build/generated/s2clientprotocol /opt/local/include

# Install protobuf headers
$ sudo cp -R contrib/protobuf/src/google /opt/local/include/sc2api

# Install SC2 API libraries
$ sudo mkdir -p /opt/local/lib/sc2api
$ sudo cp build/bin/{libcivetweb,libprotobuf,libsc2api,libsc2lib,libsc2protocol,libsc2utils}.a /opt/local/lib/sc2api

• قم ببناء الروبوت

$ git clone https://github.com/davechurchill/commandcenter.git && cd commandcenter
$ cmake .
$ make

تطوير الروبوت

إذا كنت معتادًا على بنية UAlbertaBot، فإن منطق commandcenter مشابه تمامًا. يتمثل الاختلاف الأكبر في أن المعلومات المتعلقة بالخريطة والموقع الأساسي وما إلى ذلك لم تعد متاحة عالميًا. توجد هذه البيانات الآن داخل فئة CCBot الرئيسية، ويجب الوصول إليها عبر مرجع إلى مثيل تلك الفئة. ولهذا السبب، تحمل معظم الفئات الموجودة في commandcenter إشارة إلى كائن CCBot الرئيسي للروبوت، والذي يمكن من خلاله إنشاء جميع المعلومات والملاحظات والاستعلامات المتعلقة باللعبة.

سيتم إصدار دليل تطوير متعمق قريبًا، ولكن يرجى الرجوع إلى UAlbertaBot wiki في الوقت الحالي نظرًا لأن البنية متشابهة جدًا (باستثناء مخطط أمر البناء ومحاكي القتال).