basic-computer-games on GitHub (coding-horror/basic-computer-games)

basic-computer-games README

What are we doing?

We’re updating the first million selling computer book, BASIC Computer Games, for 2022 and beyond!

Where can we discuss it?

Please see the discussion here for a worklog and conversation around this project.

Project structure

I have moved all the original BASIC source code into a folder for each project in the original book (first volume). Note that Lyle Kopnicky has generously normalized all the code (thanks Lyle!) to run against Vintage Basic circa 2009:

I’ve included all the games here for your tinkering pleasure. I’ve tested and tweaked each one of them to make sure they’ll run with Vintage BASIC, though you may see a few oddities. That’s part of the fun of playing with BASIC: it never works quite the same on two machines. The games will play better if you keep CAPS LOCK on, as they were designed to be used with capital-letter input.

Each project has subfolders corresponding to the languages we’d like to see the games ported to. This is based on the 2022 TIOBE index of top languages that are memory safe and general purpose scripting languages per this post:

C#
Java
JavaScript
Kotlin
Lua
Perl
Python
Ruby
Rust
VB.NET

📢 Note that in March 2022 we removed Pascal / Object Pascal and replaced it with Rust as we couldn’t determine if Pascal is effectively memory safe. We’ve also added Lua, as it made the top 20 in TIOBE (as of 2022) and it is both memory safe and a scripting language. The Pascal ports were moved to the alternate languages folder.

⚠️ Please note that we have decided, as a project, that we do not want any IDE-specific or build-specific files in the repository. Please refrain from committing any files to the repository that only exist to work with a specific IDE or a specific build system.

Alternate Languages

If you wish to port one of the programs to a language not in our list – that is, a language which is either not memory safe, or not a general purpose scripting language, you can do so via the 00_Alternate_Languages folder. Place your port in the appropriate game subfolder, in a subfolder named for the language. Please note that these ports are appreciated, but they will not count toward the donation total at the end of the project.

Project goals

Feel free to begin converting these classic games into the above list of modern, memory safe languages. In fact, courtesy of @mojoaxel, you can even view the JavaScript versions in your web browser at

https://coding-horror.github.io/basic-computer-games/

But first, a few guidelines:

These are very old games. They date from the mid-70s so they’re not exactly examples of what kids (or anyone, really?) would be playing these days. Consider them more like classic programming exercises to teach programming. We’re paying it forward by converting them into modern languages, so the next generation can learn from the programs in this classic book – and compare implementations across common modern languages.
Stay true to the original program. These are mostly unsophisticated, simple command line / console games, so we should strive to replicate the command line / console output and behavior illustrated in the original book. See the README in the project folder for links to the original scanned source input and output. Try running the game in your browser. Avoid the impulse to add features; keep it simple, except for modern conventions, see next item 👇
Please DO update for modern coding conventions. Support uppercase and lowercase. Use structured programming. Use subroutines. Try to be an example of good, modern coding practices!
Use lots of comments to explain what is going on. Comment liberally! If there were clever tricks in the original code, decompose those tricks into simpler (even if more verbose) code, and use comments to explain what’s happening and why. If there is something particularly tricky about a program, edit the Porting Notes section of the readme.md to let everyone know. Those GOTOs can be very pesky..
Please don’t get too fancy. Definitely use the most recent versions and features of the target language, but also try to keep the code samples simple and explainable – the goal is to teach programming in the target language, not necessarily demonstrate the cleverest one-line tricks, or big system "enterprise" coding techniques designed for thousands of lines of code.
Please don't check in any build specific or IDE specific files. We want the repository to be simple and clean, so we have ruled out including any IDE or build system specific files from the repository. Git related files are OK, as we are using Git and this is GitHub. 😉

Emulation and Bugfixes

We want the general behavior of the original programs to be preserved, however, we also want to update them, specifically:

allow both UPPERCASE and lowercase input and display
incorporate any bugfixes to the original programs; see the readme.md in the game folder
improved error handling for bad or erroneous input

