Как написать бота для starcraft 2

MicroMachine: AI Bot for StarCraft II

This bot is built on top of CommandCenter, a popular C++ bot that is great for beginners. The main improvements over CommandCenter is the micro management of units in combat, notably the focus fire, dancing and kiting. The current strategy is to rush with Marines with the Terran race and hope that the great micro management will be enough to overcome the defenses of the enemy early in the game.

CommandCenter: AI Bot for Broodwar and Starcraft II

CommandCenter is a StarCraft AI bot that can play both StarCraft: Broodwar and StarCraft 2.

CommandCenter is written in C++ using BWAPI and Blizzard’s StarCraft II AI API. It provides many wrapper functions around both APIs that allow it to perform the same functionality in both games via the same source code. It is written by David Churchill, Assistant Professor of Computer Science at Memorial University, and organizer of the AIIDE StarCraft AI Competition.

CommandCenter is based on the architecture of UAlbertaBot, and is intended to be an easy to use architecture for you to quickly modify, play with, and build your own bot. The bot itself does not contain much in the way of hard-coded strategy or tactics, however it provides a good starting point for you to implement your own strategies for any race.

CommandCenter currently provides the following features:

• Plays both Starcraft games with the same source code
• Plays all 3 races with generalized micro controllers for combat units
• Performs online map analysis, extracting information such as base locations and expansions
• Keeps track of all previously seen enemy units and their last known locations on the map
• Has a WorkerManager which manages resource gathering and worker allocation / buiding
• Is able to carry out predefined build-orders written in a configuration file
• Allows you to easily create your own build-orders and modify them on the fly in-game
• Contains a building placement algorithm, finding the closest buildable location to a given position for a given building
• Scouts the map with a worker unit, discovering where the enemy base is located
• Once a specific condition has been reached (having 12 combat units, by default), it will commence an attack, sending waves of units at the enemy base
• Squads can be formed, consisting of multiple units following a specific order such as attack or defend a given location

CommandCenter should eventually have all of the functionality of UAlbertaBot, however much of its features are not currently completed. Here is an up-to-date list of features currently missing from CommandCenter that will be implemented soon:

• Only units and basic buildings can be constructed via the ProductionManager. No add-ons, research, or upgrades yet.
• There is no automatic build-order planning system
• There is no combat simulation package for predicting combat battle victory
• The bot only plays 1v1, and will have undefined behavior / crash if played against multiple enemies or on teams

Download and Run CommandCenter

StarCraft BW: You must have StarCraft: Broodwar version 1.16.1 installed, as well as BWAPI.

StarCraft 2: You must have an up-to-date retail version of StarCraft II installed to run the bot. You must also download and install some maps to use with the bot, which you can find here: https://github.com/Blizzard/s2client-proto#downloads. Please note that there is a password provided on that page to extract the maps from the zip files.

The bot comes with a configuration file named BotConfig.txt in which you can modify build orders, print various debug information to the screen, and set some bot parameters. You can define multiple builds orders in the ‘Strategies’ section of the file, and choose which named strategy to implement when the bot plays a specific race. Unit names in the build-order are case sensitive, and must be exactly how they appear in-game with no spaces. Some of the options in the configuration file are currently not implemented, such as the KiteWithRangedUnits option.

Please note that this config file is in JSON format, and the bot will not run unless it is well-formatted JSON. The configuration file must be in the same directory as CommandCenter.exe in order for the bot to run correctly. If you have made an error in the JSON syntax and can’t find it on your own, you can use an online JSON Validator to check for you.

By default when you run CommandCenter.exe, it will play as Random race vs. a Random race built-in SC2 Easy AI. You can modify which races are played in the configuration file via the «BotRace» and «EnemyRace» options. You can also modify which map to be played by specifying the «MapFile» option. Please note that the MapFile option is relative to your StarCraft II maps directory, which by default is located in your StarCraft_Install_Directory/maps/, and the bot will not run without specifying a valid map file.

If the bot crashes or does other nasty things, please bear with me while I make it more stable

