🥔 PotatoPeeler 🍟
📈 Measures your BWAPI bot against a gauntlet of opponents.
💪 Gets your potato in shape!
Your bot's win-loss-incomplete records against each opponent and on each map
When developing a bot to compete at StarCraft: Brood War using BWAPI, you may want to measure your bot's performance against salient opponents. PotatoPeeler is a set of simple scripts to run lots of games via SC-Docker and measure how your bot is doing.
PotatoPeeler can also analyze results from SC-Docker games you've run manually via
scbw.play; there's no difference between games run by PotatoPeeler and those run by
PotatoPeeler is deliberately simple. There are no plans for additional features.
🔨 Using PotatoPeeler
Runs games of your bot against a gauntlet of your opponents.
The script specifies which bot to test (yours), which opponents to play against, and which maps to use. Modify the script directly to customize your run.
potato-run runs games indefinitely. Press Ctrl+C to halt the run.
potato-run games go in the default scbw "games" directory. If you want to start start a fresh test run, delete or move the games in that directory.
potato-run kills all running Docker containers on start by running
dockerstop.sh. If you're using Docker for other purposes, you should remove this step.
potato-run doesn't always succeed at ending all the processes it spawns. If this happens, you'll need to end those processes manually. They'll likely be listed as instances of
Displays results of the most recent
potato-run. Collects replays and logs of games your bot lost.
potato-status prints results directly to the console (see example above). It copies replays and logs of losses to a "losses" directory inside your SC-Docker directory.
The files are named with each game's timestamp, so if you sort the "losses" directory by name it'll also be sorted by game, in chronological order.
You can run
potato-run is still in progress.
On Windows, you'll need access to Bash or an equivalent shell. Some good options for doing this:
- (Recommended) Install Git Bash. This is part of Git for Windows, so you likely already have this installed.
- Install https://www.cygwin.com/
git clone https://github.com/dgant/PotatoPeeler