Ai Ai Home Page

(Last update: 12th April 2021)
Ai Ai Download Page

AiAi is a Java-based general game playing engine based on Mogal (a GGP designed and developed by Stephen Tavener and Cameron Browne).   Games can be hand-coded in Java (for efficiency), or assembled from blocks using a scripting language based on JSON.

Note: as of 4th April 2020, you’ll need Java 11 to run Ai Ai. If you want an older version that runs in Java 8, follow this link: Last Java 8 release of Ai Ai

The current list of games in Ai Ai, ordered by BGG rating, is here: Ranked Games in Ai Ai.

Ai Ai Reports

Ai Ai has quite a lot of analysis functions. If you’re very, very patient (overnight is best) you can produce a detailed game report. Here are some examples: Ai Ai reports

Ai Ai online

As of 24th January 2019, Ai Ai also supports turn-based online play. Quick summary:

  • Run online.jar
  • Click the button on the left to create an account
  • Check your email (including spam folder) for a confirmation link
  • Log in, and start playing. If you want someone to challenge, I’m mrraow

Further reading

You’ll find a little more on Ai Ai here:

How Ai Ai Got its Name
Adding games to Ai Ai in Java (and compatible languages)
Ai Ai Developer’s Guide #1: MGL


AiAi allows you to play games against a variety of AIs, mostly variations of MCTS (Monte Carlo tree search).  It also contains analysis tools for game authoring; though these are more for my benefit than anyone else’s at present.

AiAi is still very much in a state of flux, and rather lacking in documentation at present but I will link documentation here as I write it.  Questions and comments welcome, and may well encourage me to write more!

I have added some threads to BGG for announcements, suggestions, and bug reports:

Announcements – subscribe to this thread to be notified when I update Ai Ai
Suggestions – any suggestions for improvements/new features should go here
Bug Reports – find a bug? Report it here. I will probably ask you for a save game file if it is a problem with a specific game.
FAQ – living FAQ; I will update the top post with questions and answers.
Game Candidates (long) list of games people would like to see implemented.

The latest version of AiAi will always be available here:
Ai Ai Download Page

BGG user SPaten has created a partial list of the games Ai Ai supports, over on BGG:
Games in Stephen Tavener’s AiAi Program

Dr. Eric Silverman has written about Ai Ai several times; most recently
in this blog entry.

19 thoughts on “Ai Ai Home Page”

  1. Hi Stephen,
    I wish I could wait to try out AiAi before commenting, but going by the screenshot of NestorGames, this may be what I have been looking for (Java-based platform) to use as my development platform for an edge-matching puzzle whose pieces are dynamically created from a mathematical set of, well, anything.
    Will let you know if it helps and if it doesn’t why not.
    PS I found you on the Game Puzzle & Design website via my association with Kate Jones of Kadon Enterprises.

  2. Thanks very much! But John Conway did not invent Hex. You might have meant to say John Nash, but it is not clear that he discovered it independently from Piet Hein after all.

  3. Hi

    This is great and I just downloaded but I have a quick question.

    When I go to “Choose game” in the software the list of games does not include everything in the list above – am I missing something?


    1. Andrew, as the number of games increases, it gets harder to organise them! From “Choose game”, have a look in the subfolders; you can also find games through the Categories menu.

  4. Fantastic, thank you 🙂

    Out of curiosity (no problem either way) when placing a stone in take do you always need to select the type from the drop down? Just checking in case I’m missing anything! 🙂

    1. The pop-up menu only appears when a move is ambiguous. In some games where you can play multiple pieces, you can click and drag from an offboard location.

    1. Charles, thanks for your interest in Genius Loci. File menu/Search for Game (ctrl-shift-f) will allow you to search for any game by name or category. In the Categories menu, you can find it by author. On the file system, it’s in the Combinatorial Awards 2014 folder.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.