Update explanations inf max.ini file
[fairymax.git] / data / fmax.ini
index d6f70e1..b64bd6f 100644 (file)
@@ -140,9 +140,13 @@ Numbers 1 and 2 are considered Pawns for white and black, respectively,
 and the 2nd and 7th rank of the opening setup will be filled with them.\r
 These pieces will automatically promote to piece number 7 when they \r
 reach last rank. So in normal Chess, piece 7 should be programmed as Queen.\r
+There is one exception to this: if the initial setup does have a white\r
+piece 7, but not a black one, and black has a piece number 9, then\r
+black will always promote to the latter. (This can be useful in variants\r
+with different armies for black and white).\r
 \r
 Castling can be done only with the original corner piece as specified\r
-by line 2 and 3. Any royal piece can in principle castle. (Subject to \r
+by line 2 and 3. Any piece can in principle castle. (Subject to \r
 the normal restrictions on castling, i.e. not passing through check etc.)\r
 If you don't want that, remove the castling moves from the King description. \r
 If the castling initiator does not start in a central file, the results are \r
@@ -163,7 +167,7 @@ The piece-description lines have the following syntax:
 4) for each direction it moves in, a ray descriptor consisting of:\r
    a) the initial step vector (on a 16x8 board, so 16 = straight ahead)\r
    b) a comma\r
-   c) the move-mode descriptor, most easily given in hexadecimal, as the\r
+   c) the move-mode descriptor, given in hexadecimal, as the\r
       individual bits specify the various options\r
 \r
 The piece indicator character is used to set up positions, and for the\r
@@ -174,6 +178,14 @@ and the last one for black. If more than two have the same name, the
 others cannot be indicated at all, but they could still occur in the\r
 initial setup (where you specify them by number, not letter).\r
 \r
+Pieces with negative values are considered royal. If one side has more than\r
+one royal piece of the same type, he loses if the _last_ one is captured.\r
+This means any 'spare' royal pieces can be sacrificed, and the exchange\r
+value assumed for them will be the absolute value of what you defined.\r
+With a value -1, however, loss of the first piece of that type loses the game.\r
+For royal piece types larger than 7 there is the special rule that it is not\r
+allowed to leave more than one of them under attack ('duple check').\r
+\r
 NOTE: piece value 181 for piece 7 is reserved for Makruk, and enables\r
 promotion on the 6th rank. Do not use it in other variants.\r
 \r
@@ -187,9 +199,10 @@ Bits set in the forelast digits TOGGLE the corresponding bits in the last
 digit. For hoppers when they hop over something, for the other pieces after\r
 every step (so for normal pieces, better not set those bits!).\r
 \r
-The digit before that can only be 0 or 1; a 1 indicates the board should\r
-be treated as a cylinder, pieces crossing the right edge re-entering the\r
-board at the left, and vice versa.\r
+The digit before that can only have the 1 or 2 bit set; a 1 indicates the \r
+board should be treated as a cylinder, pieces crossing the right edge \r
+re-entering the board at the left, and vice versa. The 2 bit indicates\r
+the move is a multi-path move, only used for the Falcon in Falcon Chess.\r
 \r
 The higher-order bits toggle corresponding bits in the step vector,\r
 to allow zig-zag paths. Better not set those either, if a straight\r
@@ -232,7 +245,25 @@ black Pawn, respectively, or promotions will have undefined effects. Also
 note that uMax does do primitive evaluation of Pawn structure, which might\r
 become counter-productive if the Pawn move is changed.\r
 \r
-\r
+A low digit equal to 4 gets special treatment, as the normal interpretation as\r
+the last and only step of a move which can neither capture nor move is useles.\r
+It will in stead be used as if it was 0 (i.e. there is a follow-up step),\r
+but only if the piece has not moved before. If the 1 or 2 bit of the preceding\r
+toggle digit are set, they then determine what the move can do after this second\r
+step, in the normal way. (For pawn double-push and castling this would normally\r
+be a non-capture.) The 4 and 8 bits of this toggle digit are not used for\r
+toggling the leaper and hopper bits, though, but indicate if e.p. capture\r
+on the reply should be suppressed, and if the move should be allowed to continue\r
+even if the first step hits an occupied square. Currently only the following\r
+values are defined (all working only for pieces that have not moved yet).\r
+\r
+  24  e.p.-capturable blockable double-step, non-capture only (on Pawns)\r
+  34  castling (on non-Pawns): will swing edge piece around you when possible\r
+  E4  e.p.-immune jump, non-capture only\r
+  F4  e.p.-immune jump\r
+\r
+Other combinations are RESERVED, and will result in undefined effects.\r
+(i.e.: they might do different things in future versions as they do in this one)!\r
 \r
 For the truly lazy, a few complete game descriptions can be found below:\r
 \r
