initial commit

Author: UndefinedCpp

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Emerald Chess Engine
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,28 @@
+# Overview
+
+This is a toy chess engine I developed over two weeks as part of my winter break project. It is **UCI-compatible**, and plays roughly at the level of **1600 Elo** (unofficial; tested on my laptop, TC 10+0.1).
+
+This software **does not** come with a GUI, so if you want to play it you will need to download one from Internet. I recommend [en-croissant](https://github.com/franciscoBSalgueiro/en-croissant).
+
+This engine is still **WIP** and will be updated from time to time, though I do not currently have any plans for updating.
+
+## Compiling
+
+I currently have a small build script that compiles the engine with `g++` (`build.py`). Why, you may ask, don't you use `Makefile`? Because I don't know how to use it yet... (What a shame) I will probably move to `Makefile` in the future.
+
+Nevertheless, I have compiled the binary for Windows and you can find it in the release page.
+
+## License
+
+This project is licensed under the MIT License.
+
+## Acknowledgements
+
+During the development, I have referred to and learned from a lot of resources, including:
+
+- [Stockfish](https://github.com/official-stockfish/Stockfish/tree/master) source code (and its previous versions)
+- [Stockfish Evaluation Guide](https://hxim.github.io/Stockfish-Evaluation-Guide/) - thank you for this comprehensive interactive wiki!
+- Sebastian Lague's [Coding Adventure Bot](https://github.com/SebLague/Chess-Coding-Adventure/tree/Chess-V2-UCI) and his excellent [Youtube videos](https://www.youtube.com/watch?v=_vqlIPDR2TU) on chess programming!
+- [Chess Programming Wiki](https://www.chessprogramming.org/Main_Page/) - an amazing place to learn about every aspects of chess programming!
+- [Disservin](https://github.com/Disservin)'s [chess library](https://github.com/Disservin/chess-library) and his engine testing tool [fastchess](https://github.com/Disservin/fastchess)!
+

build.py

@@ -0,0 +1,56 @@
+import os
+import argparse
+import subprocess
+
+parser = argparse.ArgumentParser(description='Build the project')
+parser.add_argument('--optimize', '-O', action='store_true',
+                    help='Optimize the build', default=True)
+parser.add_argument('--arch', '-a', type=str, default='native')
+parser.add_argument('--target', type=str, default='engine.exe')
+parser.add_argument('--run', '-r', action='store_true',
+                    help='Run the program after building', default=False)
+parser.add_argument('--static', action='store_true')
+parser.add_argument('--iterative', action='store_true')
+
+SOURCE_DIR = './src'
+
+if __name__ == '__main__':
+    args = parser.parse_args()
+
+    source_files = []
+    for filename in os.listdir(SOURCE_DIR):
+        if filename.endswith('.c') or filename.endswith('.cpp'):
+            source_files.append(os.path.join(SOURCE_DIR, filename))
+
+    if args.iterative:
+        if os.path.exists('./build/engine.old.exe'):
+            os.remove('./build/engine.old.exe')
+        if os.path.exists('./build/engine.exe'):
+            os.rename('./build/engine.exe', './build/engine.old.exe')
+
+    command = [
+        'g++',
+        '-O3' if args.optimize else '',
+        *source_files,
+        '-Wall',
+        '-std=c++17',
+        f'-march={args.arch}',
+        '-o',
+        f'./build/{args.target}',
+    ]
+    if args.static:
+        command.extend([
+            '-static-libstdc++',
+            '-static-libgcc',
+            '-static'
+        ])
+
+    print(f'Executing {" ".join(command)}')
+    ret = subprocess.run(command).returncode
+    print('Build finished with code {}'.format(ret))
+
+    if args.run and (ret == 0):
+        print('== Engine', '=' * 70)
+        ret = subprocess.run(['./build/engine.exe']).returncode
+        print('=' * 80)
+        print('Program finished with code {}'.format(ret))

log.md

@@ -0,0 +1,42 @@
+# Improvements and Changes
+
+## Roadmap
+
+This section describes the general things to implement.
+
+### Search
+
+- [x] **negamax** with alpha-beta pruning
+- [x] **quiescence search**
+- [x] **iterative deepening** framework
+- [x] **null move pruning**
+- [x] **killer moves**
+- [x] **MVV/LVA** move ordering
+- [x] **transposition table**
+- [ ] **late move reductions**
+- [ ] **futility pruning**
+
+### Evaluation
+
+**Part 1** HCE
+
+- [x] **piece** value
+- [x] **mobility**
+- [ ] **king safety**
+- [ ] passed **pawns**
+- [ ] **pawn** structure
+- [ ] **threats**
+- [x] **space**
+
+**Part 2** NNUE transition
+
+- [ ] **NNUE** data generation
+- [ ] **NNUE** training
+- [ ] **NNUE** evaluation support 
+
+### Engine
+
+- [ ] **opening book**
+- [x] basic **UCI** support
+- [ ] **options**
+- [ ] **syzygy** endgame tablebase