https://github.com/aiarena/aiarena-docker-base

https://github.com/aiarena/aiarena-docker-base

aiarena

Last synced: 20 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/aiarena/aiarena-docker-base
• Owner: aiarena
• Created: 2020-09-14T10:12:31.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2024-01-23T03:35:14.000Z (6 months ago)
• Last Synced: 2024-06-12T07:54:52.527Z (25 days ago)
• Topics: aiarena
• Homepage:
• Size: 1.29 MB
• Stars: 42
• Watchers: 4
• Forks: 7
• Open Issues: 33
• Metadata Files:
  • Readme: README.md
  • Changelog: changes.md

Lists

• awesome-sc2-ai - aiarena-docker - Standard arena client docker environment used in competitions. (Development tools / Python Tutorials)

README

        
# aiarena-docker-base

https://hub.docker.com/r/aiarena/

A collection of base images used by the [AI Arena match controller](https://github.com/aiarena/sc2-ai-match-controller).

## Local play

If you're just looking for a way to play local matches using docker, check out the [local-play-bootstrap](https://github.com/aiarena/local-play-bootstrap).

## Tests

See ``test_docker_image.sh`` which builds both local dockerfiles and then runs the aiarena client with several bots and checks the results with expected outcomes.

## Usage

This docker can be used to run AI Arena ladder on a local machine.

Follow the steps below to configure and run an example match between two standard bots.

1. [Build](#Build) an image.

2. Copy file named `example_local_config.py` and rename its copy to `config.py`. If necessary, adjust

  any parameters inside.

3. Download the latest aiarena bots:

  ```

  git clone https://github.com/aiarena/aiarena-test-bots

  ```

  If you want to use other bots, you can download them as well.

4. Download [the latest maps](https://aiarena.net/wiki/maps/) for AI Arena ladder and unpack them

  into some empty directory.

5. Now create a file called `matches` with the following content:

  ```

  # Bot1 name, Bot1 race, Bot1 type, Bot2 name, Bot2 race, Bot2 type, Map

  basic_bot,T,python,loser_bot,T,python,DeathAuraLE

  ```

  You can add more matches if you want.

6. Run the docker container:

  ```

  export CONFIG_PATH="/path/to/your/config.py"

  export MATCHES_PATH="/path/to/your/matches"

  export BOTS_PATH="/path/to/your/bots"

  export MAPS_PATH="/path/to/your/maps"

  export REPLAYS_PATH="/path/to/new/empty/directory"

  docker run -v ${CONFIG_PATH}:/root/aiarena-client/config.py -v ${MATCHES_PATH}:/root/aiarena-client/matches -v ${BOTS_PATH}:/root/aiarena-client/bots -v ${MAPS_PATH}:/root/StarCraftII/maps ${REPLAYS_PATH}:/root/aiarena-client/replays:rw -v -it aiarena/arenaclient:latest

  ```

  After the command completes, replays will be available in `$REPLAYS_PATH` directory.