@@ -268,20 +299,39 @@ f:180 15,7 17,7 -15,7 -17,7
 // Thai Chess. Note: value m = 181 controls promotion at 6th!\r
 Game: makruk\r
 8x8\r
-6 4 5 7 3 5 4 6\r
-6 4 8 3 7 8 4 6\r
+12 11 8 7 3 8 11 12\r
+12 11 9 3 7 9 11 12\r
 p:100 -16,6 -15,5 -17,5 \r
 p:100 16,6 15,5 17,5\r
 k:-1  1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7\r
-n:450 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+f:181 15,7 17,7 -15,7 -17,7\r
+q:181 15,7 17,7 -15,7 -17,7\r
+b:300 15,7 17,7 -15,7 -17,7 -16,7\r
+m:181 15,7 17,7 -15,7 -17,7\r
 s:300 15,7 17,7 -15,7 -17,7 -16,7\r
+s:300 15,7 17,7 -15,7 -17,7 16,7\r
+b:300 15,7 17,7 -15,7 -17,7 16,7\r
+n:450 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
 R:630 1,3 16,3 -1,3 -16,3\r
-m:181 15,7 17,7 -15,7 -17,7\r
+\r
+// Cambodian Chess. Like Makruk, but with extra initial King and Met moves\r
+Game: cambodian\r
+8x8\r
+13 12 8 3 7 8 12 13\r
+13 12 9 7 4 9 12 13\r
+p:100 -16,6 -15,5 -17,5 \r
+p:100 16,6 15,5 17,5\r
+k:-1  1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7 -16,10F4 -16,1F0F4 -1,100F4 1,FFFF00F4\r
+k:-1  1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7 16,10F4 16,1F0F4 1,100F4 -1,FFFF00F4\r
+f:181 15,7 17,7 -15,7 -17,7 16,F4 -16,F4\r
+q:181 15,7 17,7 -15,7 -17,7 16,F4 -16,F4\r
+m:181 15,7 17,7 -15,7 -17,7 16,F4 -16,F4\r
+s:300 15,7 17,7 -15,7 -17,7 -16,7\r
 s:300 15,7 17,7 -15,7 -17,7 16,7\r
-f:181 15,7 17,7 -15,7 -17,7\r
-q:181 15,7 17,7 -15,7 -17,7\r
 b:300 15,7 17,7 -15,7 -17,7 -16,7\r
 b:300 15,7 17,7 -15,7 -17,7 16,7\r
+n:450 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+R:630 1,3 16,3 -1,3 -16,3\r
 \r
 // Medieval intermediate between Shatranj and FIDE Chess\r
 Game: courier\r
@@ -344,6 +394,23 @@ Q:950 1,3 16,3 15,3 17,3 -1,3 -16,3 -15,3 -17,3
 A:825 15,3 17,3 -15,3 -17,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
 C:875 1,3 16,3 -1,3 -16,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
 \r
+// FalconChess is protected through U.S. patent #5,690,334 by George W. Duke.\r
+// The patent now expired, though.\r
+Game: falcon\r
+10x8\r
+6 4 5 8 7 3 8 5 4 6\r
+6 4 5 8 7 3 8 5 4 6\r
+p:100 -16,24 -16,6 -15,5 -17,5 \r
+p:100 16,24 16,6 15,5 17,5\r
+k:-1  1,3034 -1,1034 1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7\r
+n:310 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+b:350 15,3 17,3 -15,3 -17,3\r
+R:475 1,3 16,3 -1,3 -16,3\r
+Q:950 1,3 16,3 15,3 17,3 -1,3 -16,3 -15,3 -17,3\r
+f:450 13,FFFFF207 29,F207 46,F207 47,10207 49,10207 50,11207 35,11207 19,1207 -13,1207 -29,FFFF1207 -46,FFFF1207 -47,FFFF0207 -49,FFFF0207 -50,FFFEF207 -35,FFFEF207 -19,FFFFF207 \r
+A:825 15,3 17,3 -15,3 -17,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+C:875 1,3 16,3 -1,3 -16,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+\r
 // Cylinder Chess (WinBoard / XBoard legality testing should be off toplay this!)\r
 Game: cylinder\r
 8x8\r
