{"id":16876232,"url":"https://github.com/coolcat467/checkers","last_synced_at":"2025-08-17T10:04:35.026Z","repository":{"id":103142654,"uuid":"264291809","full_name":"CoolCat467/Checkers","owner":"CoolCat467","description":"Graphical Checkers Game with AI support","archived":false,"fork":false,"pushed_at":"2025-07-27T04:40:50.000Z","size":2681,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-27T06:32:38.939Z","etag":null,"topics":["ai","ai-support","checkers","checkers-game","coolcat467","networked-game","python3","single-player","two-player"],"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/CoolCat467.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,"zenodo":null}},"created_at":"2020-05-15T20:26:39.000Z","updated_at":"2025-07-27T04:40:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"dadf6f3a-818c-4878-9043-bd83a9ef118e","html_url":"https://github.com/CoolCat467/Checkers","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CoolCat467/Checkers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoolCat467%2FCheckers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoolCat467%2FCheckers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoolCat467%2FCheckers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoolCat467%2FCheckers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CoolCat467","download_url":"https://codeload.github.com/CoolCat467/Checkers/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CoolCat467%2FCheckers/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270831851,"owners_count":24653427,"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-08-17T02:00:09.016Z","response_time":129,"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":["ai","ai-support","checkers","checkers-game","coolcat467","networked-game","python3","single-player","two-player"],"created_at":"2024-10-13T15:38:43.964Z","updated_at":"2025-08-17T10:04:35.015Z","avatar_url":"https://github.com/CoolCat467.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Checkers\nGraphical Checkers Game with AI support\n\n\u003c!-- BADGIE TIME --\u003e\n\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)\n\n\u003c!-- END BADGIE TIME --\u003e\n\n## Installation\nEnsure Python 3 is installed, and use pip to install this project.\n\n```bash\npip install git+https://github.com/CoolCat467/Checkers.git\n```\n\n## Usage\nAfter installing using the command above, running the following command\nwill start the game.\n\n```bash\ncheckers_game\n```\n\n## Types of Play\nOn the title screen there are 3 play options:\n1. Singleplayer\n2. Host Networked Game\n3. Join Networked Game\n\nIn a singleplayer game, the program hosts an internal server and the client can control both players.\n\nIn Host Networked Game, program hosts the server on the local network and posts advertisements every 2 seconds or so until two clients connect (includes hosting computer)\n\nIn Join Networked Game, program will listen for server advertisements on the local network and display said servers, and when you click on a discovered LAN server client will connect and game should begin.\n\nOnce game has begun, if server was hosted, LAN server advertisements stop and play begins\n\n## How to Play\nAs per official American Checkers rules, Black plays first.\n\nTo perform a turn, click on the piece you would like to move with the mouse cursor.\nOnce this happens, all valid move destinations will be displayed via tiles with green outlines.\n\nFollowing official American Checkers rules, note that if a capture (jumping over an opponent's piece, taking that piece out of play) is available, it must be taken and otherwise valid moves non-capture moves will not be available.\n\nOnce green outline tiles appear, you can either click one of the valid destination tiles to complete your turn or click a different piece to select that piece instead.\n\nOnce you click a valid destination, that move is performed, a movement animation will be shown, and it is now the other player's turn.\n\nPlay continues indefinitely until either a player no longer has pieces they are able to move or there is no valid move they are able to complete. In these events, said player's opponent wins.\n\nInitially, all player have pawns, which are only able to move forward towards the player's opponent's side of the board.\n\nIn the event a pawn reaches the opposite side of the board, it is \"kinged\" and is now able to move in all directions.\n\nIn American Checkers, pawns can only capture in the forward direction, just like their movement. Kings do not have this limitation, likewise like their movement.\n\n\n## Playing Against A Computer Player (AI)\nThere are two computer players I have made for this game. Both connect to all discovered LAN servers and play until the game is over.\nTo start playing against Minimax AI:\n```bash\npython computer_players/MiniMax_AI.py\n```\n\nTo start playing against Max Y Position Jumping AI (very dumb):\n```bash\npython computer_players/Y_Max_Jumper_AI.py\n```\n\n\n### Links\n* Source Code - https://github.com/CoolCat467/Checkers.git\n* Issues      - https://github.com/CoolCat467/Checkers/issues\n\n### License\n-------\nCode and documentation are available according to the GNU General Public License v3.0 (see [LICENSE](https://github.com/CoolCat467/Checkers/blob/HEAD/LICENSE)).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoolcat467%2Fcheckers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoolcat467%2Fcheckers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoolcat467%2Fcheckers/lists"}