bwapi

Die Brutkriegs -API {#bwapi}

[TOC]

Projektinformationen {#Project}

Übersicht {#Overview}

Die Brood War Application Programming Interface (BWAPI) ist ein kostenloses und Open -Source -C ++ - Framework, mit dem StarCraft: Broodwar mit der beliebten Echtzeitstrategie (RTS) -Spile interagiert wird. Mit Bwapi können Studenten, Forscher und Hobbyisten künstliche Intelligenz (KI) -Agenträger schaffen, die das Spiel spielen.

Bwapi enthüllt nur die sichtbaren Teile des Spielstatus für KI -Module standardmäßig. Informationen zu Einheiten, die in den Nebel des Krieges zurückgegangen sind, werden der KI verweigert. Auf diese Weise können Programmierer wettbewerbsfähige nicht schreibende AIs schreiben, die unter teilweise Informationsbedingungen planen und arbeiten müssen. BWAPI verweigert auch standardmäßig die Benutzereingabe und sorgt dafür, dass der Benutzer während der KI nicht die Kontrolle über Spieleinheiten übernehmen kann. Diese Standardeinstellungen können für die Flexibilität geändert werden, sofern dies nicht durch ein Turniermodul durchgesetzt wird (Game -Schiedsrichter für AI -Turniere). Geänderte Standardeinstellungen werden zu Beginn des Spiels beworben.

Funktionen {#Kapabilität}

• Schreiben Sie wettbewerbsfähige AIs für StarCraft: Broodwar, indem Sie einzelne Einheiten kontrollieren.
• Lesen Sie alle relevanten Aspekte des Spielstatus.
• Analysieren Sie Replays Frame-by-Frame-Rahmen und extrahieren Sie Trends, erstellen Sie Aufträge und gemeinsame Strategien.
• Ermitteln Sie umfassende Informationen zu den Einheitstypen, Upgrades, Technologien, Waffen und mehr.
• Studieren und Forschung in Echtzeit-AI-Algorithmen in einer robusten kommerziellen RTS-Umgebung.

Erste Schritte {#

• Einen Bot in C ++ entwickeln? Laden Sie dann die neueste Version herunter.
• Wenn Sie einen Bot in Java entwickeln möchten, folgen Sie diesem Tutorial.
• Möchten Sie Bwapi verbessern? Geben Sie den develop .

Schnellstart {#Quick-Start}

1. Installation
   1. Installieren Sie Visual Studio 2017
   2. Installieren Sie StarCraft: Brutkrieg
   3. Aktualisieren Sie StarCraft: Brutkrieg auf 1.16.1
   4. BWAPI installieren
2. Kompilieren
   1. Offene ExampleProjects.sln im BWAPI -Installationsverzeichnis
   2. Erstellen Sie das Beispielpleaimodule -Projekt im Release -Modus
   3. ExampleAIModule.dll bwapi-data/AI
3. Laufen Sie Starcraft durch den Chaoslauncher
   1. Rennen Sie Chaoslauncher.exe als Administrator
      • Der Chaoslauncher ist im Chaoslauncher -Verzeichnis von Bwapi Install Directory zu finden
   2. Überprüfen Sie den BWAPI Injector XXX [Release]
   3. Klicken Sie auf Start
      • Stellen Sie sicher, dass die Version auf StarCraft 1.16.1 eingestellt ist, nicht auf ICCup 1.16.1
4. Führen Sie ein Spiel gegen Blizzards KI durch
   1. Gehen Sie zu Einzelspieler -> Erweiterung
   2. Wählen Sie einen beliebigen Benutzer aus und klicken Sie auf OK
   3. Klicken Sie auf benutzerdefinierte Spielen , wählen Sie eine Karte aus und starten Sie ein Spiel
5. Führen Sie ein Spiel gegen sich selbst aus
   1. Run Chaoslauncher - MultiInstance.exe als Administrator
   2. Start
      1. Gehen Sie zum Multiplayer -> Expansion -> Lokaler PC
      2. Wählen Sie einen beliebigen Benutzer aus und klicken Sie auf OK
      3. Klicken Sie auf Spiel erstellen , wählen Sie eine Karte aus und klicken Sie auf OK
   3. Start - Deaktivieren
      1. Gehen Sie zum Multiplayer -> Expansion -> Lokaler PC
      2. Wählen Sie einen beliebigen Benutzer aus und klicken Sie auf OK
      3. Treten Sie dem vorhandenen Spiel des anderen Kunden bei

Wichtige Links und Kontaktinformationen {#Contact}

• Dokumentation: http://bwapi.github.io/
• Repository: https://github.com/bwapi/bwapi
• Issue Tracker: https://github.com/bwapi/bwapi/issues
• Veröffentlichungen: https://github.com/bwapi/bwapi/releases
• Sscait Discord: https://discord.gg/dqvhsq9
• IRC -Kanal: http://webchat.freenode.net/?channels=bwapi
• Facebook: https://www.facebook.com/groups/bwapi/
• Links zu Wettbewerben, Bots usw.: https://github.com/bwapi/bwapi/wiki/useful-links

Wettbewerbe {#Competition}

In verschiedenen Veranstaltungsorten veranstalten Remote -KI -Wettbewerbe, die es Entwicklern aus der ganzen Welt ermöglichen, teilzunehmen. Diese Veranstaltungsorte werden oft jährlich abgehalten und bieten den Gewinnern manchmal Preise an. Es ist auch eine großartige Möglichkeit, die Fähigkeiten Ihres Bots zu testen.

• AAAI -Konferenz über künstliche Intelligenz und interaktive digitale Unterhaltung (Aiide)
• IEEE -Konferenz über Spiele (COG)
• Student Starcraft AI (SSCAI) -Turnier
• Bwapi Bots Leiter

Ausgaben {#Issues}

Sie können Probleme haben, wenn Sie mit BWAPI arbeiten. Hier sind einige Schritte, die Sie möglicherweise befolgen möchten, um sie zu lösen.

1. Überprüfen Sie die Protokolldateien in Starcraft/Errors/ .
2. Fragen Sie im IRC -Kanal, ob jemand Ihr Problem zuvor erlebt hat.
3. Überprüfen Sie den Ausgabe -Tracker, um festzustellen, ob Ihr Problem bereits gemeldet wurde.
4. Senden Sie ein Problem an den Ausgaberleiter. Einige Informationen, die über die Übermittlung berücksichtigt werden müssen, sind

• Protokolldateien
• Screenshots
• Versions- oder Revisionsnummer
• Betriebssystem
• Schritte, um das Problem zu reproduzieren

Gehen Sie zum Ausgabe -Tracker

Legal {#legal}

Starcraft und Starcraft: Broodwar sind Marken von Blizzard Entertainment. Bwapi ist ein "Hack" von Dritten, der gegen die Endbenutzerlizenzvereinbarung (EULA) verstößt. Es wird dringend empfohlen, eine legitime Kopie von StarCraft: Broodwar von Blizzard Entertainment vor der Verwendung von BWAPI zu erwerben.