{"id":19782396,"url":"https://github.com/max05643/chessdiscord","last_synced_at":"2026-05-06T13:18:46.441Z","repository":{"id":225227015,"uuid":"761974484","full_name":"Max05643/ChessDiscord","owner":"Max05643","description":"Simple Discord bot for playing chess against AI on .NET","archived":false,"fork":false,"pushed_at":"2024-03-14T11:35:48.000Z","size":77,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-11T02:32:42.909Z","etag":null,"topics":["bot","chess","discord","discord-bot","dotnet"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Max05643.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}},"created_at":"2024-02-22T20:53:00.000Z","updated_at":"2024-02-29T20:26:26.000Z","dependencies_parsed_at":"2024-03-14T12:40:42.657Z","dependency_job_id":null,"html_url":"https://github.com/Max05643/ChessDiscord","commit_stats":null,"previous_names":["max05643/chessdiscord"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Max05643%2FChessDiscord","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Max05643%2FChessDiscord/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Max05643%2FChessDiscord/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Max05643%2FChessDiscord/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Max05643","download_url":"https://codeload.github.com/Max05643/ChessDiscord/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241113273,"owners_count":19911858,"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","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":["bot","chess","discord","discord-bot","dotnet"],"created_at":"2024-11-12T06:05:03.068Z","updated_at":"2026-05-06T13:18:46.374Z","avatar_url":"https://github.com/Max05643.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chess Discord Bot\n\nWelcome to my Chess Discord Bot repository. This pet project, created by myself in my spare time, allows you to play chess against an AI 🎲🤖 in Discord channels.\n\n## Credits\n\nUsed projects:\n\n- **Stockfish**: AI Engine. [stockfishchess.org](https://stockfishchess.org/).\n- **Gera Chess Library**: Used for general infrastructure. [GitHub](https://github.com/Geras1mleo/Chess).\n- **chessboardimage.com**: Used for generating chessboard images.\n- **Discord.NET**: Discord bot framework. [GitHub](https://github.com/discord-net/Discord.Net).\n\n## Usage\n\nTo deploy this bot yourself:\n\n1. Prepare a machine with Docker installed\n2. Set up environment variables witn `.env` file with the following contents:\n\n```dotenv\nConnectionStrings__SqlStorage=\"Server=sqlserver;Database=ChessBotStorage;MultipleActiveResultSets=true;User=sa;Password=\u003cyour_password\u003e\"\nBotToken=\"\u003cyour_bot_token\u003e\"\n```\n\nReplace `\u003cyour_password\u003e` with your desired SQL Server password and `\u003cyour_bot_token\u003e` with your Discord bot token.\n\n3. Create a Docker Compose file (e.g., `docker-compose.yml`):\n\n```yaml\nversion: \"3\"\n\nservices:\n\n    bot:\n        image: \"max05643/chessbotdiscord:latest\"\n        env_file:\n            - .env\n        depends_on:\n            - sqlserver\n    sqlserver:\n        image: \"mcr.microsoft.com/mssql/server:2019-latest\"\n        environment:\n            SA_PASSWORD: \"\u003cyour_password\u003e\"\n            ACCEPT_EULA: \"Y\"\n```\n\nReplace `\u003cyour_password\u003e` with your desired SQL Server password.\n\n4. Run `docker-compose up` in your terminal to start the bot and SQL Server containers.\n\n5. Invite the bot to your Discord server using the OAuth2 URL generated from your bot application page on the Discord Developer Portal.\n\n6. Use the `/newgame True|False` command to start a game, where the argument specifies whether a human player plays as white. Use the `/move` command to make a move, and the `/remove` command to remove an existing game.\n\n[![Tests](https://github.com/Max05643/ChessDiscord/actions/workflows/testing.yml/badge.svg)](https://github.com/Max05643/ChessDiscord/actions/workflows/testing.yml) - Testing workflow status for the master branch.\n\n[![Docker](https://github.com/Max05643/ChessDiscord/actions/workflows/dotnet-desktop.yml/badge.svg)](https://github.com/Max05643/ChessDiscord/actions/workflows/dotnet-desktop.yml) - Build and push Docker container workflow status.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmax05643%2Fchessdiscord","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmax05643%2Fchessdiscord","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmax05643%2Fchessdiscord/lists"}