Arcanum is a free UCI chess engine under the GPL-3.0 license. Arcanum 2.3 has a rating of ~3140 elo in blitz on CCRL.
Arcanum requires c++17 and has only been tested using g++. It can be compiled on Windows (Tested for Windows 11 using MinGW), and Linux (Tested for Ubuntu 22.04). Arcanum takes advantage of and requires some x86 intrinsics: AVX2, FMA, BMI1, BMI2 POPCNT and LZCNT.
To build a development build, run:
make -j
This will create a build directory and build a staticly linked executable. The development build allows Arcanum to log information to the terminal. This can however interfere with the UCI protocol, thus it is not recomended to use this build when connecting to a UCI gui.
To delete the build directory and its contents all the contents, run:
make clean
To build a release build, meant for connecting to a UCI GUI such as Cute Chess or Lucas Chess, -DPRINT_TO_FILE should be added to CFLAGS. This redirects all logging to a file. It is also possible to add -DDISABLE_DEBUG, -DDISABLE_LOG, -DDISABLE_WARNING and -DDISABLE_ERROR to the CFLAGS to disable these logs.
To add a version name, which shows up in the id section of the UCI protocol, -DARCANUM_VERSION=<version> can be added to the CFLAGS. If not included, the version will be set to dev_build.
A simpler approach is to run:
make release -j NAME=<executable-name> VERSION=<version>
This creates a clean build named <executable-name> with version <version> which logs to file, and only have warnings and errors enabled. The build will be copied to the releases directory.
Arcanum has a floating point NNUE, which is created from selfplay, starting from the HCE from Arcanum v1.12.
The architecture is 768->256->32->1, where the feature set is 'flipped' based on the perspective rather than having two feature transformers.
Both the inference and backpropagation is written from scratch and requires AVX2.
The path to the NNUE file can be set by the UCI command:
setoption name nnuepath value <path>
where <path> is the path relative to the Arcanum executable file.
Arcanum has an option to enable the use of Syzygy, an endgame table base. This is implemented using an adaptation of Pyrrhic by AndyGrant. To enable Syzygy, use the UCI command:
setoption name syzygypath value <folder>
where <folder> is the absolute path to the folder containing the tablebase.
From v2.4 and onward, Incbin by graphitemaster is used to embed the default nnue net into the executable. If the nnue path is equal to the default path, the embedded net will be used.
This can be disabled by removing -DENABLE_INCBIN from the makefile when building.
All of the following UCI options are available in Arcanum.
| Name | Type | Default | Description |
|---|---|---|---|
| Hash | Spin | 32 | Number of MBs to allocate for the transposition table. If 0, the transposition table will be disabled. |
| ClearHash | Button | Clears the transposition table. | |
| SyzygyPath | String | <empty> | Absolute path to the Syzygy directory. If <empty>, Syzygy will be disabled. |
| NNUEPath | String | arcanum‑net‑v4.0.fnnue | Path to the NNUE net relative to the executable. If the default value is used, the net embedded in the executable will be used. |
| MoveOverhead | Spin | 10 | Number of ms to assume as move overhead. MoveOverhead is subtracted from the remaining time before doing time management. If MoveOverhead is larger than the remaining time, 1ms will be used. |
| NormalizeScore | Check | True | Normalize the score reported in UCI info such that 100cp equates to a ~50% chance to win |
| Version | CCRL Blitz | CCRL 40/15 |
|---|---|---|
| 2.4 | 3195 | |
| 2.3.* | 3129 | 3107 |
| 2.2 | 2926 | 2929 |
| 2.1 | 2724 | |
| 2.0 | 2456 | |
| 1.12 | 2227 | 2228 |
| 1.11.* | 2140 |