Developer Install / Compile Instructions (Windows)

• Download and install Visual Studio 2017
• To play BW, you must download and install StarCraft BW v1.16.1 as well as BWAPI
• To play SC2, you must download and install the StarCraft II AI API. The easiest way to do this is to download the Precompiled Libraries at the bottom of the page, and simply extract them to a folder on your PC (make sure they are up to date). If you are getting the SC2API via cloning the Blizzard github repo and compiling it from scratch, you may need to point VS to different directories for include and lib than the ones described below.
• Clone this git repository to a folder on your PC
• Open «CommandCenter/vs/CommandCenter.sln» in VS2017
• If you compile the CommandCenter project with the x64 Platform, it will compile the SC2 bot
• If you compile the CommandCenter project with the x86 or Win32 Platform, it will compile the BW bot
• Set the VS Project include and lib folders to point to the directories
  • Right click the CommandCenter project in VS2017
  • Select «Properties»
  • Select the correct configuration that you want to build in the top left («Release» or «Debug»)
  • Select the target platform you want to build (x64 = SC2, Win32 = BW)
  • Select «VC++ Directories» on the left
  • Select the «Include Directories» option in the table on the right
  • Click the dropdown arrow on the right and click Edit…
  • Modify the existing directory entry to point to your (SC2API|BWAPI)/include directory
  • Select the «Library Directories» option in the table on the right
  • Click the dropdown arrow on the right and click Edit…
  • Modify the existing directory entry to point to your (SC2API|BWAPI)/lib directory
• From the «Build» menu, click «Build Solution»
• The binary «CommandCenter_API.exe» should appear in the CommandCenter/bin/ directory
• Run the CommandCenter bot by either:
  • Double clicking the executable in the CommandCenter/bin/ directory
  • Running the program from the console
  • Click «Local Windows Debugger» in VS to launch the program from within VS. To do this, you need to set the «Working Directory» option under «Debugging» to «$(ProjectDir)/../bin/» (I don’t know why this option won’t save)
• If you are running the BW version of the bot, you must then start BW via Chaoslauncher with BWAPI injected
• The CommandCenter/bin/BotConfig.txt file must be in the same directory as the .exe to run properly

Developer Install / Compile Instructions (Linux and OS X)

With these steps you should be able to build and install the SC2 API and include it into CommandCenter. It has been tested successfully for aba2d3813571c344090f3de5b58a5c912cd5acb3, so if the install instructions below don’t work checkout that version of the SC2 API

$ git checkout aba2d3813571c344090f3de5b58a5c912cd5acb3 .

and repeat the instructions.

• Build SC2 API project

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

• Install the SC2 API libraries and headers to your system

# 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 /opt/local/include
$ sudo cp -R include/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.a /opt/local/lib/sc2api
$ sudo cp build/bin/libprotobuf.a /opt/local/lib/sc2api
$ sudo cp build/bin/libsc2api.a /opt/local/lib/sc2api
$ sudo cp build/bin/libsc2lib.a /opt/local/lib/sc2api
$ sudo cp build/bin/libsc2protocol.a /opt/local/lib/sc2api
$ sudo cp build/bin/libsc2utils.a /opt/local/lib/sc2api

• Build the bot

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

Bot Development

If you are familiar with the architecture of UAlbertaBot, the logic of CommandCenter is quite similar. The biggest difference is that information relating to the map, baselocation, etc are no longer globally accessible. This data now lives inside the main CCBot class, and must be accessed via a reference to the instance of that class. Because of this, most classes in CommandCenter carry with them a reference to the bot’s main CCBot object, from which all game related information, observations, and queries can be made.

An in-depth development guide will be coming soon, but please refer to the UAlbertaBot wiki for now since the architecture is so similar (minus the build order planner and combat simulator).

A StarCraft II API Client for Python 3 (Modified)

Code in this repository is modified for Sentdex’s tutorials

An easy-to-use library for writing AI Bots for StarCraft II in Python 3. The ultimate goal is simplicity and ease of use, while still preserving all functionality. A really simple worker rush bot should be no more than twenty lines of code, not two hundred. However, this library intends to provide both high and low level abstractions.