@@ -389,27 +456,159 @@ A:1200 1,3 16,3 -1,3 -16,3 15,3 17,3 -15,3 -17,3 14,7 31,7 33,7 18,7 -14,7 -31,7
 o:700 2,7 30,7 32,7 34,7 -2,7 -30,7 -32,7 -34,7 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
 g:640 1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7 2,7 30,7 32,7 34,7 -2,7 -30,7 -32,7 -34,7\r
 m:-1  1,34 -1,34 1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7 16,70 -16,70\r
-d:625 1,7 16,7 -1,7 -16,7 15,3 17,3 -15,3 -17,3\r
+w:340 1,7 16,7 -1,7 -16,7 2,7 32,7 -2,7 -32,7\r
+\r
+// Seirawan Chess (with Archbishop and Chancellor gated in during game)\r
+Game: seirawan\r
+8x8\r
+5 3 4 7 6 4 3 5\r
+5 3 4 7 6 4 3 5\r
+p:74 -16,24 -16,6 -15,5 -17,5 \r
+p:74  16,24 16,6 15,5 17,5\r
+n:259 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+b:296 15,3 17,3 -15,3 -17,3\r
+R:444 1,3 16,3 -1,3 -16,3\r
+k:-1  1,34 -1,34 1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7\r
+Q:851 1,3 16,3 15,3 17,3 -1,3 -16,3 -15,3 -17,3\r
+k:-1  1,34 -1,34 1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7\r
+h:780 15,3 17,3 -15,3 -17,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+E:814 1,3 16,3 -1,3 -16,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+\r
+// Spartan Chess, where black has a different army from white's orthodox FIDE, with two kings\r
+Game: fairy/Spartan # PNBRQ..............K....q.lwg.....c...hk\r
+8x8\r
+6 4 5 7 11 5 4 6\r
+3 10 12 8 8 12 9 3\r
+p:74 -16,64 -16,6 -15,5 -17,5 \r
+h:70  15,E4  17,E4 16,5 15,6 17,6\r
+l:290 15,7 17,7 -15,7 -17,7 30,7 34,7 -30,7 -34,7 1,6 -1,6\r
+n:259 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+b:296 15,3 17,3 -15,3 -17,3\r
+R:444 1,3 16,3 -1,3 -16,3\r
+Q:851 1,3 16,3 15,3 17,3 -1,3 -16,3 -15,3 -17,3\r
+c:255 1,7 16,7 -1,7 -16,7 2,7 -2,7 32,7 -32,7\r
+w:790 15,3 17,3 -15,3 -17,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+G:640 1,3 16,3 -1,3 -16,3 15,7 17,7 -15,7 -17,7\r
+k:-435 1,34 -1,34 1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7\r
+k:-435 1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7\r
+\r
+Game: spartan\r
+8x8\r
+6 4 5 7 11 5 4 6\r
+3 10 12 8 8 12 9 3\r
+p:74 -16,64 -16,6 -15,5 -17,5 \r
+h:70  15,E4  17,E4 16,5 15,6 17,6\r
+l:290 15,7 17,7 -15,7 -17,7 30,7 34,7 -30,7 -34,7 1,6 -1,6\r
+n:259 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+b:296 15,3 17,3 -15,3 -17,3\r
+R:444 1,3 16,3 -1,3 -16,3\r
+Q:851 1,3 16,3 15,3 17,3 -1,3 -16,3 -15,3 -17,3\r
+c:255 1,7 16,7 -1,7 -16,7 2,7 -2,7 32,7 -32,7\r
+w:790 15,3 17,3 -15,3 -17,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+G:640 1,3 16,3 -1,3 -16,3 15,7 17,7 -15,7 -17,7\r
+k:-435 1,34 -1,34 1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7\r
+k:-435 1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7\r
 \r
 // Set for Chess with Different Armies, FIDE vs Color-bound Cloberers (legality-testing off!)\r
