4. List of commands

4.1. Global operations

Command

Action

new, ne, n

Create a new database.

open, op, o

Open an existing database.

quit, q

Close blunderDB.

help, he, h

Open blunderDB help.

meta

Display database metadata.

met

Open the Kazaross-XG2 match equity table.

tp2

Open the takepoint table with a 2-cube.

tp2_live

Open the takepoint table with a 2-cube for long race positions.

tp2_last

Open the takepoint table with a 2-cube for last roll positions.

tp4

Open the takepoint table with a 4-cube.

tp4_live

Open the takepoint table with a 4-cube for long race positions.

tp4_last

Open the takepoint table with a 4-cube for last roll positions.

gv1

Open the gammon value table with a 1-cube.

gv2

Open the gammon value table with a 2-cube.

gv4

Open the gammon value table with a 4-cube.

4.2. NORMAL Mode

Command

Action

import, i

Import a position via a text file (txt).

delete, del, d

Delete the current position.

[number]

Go to the specified index position.

list, l

Show the analysis of the current position.

comment, co

Show/write comments.

#tag1 tag2 …

Tag the current position.

e

Load all positions from the database.

4.3. EDIT Mode

Command

Action

write, wr, w

Save the current position.

write!, wr!, w!

Update the current position.

s

Search for positions with filters.

4.4. Search Filters

The filters below must be juxtaposed during a search, i.e., after the start of the s command.

Warning

In the position search, by default, blunderDB takes into account the current checker structure, ignoring the position of the cube, the score, and the dice. To consider the position of the cube, the score, and the dice, it must be explicitly mentioned in the search.

Note

blunderDB considers that a backchecker is a checker located between point 24 and point 19.

Note

blunderDB considers that the number of checkers in the zone is the number of checkers located between point 12 and point 1.

Note

blunderDB considers the outfield to extend between point 18 and point 7.

Note

blunderDB considers the jan to extend between point 1 and point 6.

Tip

The parameters for filtering positions can be combined arbitrarily.

Query

Action

cube, cub, cu, c

The position checks the cube configuration.

score, sco, sc, s

The position checks the score.

d

The position checks the dice or the cube decision.

D

The position checks the dice roll.

nc

The position has no contact.

M

The position or the mirror one meets the filters.

p>x

The player has at least x pips behind in the race.

p<x

The player has at most x pips behind in the race.

px,y

The player has between x and y pips behind in the race.

P>x

The player has a race of at least x pips.

P<x

The player has a race of at most x pips.

Px,y

The player has a race between x and y pips.

e>x

The equity (in millipoints) of the position is greater than x.

e<x

The equity (in millipoints) of the position is less than x.

ex,y

The equity (in millipoints) of the position is between x and y.

w>x

The player has winning chances greater than x%.

w<x

The player has winning chances less than x%.

wx,y

The player has winning chances between x% and y%.

g>x

The player has gammon chances greater than x%.

g<x

The player has gammon chances less than x%.

gx,y

The player has gammon chances between x% and y%.

b>x

The player has backgammon chances greater than x%.

b<x

The player has backgammon chances less than x%.

bx,y

The player has backgammon chances between x% and y%.

W>x

The opponent has winning chances greater than x%.

W<x

The opponent has winning chances less than x%.

Wx,y

The opponent has winning chances between x% and y%.

G>x

The opponent has gammon chances greater than x%.

G<x

The opponent has gammon chances less than x%.

Gx,y

The opponent has gammon chances between x% and y%.

B>x

The opponent has backgammon chances greater than x%.

B<x

The opponent has backgammon chances less than x%.

Bx,y

The opponent has backgammon chances between x% and y%.

o>x

The player has at least x checkers off.

o<x

The player has at most x checkers off.

ox,y

The player has between x and y checkers off.

O>x

The opponent has at least x checkers off.

O<x

The opponent has at most x checkers off.

Ox,y

The opponent has between x and y checkers off.

k>x

The player has at least x backcheckers.

k<x

The player has at most x backcheckers.

kx,y

The player has between x and y backcheckers.

K>x

The opponent has at least x backcheckers.

K<x

The opponent has at most x backcheckers.

Kx,y

The opponent has between x and y backcheckers.

z>x

The player has at least x checkers in the zone.

z<x

The player has at most x checkers in the zone.

zx,y

The player has between x and y checkers in the zone.

Z>x

The opponent has at least x checkers in the zone.

Z<x

The opponent has at most x checkers in the zone.

Zx,y

The opponent has between x and y checkers in the zone.

bo>x

The player has at least x blots in the outfield.

bo<x

The player has at most x blots in the outfield.

box,y

The player has between x and y blots in the outfield.

BO>x

The opponent has at least x blots in the outfield.

BO<x

The opponent has at most x blots in the outfield.

BOx,y

The opponent has between x and y blots in the outfield.

jb>x

The player has at least x blots in the jan.

jb<x

The player has at most x blots in the jan.

jbx,y

The player has between x and y blots in the jan.

JB>x

The opponent has at least x blots in the jan.

JB<x

The opponent has at most x blots in the jan.

JBx,y

The opponent has between x and y blots in the jan.

t’word1;word2;…’

The position comments contain at least one of the words.

m’pattern1,pattern2,…'

The best checker moves containing at least one of the patterns.

m’ND,DT,DP,…'

The best cube decisions for No Double/Take, Double Take, Double Pass.

T>x

Date of position addition after x (YYYY/MM/DD).

T<x

Date of position addition before x (YYYY/MM/DD).

Tx,y

Date of position addition between x and y (YYYY/MM/DD).

Note

Filtering positions based on the dice roll (D) necessarily implies filtering positions based on the type of decision (d).

Note

For the relative difference filter in the race (p>x, p<x, px,y), the player is behind in the race compared to the opponent if x>0 and ahead if x<0. For example: p<-10: the player is at least 10 pips ahead in the race. p50,70: the player is between 50 and 70 pips behind in the race.

For example, the command s s c p-20,-5 w>60 z>10 K2,3 filters all positions taking into account the checker structure, the score, and the cube of the edited position where the player has between 20 and 5 pips ahead in the race, with at least 60% winning chances, at least 10 checkers in the zone, and the opponent has between 2 and 3 backcheckers.

4.5. Various commands

Command

Action

clear, cl

Clear the command history.

migrate_from_1_0_to_1_1

Migrate the database from version 1.0 to version 1.1.