FAIRYMAX(6) User Contributed Perl Documentation FAIRYMAX(6)
NAME
fairymax - xboard-compatible chess and chess-variant engine 'Fairy-Max'
SYNOPSIS
fairymax [hashSize] [iniFile]
shamax [hashSize] [iniFile]
maxqi [hashSize] [iniFile]
DESCRIPTION
fairymax is a program that plays chess and chess variants. It uses the
xboard/winboard chess-engine protocol to communicate. Apart from
'regular' chess (also known as the Mad-Queen variant), it can play
Capablanca chess, gothic chess, janus chess, knightmate, cylinder
chess, berolina chess, superchess, makruk (Thai chess, and also some of
its variants, Cambodian chess (Ouk), asean chess and ai-wok), courier
chess, Seirawan chess, Spartan chess, falcon chess, great shatranj,
team-mate chess, charge of the light brigade, king of the hill,
bifurcator chess, Los-Alamos chess, Mexican chess, Ciccolini's chess,
grande acedrex, wildebeest chess (almost), shuffle chess without
castling and chess with different armies (all combinations of the FIDE,
Clobberers, Nutters and Rookies armies). Fairy-Max can be easily
configured by the user to play other variants as well, by modifying the
ini file. This ini file describes the rules of movement of the
participating pieces and the initial board setup.
Fairy-Max can also play shatranj, but in this case is not aware of the
shatranj rule that a bare king loses. So it might play sub-optimally
in the late end-game. A version of Fairy-Max adapted to implement the
baring rule (and the rule that stalemate is a win) is available under
the name shamax. Grande Acedrex and Courier Chess might also have had
a baring rule, so you may want to play these with shamax instead of
fairymax too.
Similarly, a version of Fairy-Max adapted to play Xiang Qi (Chinese
Chess) is included in the fairymax package as well, under the name
maxqi.
fairymax is a derivative of the world's (once) smallest chess program
(source-code wise), micro-Max. The latter measures less that 2000
characters, (about 100 code lines), and has a computer rating of around
2050 on the CCRL rating list. Although this is about 1000 rating
points behind the world champion, micro-Max still makes a quite tough
opponent even for club players, although it is not unbeatable.
The main difference between micro-Max and Fairy-Max is that the latter
loads its move-generator tables, which specify how the various pieces
move, from an external file, so it can be easily adapted to incorporate
un-orthodox pieces. For ease of use of the artificial-intelligence,
Fairy-Max is equipped with I/O routines that allow it to run with the
xboard graphical user interface.
See xboard(6) for instructions about how to use fairymax through
xboard. To start up quickly, you just need the command: xboard -fcp
fairymax. Note that to be able to play the chess variants, it is
recommended to use the latest XBoard version, as some of the recently
added variants will use features not supported by older XBoard versions
(in particular allowing an engine to reconfigure XBoard's ideas on the
initial setup and how the pieces move). Problems with older XBoard
versions might range from only being able to play the variant with
legality testing switched off, inability to display some of the
unorthodox pieces in board sizes other than Bulky, Middling or Petite,
not recognizing variants with non-standard names, to refusing even
names that by now are standard XBoard variants.
For some variants even the name is unknown to XBoard, and they are all
grouped under the catchall name 'fairy'. Which variant is played by
Fairy-Max when XBoard is set to 'fairy', can be determined by a
combobox control in the XBoard 'Engine Settings' menu dialog. This
currently applies to the various army combinations of chess with
different armies. After having set this Variant fairy selects option,
activating XBoard's New game menu when already in variant fairy, or
selecting fairy from the New variant menu dialog will then start the
selected game.
Fairymax supports multi-PV mode: by specifying a non-zero multi-PV
margin in the Engine-Settings dialog of XBoard, Fairy-Max will not only
print the principal variation for the best move, but also for every
move that approaches the score of this best move to within the set
margin. (If it does not find the best move on the first try, this
might lead to printing of a few extra lines below the threshold.)
Fairy-Max now also supports analysis mode, and exclusion of moves from
the analysis.
The fmax.ini file from which Fairy-Max by default takes the piece and
game definitions is a self-documenting text file, which contains
instructions for how to define new pieces and chess variants. In
addition it contains an extensive list of pre-defined pieces, incuding
many not occurring in any of the pre-defined variants, which the user
can draw on to define his own variants.
Amongst the move types supported by Fairy-Max are normal leaper and
slider moves, (e.g. knight and rook), divergent moves (i.e. capture and
non-capture moves can be different), hoppers (which jump over other
pieces, such as the Chinese cannon or the grasshopper), lame leapers
(the move of which can be blocked on squares they cannot move to, such
as the Chinese horse and elephant), limited-range sliders (upto range
5), and any combination thereof, in every possible direction. The
board width is configurable upto a width of 14 files, and cylindrical
boards (where left and right edge connect) are supported as well. The
board height can be configured up to 16 ranks.
OPTIONS
hashSize
If the first argument to fairymax is numeric, it is taken as an
indicator for the amount of memory Fairy-Max is allowed to use
for its internal hash table. The default value for this
argument, 22, would result in a memory usage of 48MB. Each
next-higher number doubles the memory usage, each next-lower
halves it. Running with less than 6MB (i.e. argument 19) is
not recommended. When fairymax is running under xboard 4.3.15
or later the hash-table size can be set through the xboard
menus, making this argument superfluous.
iniFile A second or non-numeric first argument is taken as a filename.
Fairy-Max will use the mentioned file in stead of its default
fmax.ini file to define the movement of pieces and initial
setup of the variants. This makes it easier to define your own
variants.
INTERACTIVE OPTIONS
Fairy-Max also supports some options that can only be set
interactively, though XBoard's engine settings menu dialog.
These include a setting to further define -variant fairy, (e.g.
which armies to pit against each other in chess with different
armies), and whether makruk is to be played with Thai or
Cambodian rules (the latter requiring XBoard's legality testing
to be switched off!). You can also enable resigning, and set a
score threshold for when Fairy-Max should do it, and define the
already mentioned multi-PV margin there. An 'Info' button in
the settings dialog makes XBoard pop up a window with some info
about the currently selected variant.
Persistent hash
Some of the interactive options can be used to store the
current position in a file bearing the name of the variant
being played, with the extension '.hash' added to it, during
analysis. Positions in that file will be loaded into
Fairy-Max' hash table before every game, protected from
overwrite. This can be used to create an opening or end-game
book for the variant. The Save in hash file button is
convenient for saving the occasional position. For saving many
positions in a row the option Automatic pesistent-hash dialog
can be ticked. This pops up a dialog at the start of every
analysis search, in which the user then just has to press 'OK'
to put the score from the analysis into the hash file. If a
number is typed in that dialog before pressing 'OK', the
position will be saved with that score (in centi-Pawn) rather
than the score determined by the engine's own analysis. This
can for instance be used to discourage opening lines the engine
overrates. The file will be created in the current directory,
but at the start of a game both this file, as well as one in
Fairy-Max' private data files, will be loaded. The install
does contain such a persistent hash file for makruk, to help
Fairy-Max find the checkmate in the 'difficult' corners of the
KMMMK and KNMMK (with like M) end-games.
AVAILABILITY
At http://hgm.nubati.net/cgi-bin/gitweb.cgi the source code can be
obtained.
SEE ALSO
xboard(6)
explanations:
http://www.chessvariants.org/index/msdisplay.php?itemid=MSfairy-max
micro-Max: http://home.hccnet.nl/h.g.muller/max-src2.html
XBoard: http://hgm.nubati.net
STANDARDS
WinBoard, xboard(6) interface ("Chess Engine Communication Protocol")
AUTHOR
H.G.Muller <h.g.muller@hccnet.nl>.
This manual page was generated with pod2man(1).
perl v5.28.1 2019-07-29 FAIRYMAX(6)
Generated by dwww version 1.15 on Thu Jun 20 14:12:39 CEST 2024.