Variants¶
python-chess supports several chess variants.
>>> import chess.variant
>>>
>>> board = chess.variant.GiveawayBoard()
>>> # General information about the variants.
>>> type(board).uci_variant
'giveaway'
>>> type(board).xboard_variant
'giveaway'
>>> type(board).starting_fen
'rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w - - 0 1'
See chess.Board.is_variant_end()
, is_variant_win()
,
is_variant_draw()
, or is_variant_loss()
for special variant end conditions and results.
Variant |
Board class |
UCI/XBoard |
Syzygy |
---|---|---|---|
Standard |
chess/normal |
.rtbw, .rtbz |
|
Suicide |
|
suicide |
.stbw, .stbz |
Giveaway |
|
giveaway |
.gtbw, .gtbz |
Antichess |
|
antichess |
.gtbw, .gtbz |
Atomic |
|
atomic |
.atbw, .atbz |
King of the Hill |
|
kingofthehill |
|
Racing Kings |
|
racingkings |
|
Horde |
|
horde |
|
Three-check |
3check |
||
Crazyhouse |
crazyhouse |
-
chess.variant.
find_variant
(name: str) → Type[chess.Board][source]¶ Looks for a variant board class by variant name.
Chess960¶
Chess960 is orthogonal to all other variants.
>>> chess.Board(chess960=True)
Board('rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1', chess960=True)
See chess.BaseBoard.set_chess960_pos()
,
chess960_pos()
, and
from_chess960_pos()
for dealing with Chess960 starting
positions.
Crazyhouse¶
Three-check¶
UCI/XBoard¶
Multi-Variant Stockfish and other engines have an UCI_Variant
option.
XBoard engines may declare support for variants
.
This is automatically managed.
>>> import chess.engine
>>>
>>> engine = chess.engine.SimpleEngine.popen_uci("stockfish-mv")
>>>
>>> board = chess.variant.RacingKingsBoard()
>>> result = engine.play(board, chess.engine.Limit(time=1.0))
Syzygy¶
Syzygy tablebases are available for suicide, giveaway and atomic chess.
>>> import chess.syzygy
>>> import chess.variant
>>>
>>> tables = chess.syzygy.open_tablebase("data/syzygy", VariantBoard=chess.variant.AtomicBoard)