About this program:
*******************
SpearShogidokoro.exe is a shogi playing engine for Shogidokoro.
Release date: May 23rd, 2008

Current Version:
**************** 
This is the version that played in the 2008 CSA World Computer Shogi Championships.
It finished 12th in the second preliminary round (15th overall) out of 40 programs.
Its current estimated strength is about 3-dan at its top level (unconfirmed).

Installation instructions:
**************************
1) Install Shogidokoro

   This program can be downloaded from the following website:
   
   http://www.geocities.jp/Shogidokoro/download.html

   This page is in Japanese, but downloading can be done by clicking the second link from the top
   (not the link with the word "Lesserkai" in it, but the link that has "1.7.2" before it).

   A straight link to the downloadable file is:
   
   http://www.geocities.jp/Shogidokoro/download/Shogidokoro.zip

   Unzip this file in any directory.

   IMPORTANT: Shogidokoro only works when .NET Framework is installed (version number 2.0 or higher).
   .NET Framework can be downloaded here:
   
   http://msdn.microsoft.com/en-us/netframework/aa569263.aspx (English version)
   http://www.microsoft.com/japan/msdn/netframework/downloads/ (Japanese version)

2) Install the Spear engine
   
   Download location of the engine plus necessary files:

   http://gamelab.yz.yamagata-u.ac.jp/SHOGI/SPEAR/SpearShogidokoro2008.zip

   Unzip these files in any directory.

   After unzipping the contents of the directory should look like this:
   
   * File: SpearShogidokoro.exe
   * File: Spear.ini
   * File: ReadMe.txt
   * Subdirectory: Book
         File: book.db
         File: dbfrq.idx
   * Subdirectory: Maps
         File: attdismaps.pat
         File: defdismaps.pat

3) Start up Shogidokoro (NOT the Spear engine!!)
   a) Select "Engine Manager..." from the "Game" menu.
   b) Select "Add..."
   c) Go the directory where the Spear engine files are installed and click on "SpearShogidokoro.exe"

   The Spear engine is now available inside Shogidokoro and can be used to play against.
   IMPORTANT NOTE: It is possible that the Spear engine fails to load the first time (Shogidokoro will
   give an error message, complaining that this is "not an USI engine"). I have no idea why this happens
   but loading the engine again should fix the problem.

Available options:
******************
The current version of the Spear engine comes with three options (select "Engine Configuration" in
the "Engine Manager" or when starting a game):
1) SpearLevel: This option can be used to select the playing level from 1 to 10. Level 1 is rather weak,
but level 10 is the program that played in the 2008 CSA Computer Shogi World Championships.
2) ThreadNumber: This allows Spear to run on multiple CPUs or multiple cores. This option allows
Spear to run on up to 64 CPUs (cores), but I have never tested it beyond 4.
3) UseBookUntilMove: This option defines until what move to use the opening book. Note that Spear has no
opening book for handicap play, so it will not vary the moves when playing handicap.

Some other things:
******************
- Spear has a mating solver which can be called using Shogidokoro. This mating solver is rather primitive
compared to the best programs. It uses the best algorithm (df-pn), but not in its proper implementation.
It will find most mates very quickly, but sometimes will fail to find a rather easy mate.
- Spear has dynamic allocation of hash table memory implemented. The standard setting in Shogidokoro is
32 MB, but this can be changed to any value. Bigger hash tables are supposed to increase the level of
play, but I have not confirmed this.

Disclaimer:
***********
The Spear engine can be used and distributed freely, but of course the program comes without any warranty.

Please send any bug reports to: grim@yz.yamagata-u.ac.jp
