@nodots/backgammon-ai

Robot move selection, cube decisions, and move analysis for Nodots Backgammon. Built on @nodots/gnubg-hints, which runs GNU Backgammon evaluations in-process.

Install

npm install @nodots/backgammon-ai @nodots/backgammon-core

Quick start

import { Game } from '@nodots/backgammon-core'
import {
  initializeGnubgHints,
  executeRobotTurnWithGNU,
  shutdownGnubgHints,
} from '@nodots/backgammon-ai'

await initializeGnubgHints()

const game = Game.createNewGame(
  { userId: 'alice', isRobot: false },
  { userId: 'bob',   isRobot: true  },
)
const rolled = Game.roll(Game.rollForStart(game))

// One call drives the full robot turn: picks the best move sequence,
// applies every die, and returns the updated game.
const after = await executeRobotTurnWithGNU(rolled)

await shutdownGnubgHints()

API surface

Export	Purpose
initializeGnubgHints, shutdownGnubgHints, configureGnubgHints	Lifecycle for the native hints session.
executeRobotTurnWithGNU	One-call, state-preserving robot turn driver.
getBestMove, getMoveHints	Full checker-play evaluations.
getDoubleHint, getTakeHint	Cube decisions.
GNUAIProvider, NodotsAIProvider, registerAIProvider	Pluggable provider interface for custom engines.
moveAnalyzers, moveSelection, selectMoveFromList	Lower-level hooks for trainers and analyzers.
luckCalculator	Per-roll luck decomposition.
DEFAULT_HINTS_CONFIG	Default search depth, noise, and filter settings.

Pluggable analyzers

Every candidate move passes through an ordered list of analyzers before selection. Register your own via pluginLoader — useful for building tutors, trainers, or bespoke engines that bias toward specific position types.

Strength

GNU Backgammon plays in the 2000+ FIBS rating class with full cubeful evaluations. See the Nodots dice-fairness white paper for how rolls are generated and tested against an XG/BGBlitz-comparable standard.

Ecosystem

Package	Role
@nodots/backgammon-types	Discriminated-union type contracts.
@nodots/backgammon-core	Game logic.
@nodots/backgammon-ai	AI (this package).
@nodots/backgammon-api-utils	Request, response, and WebSocket contracts.
@nodots/backgammon-cli	Terminal client (ndbg).
@nodots/gnubg-hints	Native GNU Backgammon hints addon.

Hosted product: backgammon.nodots.com.

License

GPL-3.0. This package bridges to GNU Backgammon (itself GPL-3.0); see @nodots/gnubg-hints for details on the native bindings.