How to Make a Polyglot .ini File for UCI Chess Engines

Chess engines have revolutionized the way players analyze and compete in chess. One of the most useful tools for running UCI (Universal Chess Interface) chess engines on non-UCI compatible graphical interfaces, such as WinBoard, is the Polyglot adapter. This powerful adapter allows chess engines to interact with these interfaces, providing an all-encompassing chess experience. In this post, we’ll explore how to create a Polyglot .ini file, which is essential for configuring the adapter to work with your chess engine.

What is Polyglot?

Polyglot, developed by Fabien Letouzey, is an adapter that acts as an intermediary between UCI chess engines and non-UCI graphical user interfaces (GUIs) like WinBoard. It effectively passes commands between the engine and the interface, making them compatible.

In simple terms, the data flow looks like this:

UCI Chess Engine ←→ Polyglot Adapter ←→ Graphical User Interface (GUI)

Why Do You Need a Polyglot .ini File?

The Polyglot .ini file is a configuration file that instructs the Polyglot adapter on how to communicate with both the chess engine and the GUI. It contains specific parameters and settings that allow the engine to function correctly within the chosen interface.

Steps to Create a Polyglot .ini File

1. Choose Your Chess Engine

For this example, let’s use the Delphi Chess Engine by Fabio Cavicchio, which can operate as both a UCI or WinBoard engine. We’ll configure it as a UCI engine.

You can download the Delphi engine from its official website here.

2. Open a Text Editor

To create the .ini file, use a simple text editor like Notepad. In the new document, you will create two sections: [Polyglot] and [Engine].

The [Polyglot] section will contain settings that define how Polyglot interacts with the GUI. The [Engine] section will specify how it communicates with the chess engine.

3. Polyglot Section Setup

In your text editor, begin by adding the [Polyglot] header. Below this header, you can add various configuration options, some of which are mandatory and others optional. The options might vary depending on the version of Polyglot you’re using, so make sure to consult the "Read Me" file included in your Polyglot distribution for more details.

Here’s an example of basic options for the [Polyglot] section:

ini
[Polyglot]
EngineDir = c:\Delphi
EngineCommand = delphi.exe
Book = true
BookFile = c:\Polyglot\book.bin
LogFile = polyglot.log

• EngineDir: The folder where your chess engine is located.
• EngineCommand: The executable file of the engine.
• Book: Determines whether Polyglot should use an opening book. Set to true if you have a book file, otherwise set to false.
• BookFile: The path to the opening book file if you’re using one.
• LogFile: A log file to track engine activity.

4. Engine Section Setup

Next, we configure the [Engine] section, which contains specific UCI settings for the chess engine. To find these settings, you need to run the engine in UCI mode. For Delphi, this means opening the engine and typing uci in the command prompt, which will display the UCI options.

Here’s an example of how the [Engine] section might look:

ini
[Engine]
Name = Delphi
Author = Fabio Cavicchio
Hash = 128
Ponder = false

• Name: The name of the engine.
• Author: The author of the engine.
• Hash: The amount of memory (in MB) allocated for the engine’s hash table.
• Ponder: Whether the engine should think during your opponent’s turn (set to true or false).

5. Copy UCI Options from Engine

Each UCI engine has specific options that you can choose to include in the .ini file. These options are engine-specific, and you may choose to leave many of them at their default settings. For advanced users, experimenting with different engine configurations can improve engine performance based on personal preferences.

To capture the UCI options:

• Run the engine.
• Copy the options displayed in the command window.
• Paste them into the [Engine] section of your .ini file.

6. Save the File

Once you have configured the .ini file, save it as polyglot.ini in the same directory where polyglot.exe is located. This ensures that Polyglot can properly read the file and initialize the chess engine with the specified settings.

Example Polyglot .ini File

Here’s an example of what a completed Polyglot .ini file might look like for the Delphi engine:

ini
[Polyglot]
EngineDir = c:\Delphi
EngineCommand = delphi.exe
Book = false
LogFile = polyglot.log
Resign = true
ResignScore = -600

[Engine]
Name = Delphi
Author = Fabio Cavicchio
Hash = 128
Ponder = false

Alternative: Using Polyglot_GUI

If creating .ini files manually sounds too complex, you can use Polyglot_GUI, a user-friendly utility developed by Alex Guerrero. This tool provides a graphical interface to simplify the process of creating Polyglot .ini files. You can find more information and download it here.

Final Tips

• Always double-check the engine-specific documentation for any additional options you may want to include.
• Remember to change the Book=true option to Book=false if you're not using an opening book.
• Keep backup copies of your .ini files, especially if you're tweaking settings for optimal engine performance.

By following this guide, you'll be able to configure Polyglot to run your favorite UCI engines in WinBoard or other non-UCI interfaces, opening up a world of possibilities for your chess analysis and gameplay.

---

References:

• Delphi Chess Engine: www.msbsoftware.it/delphi/
• Polyglot Download: Polyglot by Fabien Letouzey
• Polyglot_GUI by Alex Guerrero: Polyglot_GUI