AutoLeague for League Play

DomNomNom's Autoleague modified to play RLBot's Official League Play.

How to use:

Recommended: Use Bakkesmod and have 'Automatically save all replays' enabled.

Installation:

To install, clone this repo and run pip install -e . in the directory containing setup.py.
This should give you access to the autoleagueplay command line tool. Try autoleagueplay --help.
Run the autoleagueplay setup <league_dir> command to set the directory where you want your league to be stored.

Usage:

autoleagueplay setup <working_dir>                       | Setup a league directory. Required for some other commands.
autoleagueplay (odd | even) [--list | --results --test]  | Plays (or lists) an odd or even week from the given ladder.
autoleagueplay fetch <week_num>                          | Fetches the given ladder from the Google Sheets.
autoleagueplay test                                      | Checks if all bots are present in the bot folder.
autoleagueplay (-h | --help)                             | Show commands and options.
autoleagueplay --version                                 | Show version.

Options:

--replays=R          What to do with the replays of the match. Valid values are 'save', and 'calculated_gg'. [default: calculated_gg]
--list               Instead of playing the matches, the list of matches is printed.
--results            Like --list but also shows the result of matches that has been played.
--test               Checks if all needed bots are present in the bot folder.
-h --help            Show this screen.
--version            Show version.

The working directory contains:

ladder.txt. This contains the bot names separated by newlines (it can be copy-pasted directly from the sheet, or fetched with the fetch command).
bots/. Directory containing the bots and their files.
results/. Directory containing results. Each match will get a json file with all the relevant data, and they are named something like quantum_reliefbot_vs_atlas_result.json.

When running the script use either odd or even as argument to set what type of week it should play:

Odd: Overclocked, Circuit, Transitor, ect plays.
Even: Quantum, Processor, Abacus, etc plays.

When all results are found, a new ladder ladder_new.txt is created next to the original ladder file.

Advanced Usage:

Match Config

Change autoleague/default_match_config.cfg for other game modes and mutators.

Psyonix Bots

AutoLeaguePlay can handle Psyonix bots, but their names must be: Psyonix Allstar, Psyonix Pro, and Psyonix Rookie. You don't have to give them config files in the bots/ directory. AutoLeaguePlay has its own config files for Psyonix bots. If you really want to give them different names, change them there.

Fetching ladder from Google Sheets

You can fetch the ladder from the Google Sheets with the autopleagueplay fetch <week_num> command. Before you can use this you must get a credentials.json file which you can get by enabling Google Sheets API and then download the client configurations. Put the credentials.json in autopleagueplay/cred/. Next time you run the command, Google wants your permission, and then it should work.

Current Match and Overlay

AutoLeaguePlay creates a current_match.json in the working directory whenever a match is about to begin. This file contains the division, and the paths to the bots currently playing. E.g.:

{
    "division": 0,
    "blue_config_path": "C:\\User\\RLBot\\League\\bots\\Self-driving car\\self-driving-car.cfg",
    "orange_config_path": "C:\\User\\RLBot\\League\\bots\\Beast from the East\\beastbot.cfg"
}

The information in the file can be used for an overlay. When the new ladder is complete the current_match.json is removed.