Please note that on the back of the Basic Computer Games book it says Microsoft 8K Basic, Rev 4.0 was the version David Ahl used to test, so that is the level of compatibility we are looking for. QBasic on the DOS emulation is a later version of Basic but one that retains downwards compatibility so far in our testing. To verify behavior, try running the programs in your browser with JS BASIC, effectively Applesoft BASIC.

Have fun!

Thank you for taking part in this project to update a classic programming book – one of the most influential programming books in computing history – for 2022 and beyond!

NOTE: per the official blog post announcement, I will be donating $5 for each contributed program in the 10 agreed upon languages to Girls Who Code.

Current Progress

toggle for game by language table

Name	csharp	java	javascript	kotlin	lua	perl	python	ruby	rust	vbnet
01_Acey_Ducey	x	x	x	x	x	x	x	x	x	x
02_Amazing	x	x	x			x	x	x	x	x
03_Animal	x	x	x	x	x	x	x	x	x	x
04_Awari	x	x	x			x	x	x	x	x
05_Bagels	x	x	x	x	x	x	x	x	x	x
06_Banner	x	x	x			x	x	x	x	x
07_Basketball	x	x	x			x	x	x		x
08_Batnum	x	x	x			x	x	x	x	x
09_Battle	x	x	x				x		x	x
10_Blackjack	x	x	x				x	x	x	x
11_Bombardment	x	x	x			x	x	x	x	x
12_Bombs_Away	x	x	x		x	x	x		x	x
13_Bounce	x	x	x			x	x	x	x	x
14_Bowling	x	x	x			x	x			x
15_Boxing	x	x	x			x	x			x
16_Bug	x	x	x				x	x		x
17_Bullfight	x	x	x	x			x			x
18_Bullseye	x	x	x			x	x		x	x
19_Bunny	x	x	x			x	x	x	x	x
20_Buzzword	x	x	x		x	x	x	x	x	x
21_Calendar	x	x	x			x	x	x	x	x
22_Change	x	x	x			x	x		x	x
23_Checkers	x		x			x	x	x		x
24_Chemist	x	x	x			x	x		x	x
25_Chief	x	x	x		x	x	x	x	x	x
26_Chomp	x	x	x			x	x			x
27_Civil_War	x	x	x				x			x
28_Combat	x	x	x			x	x			x
29_Craps	x	x	x		x	x	x	x	x	x
30_Cube	x	x	x				x	x	x	x
31_Depth_Charge	x	x	x			x	x	x	x	x
32_Diamond	x	x	x	x		x	x	x	x	x
33_Dice	x	x	x		x	x	x	x	x	x
34_Digits	x	x	x			x	x			x
35_Even_Wins	x		x			x	x		x	x
36_Flip_Flop	x	x	x			x	x	x	x	x
37_Football	x		x				x			x
38_Fur_Trader	x	x	x			x	x			x
39_Golf	x		x				x			x
40_Gomoko	x	x	x			x	x			x
41_Guess	x	x	x			x	x	x	x	x
42_Gunner	x	x	x			x	x			x
43_Hammurabi	x	x	x				x		x	x
44_Hangman	x	x	x			x	x	x		x
45_Hello	x	x	x		x	x	x	x	x	x
46_Hexapawn	x						x			x
47_Hi-Lo	x		x	x	x	x	x	x	x	x
48_High_IQ	x	x	x				x			x
49_Hockey	x		x				x			x
50_Horserace	x	x	x						x	x
51_Hurkle	x	x	x			x	x	x	x	x
52_Kinema	x	x	x			x	x	x	x	x
53_King	x		x				x		x	x
54_Letter	x	x	x			x	x	x	x	x
55_Life	x	x	x			x	x	x	x	x
56_Life_for_Two	x	x	x			x	x			x
57_Literature_Quiz	x	x	x			x	x		x	x
58_Love	x	x	x			x	x	x	x	x
59_Lunar_LEM_Rocket	x		x				x		x	x
60_Mastermind	x	x	x			x	x		x	x
61_Math_Dice	x	x	x			x	x	x	x	x
62_Mugwump	x	x	x			x	x		x	x
63_Name	x	x	x	x		x	x	x	x	x
64_Nicomachus	x	x	x			x	x		x	x
65_Nim	x		x				x	x	x	x
66_Number	x	x	x			x	x		x	x
67_One_Check	x	x	x			x	x			x
68_Orbit	x	x	x			x	x	x	x	x
69_Pizza	x	x	x			x	x	x	x	x
70_Poetry	x	x	x			x	x	x		x
71_Poker	x	x	x							x
72_Queen	x		x			x	x		x	x
73_Reverse	x	x	x			x	x	x	x	x
74_Rock_Scissors_Paper	x	x	x	x		x	x	x	x	x
75_Roulette	x	x	x			x	x		x	x
76_Russian_Roulette	x	x	x	x		x	x	x	x	x
77_Salvo	x		x				x		x	x
78_Sine_Wave	x	x	x	x		x	x	x	x	x
79_Slalom	x		x				x			x
80_Slots	x	x	x			x	x	x		x
81_Splat	x	x	x			x	x		x	x
82_Stars	x	x	x			x	x	x	x	x
83_Stock_Market	x	x	x				x			x
84_Super_Star_Trek	x	x	x				x		x	x
85_Synonym	x	x	x			x	x	x	x	x
86_Target	x	x	x			x	x			x
87_3-D_Plot	x	x	x			x	x	x	x	x
88_3-D_Tic-Tac-Toe	x		x				x			x
89_Tic-Tac-Toe	x	x	x	x		x	x		x	x
90_Tower	x	x	x			x	x		x	x
91_Train	x	x	x			x	x	x	x	x
92_Trap	x	x	x			x	x	x	x	x
93_23_Matches	x	x	x			x	x	x	x	x
94_War	x	x	x	x		x	x	x	x	x
95_Weekday	x	x	x			x	x		x	x
96_Word	x	x	x			x	x	x	x	x

