Skip to content

This is my entry winning CodeCup competition 2021 with the game Zuniq

License

Notifications You must be signed in to change notification settings

elkasimi/zuniq-ai

Repository files navigation

missing image
This is my entry winning CodeCup competition 2021 with the game zuniq. for detailed ranking:
Zuniq-ranking

What is Codecup?

CodeCup is an online programming competition inviting programmers to write a piece of software able to play a specific board game between two players (or several players like CodeCup 2017).

Anybody can participate; there are no age restrictions or other special requirements. The CodeCup never charges entry fees.

test competitions are run regulary so you can improve your bot stratgey and fix errors in your program. after that the final and the official competition is played.

What is Zuniq game?

You start on an empty grid of 6 x 6. You and your opponent place alternatively walls in the grid. You may close in zones, but these zones must all have a different size. It is forbidden to place walls in closed zones. The goal that you place the last wall and that you, consequently, win with 100 points against 50.

game "Zuniq" was created by Marcos Donnantuoni. It has very few elements and yet an unexpected complexity making it a good subject for AI programming enthousiasts.

for more information:
Zuniq rules

AI description

I used Monte Carlo Tree Search (MCTS) as the basic algorithm to find the best move to play. Rapid Action Value Estimation (RAVE) was used to give the algorithm information about the promising branches to explore in the Tree[1].

What is MCTS?

In computer science, Monte Carlo tree search (MCTS) is a heuristic search algorithm for some kinds of decision processes, most notably those employed in software that plays board games. In that context MCTS is used to solve the game tree.

for more information please refer to:
Monte Carlo tree search

What is RAVE?

For a given game tree node N, its child nodes Ci store not only the statistics of wins in playouts started in node N but also the statistics of wins in all playouts started in node N and below it, if they contain move i (also when the move was played in the tree, between node N and a playout). This way the contents of tree nodes are influenced not only by moves played immediately in a given position but also by the same moves played later.

For more information please refer to:
RAVE as an improvement for MCTS

I used a variant of RAVE that takes into consideration the opponent moves too and it does bring better results in practice, at least in Zuniq game. This can be justified by the fact that there is no black or white pieces but just placed walls because Zuniq is an impartial game.

What is an impartial game?

a variant of MCTS-Solver[2] was used to improve endgame playing. the main change is to do a full search when moves count drops to a threshold(=5 in my program) and backpropagate the exact values to states to mark them as winning/losing states.

Position representation and conventions

Position contains the following information:

  • placed: represent the walls placed by the players
  • possibleWalls: represent the walls which are empty and not in a closed state
  • state: represent only the placed walls that are not inside a closed zone and this is what is used as a state value in MCTS
  • possibleSizes: represent the possible sizes. at first it contains all value from 0 through 25. every time a zone is closed its size is removed from the list.

all the above are 64 bits unsigned integers so adding a wall is an OR with a flag and removing walls is an AND with a complement.

I refactored this into some methods that can be found in "Common.h" header.

in addition to the following attributes:

  • turns: represent how many turns were played in this position
  • walls: an array representing possible walls
  • wallsLength: represent the length of possible walls

There are 30 horizontal wall and 30 vertical one. I encoded them like:

  • if wall index is in [0..29] then it is the horizontal wall number "index". starting from left to right, up to buttom.

  • if wall index is in [30..59] then it is the vertical wall number (index-30). starting from left to right, up to buttom.

Enhancements

1 - The Tree was saved in a map and kept between game moves. the map associates a state (unsigned integer of 64 bits) to a StateInfo struct which provides the following:

  • an array of ActionInfo that stores information about actions in this state
  • state status which can be WIN, LOSS or UNKNOWN for unresloved yet states
  • winning action which makes sense only if it is a winning state
  • visits count of this state

2 - an extension for AMAF by considering also the value of an action when it is played by the opponent too. so for every action in a state there are 3 values:

  1. Q1 the Monte Carlo stats
  2. Q2 the AMAF stats
  3. Q3 the (lets say Generalised AMAF) stats by considering also when either me or my opponent played this action in the sub tree.

3 - an exploration bonus was added for each action that depends on its impact on reducing the possible moves. So finally the selection algorithm is trying to select action a that maximize this quantity:

value = (n1 * v1 + n2 * v2 + n3 * v3) / n + impact * sqrt(visits) / n (1)

where
Qi = (vi, ni), i = 1, 2, 3
n = n1 + n2 + n3
impact = change in possible moves count after playing action ai

I found that RAVE-MAX[3] is more stable so I used formula (1) but with
v2 = max(v2, v1)
v3 = max(v3, v1)

4 - a generalised state representation was used. so whenever a position contains a closed zone all walls inside it are ignored in its representing state. The state does not care if black or white has to move. the states are expressed according to the player to move. this helped a lot to avoid many redundant computations when two positions differs just by a wall inside a closed zone.

5 - findZone(wall) was the most expensive function so I tried to avoid it in random move generation. a random possible wall is choosen and if its zone is valid pick it otherwise pick randomly another possible wall..etc

6 - Following Alekhine, Alexander(World chess champion) quote:

The goal of an opening, is to have a playable game

I was not looking for the extremely best move to play but rather a good one.

So, for opening phase (turn < 21) I compiled a list of good walls for each player with some statistics of top bots games in the last competition results. during opening just those good moves are considered for me. this had the effect of reducing the branching factor at by sqrt(2) at least.

