{"id":24708025,"url":"https://github.com/pungrumpy/ai-chinese-checker","last_synced_at":"2025-10-09T09:31:48.186Z","repository":{"id":264968184,"uuid":"868752928","full_name":"PunGrumpy/ai-chinese-checker","owner":"PunGrumpy","description":"🤖 A Chinese Checkers (Sternhalma) game using mostly pygame-ce.","archived":false,"fork":false,"pushed_at":"2024-10-15T12:33:09.000Z","size":5049,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-01T13:39:29.785Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PunGrumpy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-07T05:57:52.000Z","updated_at":"2024-10-15T12:33:13.000Z","dependencies_parsed_at":"2024-11-27T02:23:13.009Z","dependency_job_id":null,"html_url":"https://github.com/PunGrumpy/ai-chinese-checker","commit_stats":null,"previous_names":["pungrumpy/ai-chinese-checker"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/PunGrumpy/ai-chinese-checker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PunGrumpy%2Fai-chinese-checker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PunGrumpy%2Fai-chinese-checker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PunGrumpy%2Fai-chinese-checker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PunGrumpy%2Fai-chinese-checker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PunGrumpy","download_url":"https://codeload.github.com/PunGrumpy/ai-chinese-checker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PunGrumpy%2Fai-chinese-checker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001135,"owners_count":26083022,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-27T06:27:34.223Z","updated_at":"2025-10-09T09:31:47.570Z","avatar_url":"https://github.com/PunGrumpy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐉 Chinese Checkers Game\n\n![Preview](./images/preview.png)\n\n## 🏓 Table of Contents\n\n- [🔗 Presentation](#-presentation)\n- [🤔 What is Chinese Checkers?](#-what-is-chinese-checkers)\n- [🎮 How to Play](#-how-to-play)\n  - [📚 Rules](#-rules)\n- [🤖 AI Features](#-ai-features)\n- [🚀 Technologies](#️-technologies)\n- [🛠️ Setup and Installation](#️-setup-and-installation)\n- [📩 How to Download Executable File](#-how-to-download-executable-file)\n- [📝 License](#-license)\n- [💖 Thanks for owner of this project](#-thanks-for-owner-of-this-project)\n- [💕 Contributors](#-contributors)\n\n## 🔗 Presentation\n\n[Canva Presentation Click Here 👆](https://www.canva.com/design/DAGTKP0zSgY/pxgsmrTI43hyLHRegx7mhQ/edit?utm_content=DAGTKP0zSgY\u0026utm_campaign=designshare\u0026utm_medium=link2\u0026utm_source=sharebutton)\n\n## 🤔 What is Chinese Checkers?\n\n**Chinese Checkers** is a strategy board game originating from Germany, known as \"**Sternhalma**\". It can be played by two, three, four, or six players, either individually or in teams. The game is a modern and simplified variation of the game **Halma**.\n\n## 🎮 How to Play\n\nThe game is played on a star-shaped board with 121 spaces. Each player has 10 pieces of a unique color, which start at one of the six points of the star and aim to reach the opposite point.\n\nThe gameplay is turn-based, where a player can move one piece to an adjacent space or jump over other pieces. A player can jump over their own pieces or their opponents' pieces and can perform multiple jumps in a single turn.\n\nThe game ends when a player successfully moves all of their pieces to the opposite point. The first player to achieve this wins the game.\n\n### 📚 Rules\n\n- Players can move one piece to an adjacent space or jump over other pieces.\n- Players can jump over their own or opponents' pieces.\n- Multiple jumps are allowed in a single turn.\n- The game ends when a player moves all their pieces to the opposite point.\n- The player who moves all their pieces first wins.\n\n## 🤖 AI Features\n\n[Find our AI algorithms here](./bots)\n\n| Name                  | Description                                           | Emotion |\n| --------------------- | ----------------------------------------------------- | ------- |\n| **Greedy Easy Bot**   | Moves a random piece to the best adjacent space.      | 🎲🤑    |\n| **Greedy Normal Bot** | Always moves the topmost piece to the best space.     | 🤑      |\n| **Greedy Hard Bot**   | Always moves and jumps throught the maximum distance. | 🤑🤑    |\n| **Minimax Bot**       | Uses Minimax algorithm with Alpha-Beta Pruning.       | 🧠      |\n\n\u003e [!WARNING]\n\u003e The **Minimax Bot** is not recommended for 3 or more players because it worst performance.\n\n## 🚀 Technologies\n\n- [🐍 Python](https://www.python.org/) - Programming language.\n- [🎨 Pygame](https://pyga.me/) - Set of Python modules designed for writing video games.\n- [📚 PySide6](https://doc.qt.io/qtforpython-6/) - Official Python bindings for the Qt framework.\n\n## 🛠️ Setup and Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/PunGrumpy/ai-chinese-checkers.git\n   cd ai-chinese-checkers\n   ```\n2. Create and activate a virtual environment:\n   ```bash\n   python -m venv .venv\n   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate\n   ```\n3. Install the required dependencies:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. Run the game:\n   ```bash\n   python main.py\n   ```\n\n## 📩 How to Download Executable File\n\n1. Go to [Releases](https://github.com/PunGrumpy/ai-chinese-checker/releases) page\n2. Download the Assets file\n3. Select executable file (only for Windows OS)\n\n[Click here to download the executable file](https://github.com/PunGrumpy/ai-chinese-checker/releases/download/v1.1.0/Chinese-Checkers-with-AI.exe)\n\n## 📝 License\n\nThis project is licensed under the GNU General Public License v3.0. See the [LICENSE](LICENSE) file for details.\n\n## 💖 Thanks for owner of this project\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://github.com/henrychess\"\u003e\n        \u003cimg src=\"https://avatars.githubusercontent.com/u/91649568?v=4\" width=\"100px;\" alt=\"HenryChess\"/\u003e\n        \u003cbr /\u003e\n        \u003csub\u003e\u003cb\u003eHenryChess\u003c/b\u003e\u003c/sub\u003e\n      \u003c/a\u003e\n      \u003cbr /\u003e\n      \u003ca title=\"Owner\" href=\"https://github.com/henrychess/Chinese-Checkers\"\u003e👑\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## 💕 Contributors\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://github.com/PunGrumpy\"\u003e\n        \u003cimg src=\"https://avatars.githubusercontent.com/u/108584943?v=4\" width=\"100px;\" alt=\"Noppkorn Kaewsalabnil\"/\u003e\n        \u003cbr /\u003e\n        \u003csub\u003e\u003cb\u003ePunGrumpy\u003c/b\u003e\u003c/sub\u003e\n      \u003c/a\u003e\n      \u003cbr /\u003e\n      \u003ca title=\"Algorithm Developer\" href=\"https://github.com/PunGrumpy\"\u003e🧠\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://github.com/Bobby9326\"\u003e\n        \u003cimg src=\"https://avatars.githubusercontent.com/u/95424584?v=4\" width=\"100px;\" alt=\"Siwakorn Boonkaew\"/\u003e\n        \u003cbr /\u003e\n        \u003csub\u003e\u003cb\u003eBobby9326\u003c/b\u003e\u003c/sub\u003e\n      \u003c/a\u003e\n      \u003cbr /\u003e\n      \u003ca title=\"Game Logic Developer\" href=\"https://github.com/Bobby9326\"\u003e🎮\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpungrumpy%2Fai-chinese-checker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpungrumpy%2Fai-chinese-checker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpungrumpy%2Fai-chinese-checker/lists"}