This library (currently) covers only the raw scripted interface. At this time I don’t intend to add support for graphics-based interfaces.

Documentation is in the Wiki.

For automaticly running multiple matches, check out Dentosal/sc2-bot-match-runner.

Installation

You’ll need Python 3.6 or newer.

pip install --user --upgrade sc2

Requirements

pip install websockets
conda install opencv
# to prevent some async errors
pip install tornado==4.5.3

Game Path

If CRITICAL:sc2.paths installation not found

#on Starcraft2-Bot/sc2 folder, edit path.py:
BASEDIR = {
    "Windows": "C:/Program Files (x86)/StarCraft II",
    "Darwin": "/Applications/StarCraft II",
    "Linux": "~/StarCraftII"
}

Maps

Maybe you need to create a lower case maps folder:

Dentosal/python-sc2#105

Please note that not all commits are not released to PyPI. Releases are tagged with version number. You can see latest released versions from tags page.

You’ll also need an StarCraft II executable. If you are running Windows or macOS, just install the normal SC2 from blizzard app. The free starter edition works too.. Linux users must use the Linux binary.

You probably want some maps too. Official map downloads are available from Blizzard/s2client-proto. Notice: the map files are to be extracted into subdirectories of the install-dir/Maps directory.

Running

After installing the library, a StarCraft II executable, and some maps, you’re ready to get started. Simply run a bot file to fire up an instance of StarCraft II with the bot running. For example:

python3 examples/protoss/cannon_rush.py

Example

As promised, worker rush in less than twenty lines:

import sc2
from sc2 import run_game, maps, Race, Difficulty
from sc2.player import Bot, Computer

class WorkerRushBot(sc2.BotAI):
    async def on_step(self, iteration):
        if iteration == 0:
            for worker in self.workers:
                await self.do(worker.attack(self.enemy_start_locations[0]))

run_game(maps.get("Abyssal Reef LE"), [
    Bot(Race.Zerg, WorkerRushBot()),
    Computer(Race.Protoss, Difficulty.Medium)
], realtime=True)

This is probably the simplest bot that has any realistic chances of winning the game. I have ran it against the medium AI a few times, and once in a while it wins.

You can find more examples in the examples/ folder.

Bug reports, ideas and contributing

If you have any issues, ideas or feedback, please create a new issue. Pull requests are also welcome!

A StarCraft II API Client for Python 3 (Modified)

Code in this repository is modified for Sentdex’s tutorials

An easy-to-use library for writing AI Bots for StarCraft II in Python 3. The ultimate goal is simplicity and ease of use, while still preserving all functionality. A really simple worker rush bot should be no more than twenty lines of code, not two hundred. However, this library intends to provide both high and low level abstractions.

This library (currently) covers only the raw scripted interface. At this time I don’t intend to add support for graphics-based interfaces.

Documentation is in the Wiki.

For automaticly running multiple matches, check out Dentosal/sc2-bot-match-runner.

Installation

You’ll need Python 3.6 or newer.

pip install --user --upgrade sc2

Requirements

pip install websockets
conda install opencv
# to prevent some async errors
pip install tornado==4.5.3

Game Path

If CRITICAL:sc2.paths installation not found

#on Starcraft2-Bot/sc2 folder, edit path.py:
BASEDIR = {
    "Windows": "C:/Program Files (x86)/StarCraft II",
    "Darwin": "/Applications/StarCraft II",
    "Linux": "~/StarCraftII"
}

Maps

Maybe you need to create a lower case maps folder:

Dentosal/python-sc2#105

Please note that not all commits are not released to PyPI. Releases are tagged with version number. You can see latest released versions from tags page.

You’ll also need an StarCraft II executable. If you are running Windows or macOS, just install the normal SC2 from blizzard app. The free starter edition works too.. Linux users must use the Linux binary.

You probably want some maps too. Official map downloads are available from Blizzard/s2client-proto. Notice: the map files are to be extracted into subdirectories of the install-dir/Maps directory.

