MrBot

MrBot is a very very simple chess bot. It uses the minimax algorithm to find the best move. It evaluates positions based on material value, castling (opening), PSTs, and more.

API

decodeScore(score: number): { isMate: boolean, isBook: boolean, mateInPlies: number?, mateInMoves: number?, isWinning: boolean, evaluation: number }

Decodes a score/evaluation so that it can be worked with comfortably.

MrBot objects

class MrBot

This class represents an instance of MrBot.

createSearch(chess: Chess): void

Creates a Search object from the given Chess instance.

async simpleSearch(o: { chess: Chess, ms: number?, depth: number? }): { move: string, evaluation: number, depth: number }?

Runs a search on the Chess instance chess for ms milliseconds with a max depth of depth. depth, if not given, is 4. ms, if not given, is 4500. Slightly buggy. Okay, let's be honest: it's very buggy and can sporadically return null.

Search objects

A search object represents a search. Multiple searches cannot happen in parallel.

start(maxDepth: number? = null): void

Starts the search. maxDepth is the maximum depth it should search to.

stop(): void

Stops the search.

oniteration: (o: { move: string, evaluation: number, depth: number }) => void

This callback is called when MrBot finishes an iteration of iterative deepening.

Example

import { MrBot } from "mrbot";
import { Chess } from "chess.js";

const chess = new Chess();
const mrbot = new MrBot();

(async () => {
  const result = await mrbot.simpleSearch({ chess, ms: 1000 });
  console.log(result); 
  // { move: 'e2e4', evaluation: 34, depth: 4 }
})();