{"id":21328461,"url":"https://github.com/mrcook/pitman-basic","last_synced_at":"2025-03-16T00:17:10.008Z","repository":{"id":206805613,"uuid":"678153728","full_name":"mrcook/pitman-BASIC","owner":"mrcook","description":"HuBASIC source for PITMAN, a 1985 game for the Sharp MZ-700/1500 computers","archived":false,"fork":false,"pushed_at":"2023-08-13T21:24:51.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-22T12:49:05.777Z","etag":null,"topics":["basic-programming","family-basic","game","mz-700","source-code"],"latest_commit_sha":null,"homepage":"","language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrcook.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-08-13T21:24:42.000Z","updated_at":"2023-11-21T16:20:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"18865312-52df-4902-8f7d-68de91854156","html_url":"https://github.com/mrcook/pitman-BASIC","commit_stats":null,"previous_names":["mrcook/pitman-basic"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrcook%2Fpitman-BASIC","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrcook%2Fpitman-BASIC/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrcook%2Fpitman-BASIC/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrcook%2Fpitman-BASIC/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrcook","download_url":"https://codeload.github.com/mrcook/pitman-BASIC/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243806114,"owners_count":20350783,"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":["basic-programming","family-basic","game","mz-700","source-code"],"created_at":"2024-11-21T21:29:15.134Z","updated_at":"2025-03-16T00:17:09.983Z","avatar_url":"https://github.com/mrcook.png","language":"Assembly","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PITMAN - Source Code\n\nHere is the HuBASIC source code for the classic **PITMAN** game, released in\nAugust 1985 as a type-in from the Japanese magazine Oh!MZ, playable on Sharp\nMZ-700/1500 computers.\n\n\n## Code Transcription Notes\n\nThe BASIC source contains control characters and special graphic characters\nunique to Sharp MX-700/1500 computers. Here are some notes on how those were\nhandled when transcribing from the magazine.\n\n* CLR (clear screen) control character, replaced with ⓒ\n* Move Cursor/Arrow key input control characters, replaced with ← → ↑ ↓\n* Various graphic characters are replaced with an appropriate ASCII/Unicode\n  character (e.g. ▄ and ▒)\n* LINE 170: stick figure sprite for the player lives, replaced with §\n* LINES 1160-1240: included Japanese translations, these have been omitted\n\n\n## Oh!MZ Game Article\n\nThe following text is transcribed from the Oh!MZ, August 1985 magazine article\n(_online tools were used for this translation, which was then manually\nedited and formatted_).\n\nPITMAN is a puzzle game with 50 levels designed for the Sharp MZ-700 or MZ-1500, and written in HuBASIC.\n\n### How to type in/execute the game\n\nType in the BASIC code found in Listing 1 (`pitman.bas`), and save it\n\n```basic\nSAVE \"PITMAN\"\n```\n\nPlease type the machine language from Listing 2 (`levels.asm`) with\n\n```basic\nLIMIT \u0026HE000\n```\n\nAfter entering the data and verifying the checksum, save it\n\n```basic\nSAVEM \"PIT\", \u0026HE000, \u0026HF300\n```\n\nRun the game with\n\n```basic\nRUN \"PITMAN\"\n```\n\nThe game will start after automatically loading the machine language data. If you stop the program in the middle, press `F1` to resume execution.\n\n### How to Play\n\nWhen the title screen appears, press the space bar or keys 1-9 to start the game. If you press the space bar, you will start from the 1st level, and if you press 1 to 9, you will start from the level that is the number multiplied by 5.\n\nThe purpose of the puzzle is to operate PITMAN with the cursor keys and collect all the gold castles on the screen.\n\nThe rules are as follows:\n\n* **Ladders** - PITMAN can move up, down, left and right.\n* **Gold Bullion** - Can only be taken from the left or right. If there is a blank space under the gold nugget, the nugget will fall.\n* **Soil** - Dig from the left or right to proceed. Once dug, it disappears and cannot be restored.\n* **Stone** - You can move it left or right. It will fall like a gold nugget.\n* **Wall** - Blocks your way. You can't even push it. It doesn't fall.\n* **PITMAN** - When the floor is missing and you are not on the ladder, you will fall, and when the top is missing you can jump (there is a level where you can use this jump). You can move up, down, left and right according to the above rules.\n\nThe following commands can be used during the game.\n\n* `G`: **GIVE UP** - Play the same level with one less life. Press it when you get stuck.\n* `N`: **NEXT** - Loose a life and play the next level.\n* `B`: **BACK** - Play the previous level by one less.\n* `E`: **EDITOR** - Enter the editor.\n* `F1` - Return to the title screen.\n\n### Editor\n\nWe've added an editor to this game with the idea of finding new designs with the user's creativity. The editor is entered by pressing the `E` key on the title screen or while playing the game. The commands for the editor are explained below.\n\n`H: HELP`\n\nAll command names. ↓ Display their contents.\n\n`P: PLAY`\n\nYou can start the game from any level.\n\n`L: LOAD`\n\nLoad data. The file format is machine language and the filename is \"PIT\".\n\n`S: SAVE`\n\nSave data. The file format is machine language and the file name is \"PIT\".\n\n`C: CLEAR`\n\nErase the data of any surface.\n\n`E: EDIT`\n\nEnter screen creation mode - to move the cursor (`F1`), and to place the\ncharacter. Correspondence between numbers and characters is:\n\n1. space\n2. chopsticks 2\n3. gold bars\n4. warriors\n5. stones\n6. walls\n7. PITMAN\n\nPress `N` to go to the next page, `B` to go to the previous page, and `R` to\nreturn to waiting for command input.\n\n`D: DATA OUT/IN`\n\nUsed for saving/loading data. Converts 88-byte data to 46-character ASCII code\n(0 to 9, A to Z) and vice-versa. Use it when exchanging PITMAN data in data\nbanks, etc., or when submitting your original level.\n\n* OUT: Data → ASCII. Save to tape in ASCII format.\n* IN: data from keyboard or tape. After entering the data, -\u003e Convert the data.\n\nNote: DATA OUT/IN is one data - if two or more PITMAN are placed in the data,\nthey will disappear, be careful.\n\nSince this MZ-700/1500 program uses color instructions and characters specific\nto it, porting it to other models will be quite difficult. For those of you who\nstill don't understand, here's a variable table. Please note that X, X1, and X2\nare used for chores outside of the game. Use the editor to create a unique\noriginal.\n\n```text\nMX, MY   PITMAN X, Y\nHX, HY   X, Y coordinate change value\nX1, X2   Drop range of stones and gold nuggets\nX,Y      X, Y coordinate chores\nL        Level\nM        Misses (rest)\nG        Number of gold bars\nGB       PITMAN's background character (0: blank, 1: ladder)\nSY       My Style\nQ, I     Chores (FOR~NEXT)\nA$, B$   For inputting and outputting various characters\n```\n\nPlease send your levels to Oh!MZ. It would be nice if we could collect the\ndesigns that everyone has made and make PITMAN2.\n\n\u003e \"PITMAN\", which was selected as the special prize game of the month, please\n\u003e type it anyway. It's a thinking game with 100% enthusiasm.\n\u003e Ingenious character graphic screens, with a total of 50 levels, which were\n\u003e made by him. Plus, it comes with an editor function, so there's nothing more\n\u003e to say. Zankawa is a high school student. I have high hopes for his future\n\u003e success. (editing room.H.)\n\n\n## Copyright Information\n\nTranscribed by Michael R. Cook, 2023.\n\nPITMAN, COPYRIGHT 1985 Y. ISOKAWA.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrcook%2Fpitman-basic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrcook%2Fpitman-basic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrcook%2Fpitman-basic/lists"}