-Game: fairy\r
+Game: fairy/FIDE-Clobberers # PNBRQ.........Kp.....eac....lk\r
 8x8\r
-6 4 5 7 3 5 4 6\r
-11 9 10 12 8 10 9 11\r
+6 4 5 7 10 5 4 6\r
+12 3 8 9 11 8 3 12\r
 p:100 -16,24 -16,6 -15,5 -17,5 \r
 p:100 16,24 16,6 15,5 17,5\r
+e:320 30,7 34,7 -30,7 -34,7 16,7 -16,7 1,7 -1,7\r
+n:325 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+b:350 15,3 17,3 -15,3 -17,3\r
+R:500 16,3 -16,3 -1,3 1,3\r
+Q:950 1,3 16,3 15,3 17,3 -1,3 -16,3 -15,3 -17,3\r
+c:480 15,7 17,7 -15,7 -17,7 32,7 -32,7 2,7 -2,7 30,7 34,7 -30,7 -34,7\r
+A:875 15,3 17,3 -15,3 -17,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
 k:-1  1,34 -1,34 1,7 -1,7 16,7 15,7 17,7 -16,7 -15,7 -17,7\r
+k:-1  1,34 -1,1034 1,7 -1,7 16,7 15,7 17,7 -16,7 -15,7 -17,7\r
+l:530 15,3 17,3 -15,3 -17,3 32,7 -32,7 2,7 -2,7\r
+\r
+Game: fairy/Clobberers-FIDE # P.....EAC....LKpnbrq.........k\r
+8x8\r
+12 3 8 7 10 8 3 12\r
+6 4 5 9 11 5 4 6\r
+p:100 -16,24 -16,6 -15,5 -17,5 \r
+p:100 16,24 16,6 15,5 17,5\r
+e:320 30,7 34,7 -30,7 -34,7 16,7 -16,7 1,7 -1,7\r
 n:325 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
 b:350 15,3 17,3 -15,3 -17,3\r
 R:500 16,3 -16,3 -1,3 1,3\r
+A:875 15,3 17,3 -15,3 -17,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+c:480 15,7 17,7 -15,7 -17,7 32,7 -32,7 2,7 -2,7 30,7 34,7 -30,7 -34,7\r
 Q:950 1,3 16,3 15,3 17,3 -1,3 -16,3 -15,3 -17,3\r
 k:-1  1,34 -1,1034 1,7 -1,7 16,7 15,7 17,7 -16,7 -15,7 -17,7\r
+k:-1  1,34 -1,34 1,7 -1,7 16,7 15,7 17,7 -16,7 -15,7 -17,7\r
+l:530 15,3 17,3 -15,3 -17,3 32,7 -32,7 2,7 -2,7\r
+\r
+Game: fairy/FIDE-Nutters # PNBRQ................Kp...........h.t.c...uk\r
+8x8\r
+6 4 5 7 10 5 4 6\r
+11 3 8 9 10 8 3 11\r
+p:100 -16,24 -16,6 -15,5 -17,5 \r
+p:100 16,24 16,6 15,5 17,5\r
+h:310 31,7 33,7 15,7 17,7 -31,7 -33,7 -15,7 -17,7 \r
+n:325 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+b:350 15,3 17,3 -15,3 -17,3\r
+R:500 16,3 -16,3 -1,3 1,3\r
+Q:950 1,3 16,3 15,3 17,3 -1,3 -16,3 -15,3 -17,3\r
+u:400 31,7 33,7 14,7 18,7 1,7 -1,7 -16,7 -15,7 -17,7\r
+C:935 16,3 1,3 -1,3 14,7 31,7 33,7 18,7 15,7 17,7 -16,7 -15,7 -17,7\r
+k:-1  1,34 -1,34 1,7 -1,7 16,7 15,7 17,7 -16,7 -15,7 -17,7\r
+t:485 16,3 1,3 -1,3 -16,7 -15,7 -17,7\r
+\r
+Game: fairy/Nutters-FIDE # P...........H.T.C...UKpnbrq................k\r
+8x8\r
+11 3 6 7 10 6 3 11\r
+8 4 5 9 10 5 4 8\r
+p:100 -16,24 -16,6 -15,5 -17,5 \r
+p:100 16,24 16,6 15,5 17,5\r
+h:310 31,7 33,7 15,7 17,7 -31,7 -33,7 -15,7 -17,7 \r
+n:325 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+b:350 15,3 17,3 -15,3 -17,3\r
+u:400 -31,7 -33,7 -14,7 -18,7 1,7 -1,7 16,7 15,7 17,7\r
+C:935 -16,3 1,3 -1,3 -14,7 -31,7 -33,7 -18,7 -15,7 -17,7 16,7 15,7 17,7\r
+R:500 16,3 -16,3 -1,3 1,3\r
+Q:950 1,3 16,3 15,3 17,3 -1,3 -16,3 -15,3 -17,3\r
+k:-1  1,34 -1,34 1,7 -1,7 16,7 15,7 17,7 -16,7 -15,7 -17,7\r
+t:485 -16,3 1,3 -1,3 16,7 15,7 17,7\r
+\r
+Game: fairy/Clobberers-Nutters # P.....EAC....L.......Kp...........h.t.c...uk\r
+8x8\r
+6 4 5 7 10 5 4 6\r
+11 3 8 9 12 8 3 11\r
+p:100 -16,24 -16,6 -15,5 -17,5 \r
+p:100 16,24 16,6 15,5 17,5\r
+h:310 31,7 33,7 15,7 17,7 -31,7 -33,7 -15,7 -17,7 \r
 e:320 30,7 34,7 -30,7 -34,7 16,7 -16,7 1,7 -1,7\r
 c:480 15,7 17,7 -15,7 -17,7 32,7 -32,7 2,7 -2,7 30,7 34,7 -30,7 -34,7\r
 l:530 15,3 17,3 -15,3 -17,3 32,7 -32,7 2,7 -2,7\r
 A:875 15,3 17,3 -15,3 -17,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