11.1K ·GitHub

Basic-computer-games

What is this?

This is a project that ports every game from the classic 1978 book 'BASIC Computer Games' into modern, memory-safe programming languages, so people can learn programming by comparing implementations.

Is this a library or just a collection of game ports?

It is a collection/index: each of the ~96 original BASIC games has its own folder containing ports in up to 10 languages, not a single runnable app or framework.

How do I run one of the games?

Go into the folder for a specific game, pick the language subfolder you want, and run it with that language's normal toolchain (e.g. python, dotnet, cargo); some ports can also be played in-browser.

Do I need anything special installed to try a game?

You just need the runtime/compiler for whichever language port you pick (Python, C#, Java, Rust, etc.); the repo itself has no shared build system or dependencies.

Are all games ported to every language?

No, coverage is uneven: C#, Java, JavaScript, Python and VB.NET are close to complete, but languages like Kotlin and Lua only have a handful of ports done per the progress table.

Is this a native app or something I view in a browser?

There's no single app platform: it's source code you run locally per language, though JavaScript ports are also playable directly in a browser.

Which 10 languages were chosen for the official ports?

C#, Java, JavaScript, Kotlin, Lua, Perl, Python, Ruby, Rust and VB.NET, chosen as the top memory-safe, general-purpose scripting languages per the 2022 TIOBE index.

Why was Pascal dropped from the language list?

Pascal/Object Pascal was removed in March 2022 because the maintainers couldn't confirm it was effectively memory safe, and Rust was added in its place.

What are similar projects?

hello-algo, bash-guide, rustlings, wtfjs, the-art-of-command-line, vanillawebprojects, awesome-zsh-plugins, mcp-for-beginners

Which topics is it in?

unix, game, c#, gaming, beginner-friendly, command-line, java, learning, tutorial, go, rust, education

Creator: coding-horror
Size: 76.6 MB
Stars: 11.1K
Updated: CommitFeb 15
Age: 5y
Commits · 90 Days