{"id":16966581,"url":"https://github.com/erelado/ms-excel-blackjack","last_synced_at":"2026-02-17T13:02:36.580Z","repository":{"id":130985511,"uuid":"599171426","full_name":"erelado/ms-excel-blackjack","owner":"erelado","description":"A simplified, single-player version of the blackjack game using vanilla Microsoft Excel (without VBA)","archived":false,"fork":false,"pushed_at":"2023-08-30T11:28:54.000Z","size":99,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-11T08:36:18.397Z","etag":null,"topics":["black-jack","black-jack-game","blackjack","card-game","card-pack","excel","game","graphic-user-interface","gui","microsoft-excel","microsoft-office","microsoft-office-excel","ms-excel","player-vs-computer","randomized-algorithm","twenty-one"],"latest_commit_sha":null,"homepage":"","language":null,"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/erelado.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":"2023-02-08T15:47:22.000Z","updated_at":"2025-02-19T08:23:27.000Z","dependencies_parsed_at":"2025-01-26T12:41:14.547Z","dependency_job_id":"4b8de5fe-8289-45e7-bbf8-50aeebfb6a22","html_url":"https://github.com/erelado/ms-excel-blackjack","commit_stats":null,"previous_names":["erelado/ms-excel-blackjack"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/erelado/ms-excel-blackjack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erelado%2Fms-excel-blackjack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erelado%2Fms-excel-blackjack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erelado%2Fms-excel-blackjack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erelado%2Fms-excel-blackjack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erelado","download_url":"https://codeload.github.com/erelado/ms-excel-blackjack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erelado%2Fms-excel-blackjack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29545295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T13:00:00.370Z","status":"ssl_error","status_checked_at":"2026-02-17T12:57:14.072Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["black-jack","black-jack-game","blackjack","card-game","card-pack","excel","game","graphic-user-interface","gui","microsoft-excel","microsoft-office","microsoft-office-excel","ms-excel","player-vs-computer","randomized-algorithm","twenty-one"],"created_at":"2024-10-14T00:06:17.530Z","updated_at":"2026-02-17T13:02:36.550Z","avatar_url":"https://github.com/erelado.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"![Project Preview Image](/media/preview.png)\r\n\r\n# Microsoft Excel Blackjack _(Twenty-One)_\r\n\r\nThe purpose of this project was to test the built-in capabilities of Microsoft Excel tool _(**without using VBA**)_ to perform non-routine tasks. A simplified, single-player version of the popular blackjack game was developed for this purpose.\r\n\r\n## 🤔 How to play Blackjack\r\n\r\n### Object of the Game\r\n\r\nThe goal of the participant is to get as close to 21 as possible, without going over.\r\n\r\n### Card values\r\n\r\nWhether an ace is worth 1 or 11 depends on the player. Face cards are worth 10 and any other card is worth its pip value.\r\n\r\n### The play\r\n\r\nThe player goes first and decides whether to \"stand\" (not ask for another card) or \"hit\" (ask for another card in order to reach 21). Hence, a player may stand on their two cards or ask the dealer for additional cards, one at a time, until they either decide to stand on the total (if it is under 21) or go \"bust\" (if it is over 21).\r\n\r\n## 🖨️ Implementation\r\n\r\n[Manually recalculating](https://support.microsoft.com/en-us/office/change-formula-recalculation-iteration-or-precision-in-excel-73fc7dac-91cf-4d36-86e8-67124f6bcce4) the cells in the sheets is the main option used in the implementation of the game. This option prevents circular references between functions and performs calculations only when the user manually presses the `F9` key.\r\n\r\nThere are 5 cards on each player's board, with the player starting with two cards and the dealer with one. A player's card total and corresponding win/loss message will be displayed when the `F9` key is pressed.\r\n\r\n### Three sheets are in the spreadsheet\r\n\r\n#### Calculations\r\n\r\nWhere all the \"behind the scenes\" calculations are made:\r\n\r\n- Shuffling th order of the cards in the pack.\r\n- Distribution of the cards to the dealer and the participant.\r\n- In each draw, the sum of the cards is calculated for each player.\r\n\r\nThe main functions of the game are:\r\n\r\n1. `Changed Ace?` which calculates whether the sum of aces should change from 11 to 1 to allow the game to continue.\r\n2. `Sum` which calculates the player's sum and whether he reached the sum of 21 and won, or exceeded it and lost (A tie between the dealer and the player is also considered a loss).\r\n\r\n#### How to play\r\n\r\nProvides a brief explanation of the game.\r\n\r\n#### Blackjack\r\n\r\nWhere the game itself takes place, serves as the user interface for the game.\r\n\r\n## 🕹️ Getting Started\r\n\r\n### Dependencies\r\n\r\n- Microsoft Office Excel 2007, or later.\r\n\r\n### Setup\r\n\r\n1. Launch the Microsoft Excel spreadsheet on the `Blackjack` sheet.\r\n2. Set the \"Restart\" label to `TRUE` and the \"Draw more\" label to `HIT`.\r\n3. Press `F9` once, then set the \"Restart\" label to `FALSE`.\r\n\r\n### How to play\r\n\r\n1. To draw more cards, press `F9` _(the \"Draw more\" label should be set to `HIT`)_.\r\n2. When you are done asking for more cards, change \"Draw more\" label to `STAND`.\r\n3. To find out who won, press `F9` one last time _(A message stating \"you win/lose\" will appear in the middle of the game table)_.\r\n\r\n## 📝 License\r\n\r\nCopyright © 2019, erelado\r\nAll rights reserved.\r\n\r\nThis source code is licensed under the GPL-v3.0 license found in the [LICENSE](LICENSE) file in the root directory of this source tree.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferelado%2Fms-excel-blackjack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferelado%2Fms-excel-blackjack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferelado%2Fms-excel-blackjack/lists"}