This is a documentation for Board Game Arena: play board games online !

Bots and Artificial Intelligence

From Board Game Arena
Jump to navigation Jump to search


Trying to add info on how to add bots and AI in bga games. There is no framework support (now), so it is all custom stuff.

What about "Can't Stop" Bot? Well it is the only game that has AI (without I) that is treated as separate player, admins won't reveal how it is done nor that is feasible to implement in other games.


The following game have modes that support bots Conspiracy, Glow, Crew, Crew Deepsea


Testing bot

Testing bot is actually JavaScript bot that presses on buttons on behalf of player. Its handy for testing on Studio. Recommended way of doing it is add Studio only button (together with debug bar) "Run bot/Stop bot", when running it can react to state changes and press stuff. Example "Battleship"

JavaScript AI

Currently I don't see how it is feasible, JS code requires real player connected to game and browser, so it cannot be run as AI engine

Server Bot as registered game Player

This would be ideal, but currently on Can't Stop does it and no other game can use this technique

Server Bot as game state action

This is the only feasible way in production. In addition to whatever game states are doing, it can handle fake players and simulate their moves

In some games Bot will take player color and whole board similar to what player, and can even have resources. So it natural that Bot behaive like a player in a game. However you cannot add fake player into player table, so you cannot add any field in that table to track resources for examples. You cannot make fake player active or multiactive.

Bot Player ID

Reserve non-exising player id for bots (i.e. 1-6) If bot needs color and order see below

Bot Color, Order and Resources

Create table similar player to track bots color, name, score, score_aux and possibly other stuff

 `player_id` int(10) unsigned NOT NULL,
 `player_name` varchar(32) NOT NULL,
 `player_avatar` varchar(10) NOT NULL,
 `player_color` varchar(6) NOT NULL,
 `player_no` int(10) NOT NULL,
 `player_score` int(10) NOT NULL DEFAULT '0',
 `player_score_aux` int(10) NOT NULL DEFAULT '0',
 `player_ai` tinyint(1) NOT NULL DEFAULT '0' COMMENT '1 = player is an AI',
  PRIMARY KEY (`player_id`)

Bot Actions

  • All actions that can be done by Bot have to have $player_id as argument and not use active player
  • Separate code of ajax actions themselves and functional code, so function can be run from ajax action or from game state action
  • If you using getPlayerNameById to sen player_name in notification, you may have to override id (same for player color)
   public function getPlayerNameById($player_id) {
       if ($player_id == PLAYER_AUTOMA)
           return ('Automa');
       return parent::getPlayerNameById($player_id);
  • You may also create a function like loadPlayersBasicInfosWithBots which will return similar data as loadPlayersBasicInfos but with bots ids. Cache the result if using a lot
    function loadPlayersBasicInfosWithBots() {
        $player_basic = $this->loadPlayersBasicInfos();
        if ( !$this->isAutoma())
            return $player_basic;           
        if ( !isset($this->player_bots)) {
            $this->player_bots = $this->getCollectionFromDb("SELECT * FROM playerextra");
        return $this->player_bots + $player_basic;

Bot Player Panel

If you want bot on player panel you have to add it manually. You can either create template similar to real one or use this hack. Below we get player_id and player from playerextra

var over = $('overall_player_board_' + player_id);
if (!over) {
	let active_id = this.getActivePlayers()[0];
	let active_name = gamedatas.players[active_id].name;
	var xclone = $('overall_player_board_' + active_id).outerHTML;
	xclone = xclone.replaceAll(String(active_id), player_id);
	xclone = xclone.replaceAll(active_name,;
	xclone = xclone.replaceAll(gamedatas.players[active_id].color, player.color);
        var node =, 'player_boards');
// tweak to change avatar status and such

Bot Player Notifications

When you send notification with ${player_name} you also should send 'player_id' with you fake id. In additio getAllDatas() should contain record matching fake player id in players field, i.e if $player has data for fake player:

   protected function getAllDatas() {
       $result = [];
           $result ['players'] [$player_id] ['id'] = $player['id'];
           $result ['players'] [$player_id] ['score'] = $player['score'];
           $result ['players'] [$player_id] ['color'] = $player['color'];
           $result ['players'] [$player_id] ['name'] = $player['name'];
       return $result;