{"id":22946573,"url":"https://github.com/kfox/mindmaster","last_synced_at":"2026-03-20T00:02:58.912Z","repository":{"id":91416934,"uuid":"216244983","full_name":"kfox/mindmaster","owner":"kfox","description":"MasterMind for the Commodore 128","archived":false,"fork":false,"pushed_at":"2024-10-04T21:27:37.000Z","size":337,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-07T14:45:39.758Z","etag":null,"topics":["commodore","commodore-128","mastermind","mastermind-game"],"latest_commit_sha":null,"homepage":null,"language":"BASIC","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/kfox.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":"2019-10-19T17:30:41.000Z","updated_at":"2024-10-04T21:27:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"9de2ede2-f418-40cc-a9cb-d7ea65b8ac5f","html_url":"https://github.com/kfox/mindmaster","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfox%2Fmindmaster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfox%2Fmindmaster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfox%2Fmindmaster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfox%2Fmindmaster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kfox","download_url":"https://codeload.github.com/kfox/mindmaster/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246724609,"owners_count":20823542,"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":["commodore","commodore-128","mastermind","mastermind-game"],"created_at":"2024-12-14T14:47:20.147Z","updated_at":"2026-01-11T01:52:26.725Z","avatar_url":"https://github.com/kfox.png","language":"BASIC","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mindmaster\n\nThe game of [Mastermind](https://en.wikipedia.org/wiki/Mastermind_(board_game)) for the Commodore 128\n\n![mindmaster logo](./images/mindmaster-logo.gif)\n\n## Loading the Game\n\nCopy the [disk image](mindmaster.d64) file to a floppy disk or open it with a Commodore 128 emulator, such as `x128` in [VICE](http://vice-emu.sourceforge.net/).\n\nOn the Commodore 128 (in 128 mode only), type the following. (Note that an emulator might do this for you automatically.)\n\n```basic\nLOAD \"*\",8\nRUN\n```\n\n## Playing the Game\n\nMindmaster is a code-breaking game where you attempt to guess the correct combination and sequence of several colored \"pegs\" that have been randomly selected by the computer.\n\n### Game Options\n\n![mindmaster options](./images/options.png)\n\nOn the initial screen, you have four options:\n\n- Press **N** for Normal mode (equivalent to original Mastermind)\n- Press **E** for Expert mode (equivalent to Super Mastermind)\n- Press **C** for Custom mode\n- Press **Q** to Quit\n\nIf you've already played a game, pressing the **spacebar** will start a new game using the options you previously selected.\n\n### Game Modes\n\nIf you select normal or expert modes, the game will immediately begin. If you select custom mode, you will be prompted to customize the following values:\n\n- the number of guesses you have (rows)\n- the number of pegs per row (columns)\n- the possible number of peg colors\n\nHere's a summary of the available game modes:\n\n| Mode   | Rows | Columns | Colors |\n|--------|------|---------|--------|\n| Normal | 10   | 4       | 6      |\n| Expert | 12   | 5       | 8      |\n| Custom | 2-20 | 2-8     | 2-13   |\n\nNote that colors may be repeated and no blanks are allowed in the solution.\n\n### In-Game Controls\n\n![mindmaster controls](./images/controls.gif)\n\n1. Move the flashing arrow up and down using the up and down cursor keys.\n2. To select a colored peg, hit the spacebar.\n3. Use the left cursor key to undo a selection.\n4. Selecting the column's last peg will submit your guess.\n\n### Feedback and Winning\n\n![mindmaster solution](./images/solution.png)\n\nOnce you submit your guess, a set of zero or more feedback pegs may be displayed to the left of that row.\n\n- Each dark grey peg indicates that one peg in your guess is the correct color and in the correct position.\n- Each white peg indicates that one peg in your guess is the correct color, but in the wrong position.\n- No feedback pegs are shown for a peg that is the wrong color, i.e. no pegs of that color are present in the solution.\n\nYou win if you guess the code before you run out of guesses.\n\n## Compiling\n\nInstall development tools appropriate for your platform, including GNU Make.\n\nYou'll need to install VICE (for the `petcat`, `c1541`, and `x128` executables). On macOS using Homebrew:\n\n```sh\nbrew install vice\n```\n\nTo compile and automatically run using the `x128` emulator:\n\n```shell\nmake\n```\n\n## Notes\n\nI originally wrote this in 1991. The original version used a joystick in port 2 to play, but I recently updated the controls to use the cursor keys and spacebar to make it easier to play in an emulator.\n\nThe game uses a [custom character set](./mindmaster.chr) that I created, as well. (See below for example.)\n\n![mindmaster charset](./images/charset.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkfox%2Fmindmaster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkfox%2Fmindmaster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkfox%2Fmindmaster/lists"}