1. About
2. Compile instructions
3. Launch instructions
4. Platform connection

• make
• g++

make

Compile executables individually:
make build/main
make build/generator
make build/warmup_generator

make clean

make run

The default option of the program is a request handler that takes in a POST request (a game state) in the following JSON format, for example:

{
  "board": [
    [0,0,0,0,0,0,0],
    [0,0,0,1,0,0,0],
    [0,0,0,2,0,0,0],
    [0,0,0,1,0,0,0],
    [0,0,2,2,0,2,0],
    [1,2,1,1,0,2,1]
  ],
  "current_player": 1,
  "valid_moves": [0,1,2,3,4,5,6],
  "is_new_game": false
}

And it returns a response in this format (the move calculated):

{
  "move": 2
}

Additionally, you can run make run ARGS="<arg>" to compile and launch the program with diffrent modes (-t, -f, -b, -w,...)

The solver currently has 7 modes:

• Default mode: -w, --web: Run a request handler from a client and returns a response (as stated above).

• Find mode: -f, --find: The user inputs a sequence representing a board and the program returns the best move for that board. It prints out the best move to make and the score of the current game position. It also prints the number of nodes explored, the number of moves on the board, and the time it takes to find the best move.

• Continuous find: -c, --cfind: Only 1 board exists, the user inputs moves continuously to construct the board and the solver will find the best move for the current board.

• Test mode: -t, --test: Run the solver with the test provided in /tests. A test is a file containing lines of a sequence and its expected score. The solver then iterates through all the lines and calculates the score for each line, then compares the results. It is used to measure the time taken and the accuracy of the solver. You can modify the runTest() function in the solver main function to run other tests.

• Play mode: -p, --play: Start the game, the player could choose to be either red or yellow and play with our AI bot.

• Bot versus bot: -b, --botgame: Create 2 bots and make them play against each other. You could see the board in each move, the moves they make and the time elapsed.

• Training mode: -tr, --training: This mode is used for generating the hard moves (moves that take more than 2 seconds) to add to the file hard_moves.txt. You can then run the warmup_generator to contribute to the warmup.book file. This mode basically is a bot game but the board is reset whenever it reaches moves 14 (this can be changed), making it an infinite loop.

Alternatively, if you already compiled the solver first using make, you could just run the executable with the corresponding argument. For example:

If you're on Windows:
.\build\main.exe
.\build\main.exe -f
.\build\main.exe --find

Or if you're on Linux:
./build/main --play
./build/main -t
./build/main --test

The program is connected to the battle platform by the request handling mode "-w". By default it listens to 0.0.0.0:8112, the request and reponse format is mentioned above.