-m:275 1,7 16,7 15,7 17,7 -1,7 -16,7 -15,7 -17,7\r
-H:560 14,3 31,3 33,3 18,3 -14,3 -31,3 -33,3 -18,3\r
+u:400 31,7 33,7 14,7 18,7 1,7 -1,7 -16,7 -15,7 -17,7\r
+C:935 16,3 1,3 -1,3 14,7 31,7 33,7 18,7 15,7 17,7 -16,7 -15,7 -17,7\r
+k:-1  1,34 -1,1034 1,7 -1,7 16,7 15,7 17,7 -16,7 -15,7 -17,7\r
+t:485 16,3 1,3 -1,3 -16,7 -15,7 -17,7\r
+k:-1  1,34 -1,34 1,7 -1,7 16,7 15,7 17,7 -16,7 -15,7 -17,7\r
+\r
+Game: fairy/Nutters-Clobberers # P...........H.T.C...UKp.....eac....l.......k\r
+8x8\r
+11 3 6 7 10 6 3 11\r
+5 4 8 9 12 8 4 5\r
+p:100 -16,24 -16,6 -15,5 -17,5 \r
+p:100 16,24 16,6 15,5 17,5\r
+h:310 31,7 33,7 15,7 17,7 -31,7 -33,7 -15,7 -17,7 \r
+e:320 30,7 34,7 -30,7 -34,7 16,7 -16,7 1,7 -1,7\r
+l:530 15,3 17,3 -15,3 -17,3 32,7 -32,7 2,7 -2,7\r
+u:400 -31,7 -33,7 -14,7 -18,7 1,7 -1,7 16,7 15,7 17,7\r
+C:935 -16,3 1,3 -1,3 -14,7 -31,7 -33,7 -18,7 -15,7 -17,7 16,7 15,7 17,7\r
+c:480 15,7 17,7 -15,7 -17,7 32,7 -32,7 2,7 -2,7 30,7 34,7 -30,7 -34,7\r
+A:875 15,3 17,3 -15,3 -17,3 14,7 31,7 33,7 18,7 -14,7 -31,7 -33,7 -18,7\r
+k:-1  1,34 -1,34 1,7 -1,7 16,7 15,7 17,7 -16,7 -15,7 -17,7\r
+t:485 -16,3 1,3 -1,3 16,7 15,7 17,7\r
+k:-1  1,34 -1,1034 1,7 -1,7 16,7 15,7 17,7 -16,7 -15,7 -17,7\r
 \r
 // Great Shatranj: modern variant with range-two leapers replacing sliders, on 10x8 board.\r
 // Must be played with legality testing off in XBoard 4.4.0.\r