Komugi is the world's first complete Gungi AI engine and the first to use NNUE neural network evaluation.
Komugi 是世界上第一個規則完整的軍儀棋 AI 引擎，也是第一個採用神經網路（NNUE）評估的軍儀棋 AI。
📖 Rule Source / 規則來源：This engine fully implements the official 2022 Gungi rules (released by Universal Music, supervised by the HUNTER×HUNTER Gungi Special Team). / 本引擎完全採用 2022 年官方發行之正版軍儀棋規則（Universal Music 發行，HUNTER×HUNTER 軍儀特別團隊監修）。
Gungi is a fictional board game from the manga Hunter x Hunter, known for its complex stacking mechanism and tier system. Its rule complexity exceeds that of Go.
軍儀棋是出自漫畫《Hunter x Hunter》的虛構棋類，以其複雜的疊層機制和段數系統聞名，規則複雜度高於圍棋。
| Item / 項目 | Description / 說明 |
|---|---|
| Rule Completeness / 規則完整度 | ✅ First to fully implement the official 2022 Gungi rules / 全球第一個完整實作 2022 官方正版規則 |
| Technical Architecture / 技術架構 | ✅ First to use NNUE neural network evaluation for Gungi / 全球第一個使用 NNUE 神經網路評估 |
| Open Source Pioneer / 開源先驅 | ✅ First open-source Gungi AI engine / 全球第一個開源的軍儀棋 AI 引擎 |
| Playing Strength / 棋力強度 | ✅ Currently the strongest Gungi AI in the world (no other public engine to compare) / 目前全球最強（無其他公開引擎可比較） |
- ✅ Complete Gungi rules (stacking, tiers, betrayal, leap attacks, piece drops) / 完整軍儀棋規則（疊層、段數、背叛、飛越攻擊、手駒投放）
- ✅ Full adoption of 2022 official rules / 完全採用 2022 官方正版規則
- ✅ UCI protocol support (compatible with Arena, Cute Chess, etc.) / UCI 協議支援（可對接 Arena、Cute Chess 等 GUI）
- ✅ NNUE neural network evaluation (world first) / NNUE 神經網路評估（全球首創）
- ✅ Alpha-Beta + Transposition Table + LMR + Killer + History
- ✅ Iterative deepening + Aspiration window + Time control / 迭代深化 + 渴望視窗 + 時間控制
- C++17 compiler (g++ 11+ / clang 14+ / MSVC 2019+) / C++17 編譯器
- (Optional) ONNX Runtime — required for NNUE / （選用）ONNX Runtime — 使用 NNUE 時需要
Using Makefile / 使用 Makefile：
make
Manual compilation (without NNUE) / 手動編譯（不使用 NNUE）：
bash
g++ -O3 -std=c++17 -o komugi main.cpp
Note: Manually comment out #define NNUE_ENABLED in komugi_engine_v4_6.h / 注意：需手動註解 komugi_engine_v4_6.h 中的 #define NNUE_ENABLED
Manual compilation (with NNUE, requires ONNX Runtime) / 手動編譯（使用 NNUE，需安裝 ONNX Runtime）：
bash
g++ -O3 -std=c++17 -o komugi main.cpp -lonnxruntime
Run UCI mode / 執行 UCI 模式
bash
./komugi
Then enter / 然後輸入：
text
uci
position startpos
go depth 10📂 File Structure / 檔案說明 File / 檔案 Description / 說明 komugi_engine_v4_6.h Main engine / 主引擎程式碼 komugi_nnue.h NNUE evaluation module / NNUE 評估模組 main.cpp Program entry / 程式入口點 komugi_model.onnx NNUE model (optional) / NNUE 模型檔（選用） gungi_rulebook_jp.pdf Official 2022 rulebook / 2022 官方正版規則書 📜 License / 授權 This project is licensed under the MIT License.
本專案採用 MIT 授權。
text MIT License
Copyright (c) 2025 Komugi Engine Authors
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. 🙏 Acknowledgments / 致謝 Hunter x Hunter original author — Yoshihiro Togashi / 《Hunter x Hunter》原作 — 冨樫義博
2022 Official rules — Universal Music / HUNTER×HUNTER Gungi Special Team / 2022 官方正版規則 — Universal Music / HUNTER×HUNTER 軍儀特別團隊
NNUE technology — Stockfish team / NNUE 技術 — Stockfish 團隊
📧 Contact / 聯絡 If you have any questions or suggestions, please open an Issue.
若有任何問題或建議，歡迎開 Issue 討論。
⭐ If this project helps you, give it a star! / 如果這個專案對你有幫助，請給一顆星！