Running

After installing the library, a StarCraft II executable, and some maps, you’re ready to get started. Simply run a bot file to fire up an instance of StarCraft II with the bot running. For example:

python3 examples/protoss/cannon_rush.py

Example

As promised, worker rush in less than twenty lines:

import sc2
from sc2 import run_game, maps, Race, Difficulty
from sc2.player import Bot, Computer

class WorkerRushBot(sc2.BotAI):
    async def on_step(self, iteration):
        if iteration == 0:
            for worker in self.workers:
                await self.do(worker.attack(self.enemy_start_locations[0]))

run_game(maps.get("Abyssal Reef LE"), [
    Bot(Race.Zerg, WorkerRushBot()),
    Computer(Race.Protoss, Difficulty.Medium)
], realtime=True)

This is probably the simplest bot that has any realistic chances of winning the game. I have ran it against the medium AI a few times, and once in a while it wins.

You can find more examples in the examples/ folder.

Bug reports, ideas and contributing

If you have any issues, ideas or feedback, please create a new issue. Pull requests are also welcome!

This repository is no longer maintained and may not work with the latest version of the StarCraft 2 client. You can use this fork instead which aims to stay updated for both the latest windows StarCraft 2 client and latest linux client, while also being available on pypi.org.

A StarCraft II API Client for Python 3

An easy-to-use library for writing AI Bots for StarCraft II in Python 3. The ultimate goal is simplicity and ease of use, while still preserving all functionality. A really simple worker rush bot should be no more than twenty lines of code, not two hundred. However, this library intends to provide both high and low level abstractions.

This library (currently) covers only the raw scripted interface. At this time I don’t intend to add support for graphics-based interfaces.

Documentation is in the Wiki.

For automatically running multiple matches, check out Dentosal/sc2-bot-match-runner.

Installation

By installing this library you agree to be bound by the terms of the AI and Machine Learning License.

You’ll need Python 3.6 or newer.

pip3 install --user --upgrade sc2

Please note that not all commits are released to PyPI. Releases are tagged with version number. You can see latest released versions from tags page.

You’ll also need an StarCraft II executable. If you are running Windows or macOS, just install the normal SC2 from blizzard app. The free starter edition works too.. Linux users get the best experience by installing the Windows version of StarCraft II with Wine. Linux user can also use the Linux binary, but it’s headless so you cannot actually see the game.

You probably want some maps too. Official map downloads are available from Blizzard/s2client-proto. Notice: the map files are to be extracted into subdirectories of the install-dir/Maps directory.

Running

After installing the library, a StarCraft II executable, and some maps, you’re ready to get started. Simply run a bot file to fire up an instance of StarCraft II with the bot running. For example:

python3 examples/protoss/cannon_rush.py

If you installed StarCraft II on Linux with Wine, set the SC2PF environment variable to WineLinux:

SC2PF=WineLinux python3 examples/protoss/cannon_rush.py

Example

As promised, worker rush in less than twenty lines:

import sc2
from sc2 import run_game, maps, Race, Difficulty
from sc2.player import Bot, Computer

class WorkerRushBot(sc2.BotAI):
    async def on_step(self, iteration):
        if iteration == 0:
            for worker in self.workers:
                await self.do(worker.attack(self.enemy_start_locations[0]))

run_game(maps.get("Abyssal Reef LE"), [
    Bot(Race.Zerg, WorkerRushBot()),
    Computer(Race.Protoss, Difficulty.Medium)
], realtime=True)

This is probably the simplest bot that has any realistic chances of winning the game. I have ran it against the medium AI a few times, and once in a while it wins.

You can find more examples in the examples/ folder.

Help and support

You have questions but don’t want to create an issue? Join the Starcraft 2 AI Discord. Questions about this repository can be asked in channel #python-sc2.

Bug reports, feature requests and ideas

If you have any issues, ideas or feedback, please create a new issue. Pull requests are also welcome!

Contributing & style guidelines

Git commit messages use imperative-style messages, start with capital letter and do not have trailing commas.