Those are the good opening moves found for white:

good-white-opening-walls

and those are the good opening moves found for black:

good-black-opening-walls

7 - for tricking opponents the selection phase is done with epsilon-greedy approach for opponent. So 10% of the time opponent moves are chosen at random. so my player is playing moves that propose more pitfalls for opponent as he takes into consideration that very bad moves can be played too. This is extremely beneficial near the end game where some moves are already known of being losing moves by MCTS-Solver.

8 - for the endgame I used an MCTS-solver approach so whenever search reached terminal positions I propagate the exact values to mark parent states winning/losing accordingly.

9 - I enhanced my endgame calculation by doing a full search for positions where the moves count drops to 5 instead of random simulations for better information for (8) enhancement. Full search will have complexity O(n!) but as 5! = 120 is small and this is giving exact information that helps to reslove many states. it looks a good investment of time to do so.

10 - after expansion of a new node several playouts(samples) are run for more robust results and for better selection. I used a samples count of 10. which helped in having a tradeoff between the tree depth and quality of actions statistics.

Time management

I used for the turns less than 19, 2 seconds in addition of 0.25 seconds to check if the most visited action correspond to the best, and do more iterations untill they match.

Starting at move 19 I use half of the remaining time but no more than 2.75s. 0.25 checking is kept also at this phase.

Opening moves

They were generated by this program using the maximum iterations count for turn 1 through 5 winning 4 seconds for black and 6 seconds for white.

There are 8 symmetries in Zuniq board so for opening I pick a random symmetry to return my moves after applying the symmetry and applying its inverse when reading opponent moves.

External libraries used

I used hashmap implementaion based on robin hood algorithm which gives better performance in comparison with std::unordered_map(in the context of my player. I did not do a full benchmark of it). It is nice that it is provided as header only so it is easy to integrate in my submission for CodeCup competition.

for more information:
Robin hood Library
Robin hood algorithm

Building the player

get the robin-hood-header and put it in path/to/zuniq-ai/sources

in a terminal:

cd path/to/zuniq-ai/sources
mkdir build
cd build
cmake ..
make player

Of course you will need CMake build tool and a C++ compiler for that

You can use the program to analyze a given position with:
./player --debug move1 move2 ... moveN

Or, to do some benchmarks:

  • to benchmark playout phase in MCTS
    ./player --benchmark-playout
  • to benchmark a simulation iteration
    ./player --benchmark-simulation

Or, to check the randomness of random move generation:
./player --check-randomness

Or, to generate opening book:
./player --opening-0
./player --opening-1
./player --opening-2
./player --opening-3
./player --opening-4
for generating entries to populate opening book hashmap for turns=1,2..5

Alphazero approach try

The game was a good candidate for an alphazero try. as its state can be easily encoded in a 64 unsigned integer and the possible actions are as simple as integers in the range [0..59]. the algorithm used in alphazero is elegant and I encourage reading the corresponding paper in references section.

I tried to inspire from it the following approach:

  • the MCTS uses an artificial neural net to attribute a score for a position instead of the random playout
  • the same neural network is used to attribute a value for actions in states

The coaching or learning is done like this:
start with an agent with neural network with random weigths as the teacher
start with the student as the teacher itself
for i = 1 .. maxIterations

  • do self play with teacher and collect examples
  • train student with a sample of collected examples so far
  • run a competition between student and teacher
  • if student wins with a ratio >= 55% it becomes the teacher

How to compile?

Get libfann and install it: Fast Artificial Neural Network Library

cd build
make coaching

How to start learning?

mkdir data
./coaching

How to resume learning?

./coaching --continue

How to run a competition against zeroplayer?

get caia
Download caia

Build zeroplayer

make zeroplayer

copy zeroplayer and data/best.ann into ~/caia/zuniq/bin (or make simlinks there to them)

cd ~/caia/zuniq/bin
./competition.sh zeroplayer opponent

Results against player1

After 10 iterations:

  7750  zeroplayer
  7250  player1

After 100 iterations:

  7900  zeroplayer
  7100  player1

After 1000 iterations:

  7800  zeroplayer                      
  7200  player1

winRate=56%

winRate against player2 was low ~ 2% even after 1000 iterations. Maybe neural net achitecture needs to be reviewed or need to include previous states too to give it more context. Or maybe more iterations are needed..etc I think I will try this later more seriously.

Could be done

  • exploit symmetries in opening moves generation
  • use Spark data processing engine to speadup AlphaZero approach
  • try different architectures for the artificial neural network
  • include previous states too to give the artificial neural network more context as it input

References

[1] “Monte-Carlo Tree Search and Rapid Action Value Estimation in Computer Go“ by Sylvain Gelly and David Silver

[2] “Monte-Carlo Tree Search Solver“ by Yngvi Björnsson and Mark H.M. Winands

[3] “Investigating UCT and RAVE: Steps towards a more robust method” by D.Tom, M.S. thesis, Univ. Alberta, Edmonton, 2010.

[4] “A Study of UCT and its Enhancements in an Artificial Game,” by D.Tom and M.Müller, in Proc. Adv. Comput. Games, LNCS 6048, Pamplona Spain, 2010, pp. 55–64.

[5] “Mastering the game of Go without human knowledge“ by David Silver et al.

Releases

No releases published

Packages

No packages published

Languages