The AI Sports Challenge 2020 season has officially ended! We had some amazing submissions from around the world. Congratulations to all our teams! 🎉 If you created a bot, we'd love for you to share it with us by raising a pull request against this repo and add the link to your bot for others to play against below. 👇
- TEAM NAME
- Baby Yoda
- terserah
- pBot Compilers
- Level 1 NPC
- bruh
- ARX II-13
- M Zheng
- KnAIght
- A Tan
- BombPyrates
- Chaotic NULLtral
- Jigglybluff
- RizDog
- PGB
- Rengoku
- Monty Python 3.9.1
- Reed-Solo-man Error Collector
- Bots by Robots
- Gambit
- jab.AI
- FleeBot2077
- Floth
- DLCT2
- FSO
- Oke
- Mosin
- Thailandnumberone
- Bomber Clan
- ZeroNet
- thegeeky
- AeroBot
- Yeet Yate Yote
- Donkie
- K Chan
- Team Solo Bot
- Artificial Incompetence
- SY
- Wizards
- UC Engineering Society
- Rootbeer
- Datawizards
This is a python
project and valid Python3 installation is required to run it.
If you don't have have python
installed on your machine, please go to python the official python web site pt and follow installation instructions for your operating system.
There are a number of ways to install the project. Easies is to use intallation package. Download latest avaialble release from github release page.
Assuming ~/workspace
is the directory you want to use to delevop your AI-agent:
Open terminal and run
# Create a working directory for your project:
> mkdir -p ~/workspace/my-agent
# Change into that directory
> cd ~/workspace/my-agent
# Create a python virtual environment. Lets call it venv
> python3 -m venv venv
# Activate your new python environment
> source venv/bin/activate
# Install CoderOne Dungen module you have previously downloaded:
> pip install ~/Downloads/coderone-challenge-dungeons-0.1.0.tar.gz
Once you have working installation you can start working on your AI-agent.
coderone-dungeon --interactive --watch my_agent
Windows installation follows similar steps as other operating system.
It is possible that you might need to use an alternative way to start the game, instead of realying on the convenice wraper codeone-dungeon
> python -m coderone.dungeon.main
Once all game dependencies properly installed, the game can be launched using command line:
python -m coderone.dungeon.main
There a number of command line option support by the game driver. To get a full list of options run:
python -m coderone.dungeon.main --help
Game runner recognises a number of command line options.
use python -m coderone.dungeon.main --help
to get a list of supported options.
--headless
- run the game without graphics. Tournament matches will be run in this mode.--interactive
- game is created with extra player for the interactive user. This player can be controlled using keyboard.--watch
- automatically reload user agent if source code files changes. This allows for interactive development as code can be edited while the game is running.--record <FILE>
- record game action into a specified file for later review.
Enter
- to pause / un-pause the gamer
- to restart the game with new random map↑
/↓
/←
/→
- arrows to move the player<SPACE>
- to place the bomb
There are 3 main modes to run the game:
- Interactive mode - when a human player can particiapate in a match This is a 'normal' game mode when a human user can play the game with the keyboard the game to explore it. This mode requires at least one bot.
- Match - two or more* AI agents play a game without human participant.
- 'Headless' match - the game is played by bots with no human participant without graphics output. This is the mode used to run a tornamanet.
By default, game runs in a tornament mode, without user input, with graphics output. For example, to ran a random match between two AI agent "agent1.py" and "agent2.py", run:
coderone-dungeon agent1.py agent2.py
Agent with multiple files code are also supported. Keep in mind that a proper python modules must include __init__.py
file.
On the first run the game will generate default config file config.json
and store in the OS-specific configuation directory.
Default config looks like this:
{
"headless": false,
"interactive": false,
"start_paused": true,
"wait_end": 5,
"max_iterations": 3000,
"tick_step": 0.10
}
In your local developemnt environemnt you have access to all config options, such as nubmer of iteration the game runs (max_iterations
) or game update time step (tick_step
). However, this options are fixed in the tournamtent and can not be modified so please don't rely on this values.
Python library used for graphics has some known issues. If you experience a game crash with error like:
munmap_chunk(): invalid pointer
Aborted (core dumped)
Add the following option to your config.json
...
"no_text": true,
...
This options disables all texts in the game which resolves library crashes.
On ARM you python Arcade fails to install without FFI. Install it via:
> sudo apt install libffi-dev libtiff5-dev libjpeg8-dev libopenjp2-7-dev zlib1g-dev \
libfreetype6-dev liblcms2-dev libwebp-dev tcl8.6-dev tk8.6-dev python3-tk \
libharfbuzz-dev libfribidi-dev libxcb1-dev
Clone this git repository:
git clone https://github.com/gocoderone/dungeons-and-data-structures
Open termnial and run following commands
> cd <git check-out>
> python3 -m venv venv
> source venv/bin/activate
> pip install -r coderone/dungeon/requirements.txt
As we strive to build AI sport games we welcome all contributions to improve the experience for all participants.
Feel free to raise an issue in the github repository if you experiece any issue or would like to send a suggestion.
HUMANS at Coder One:
- Ivan aka @abbyssoul