Donkey.bas is 45 Years Old – 131 line of Glory

(donkeybas.com)

216 points | by jkrauska 12 hours ago

22 comments

  • vunderba 12 hours ago
    Nice job. The sound effects are a bit too advanced because early IBM computers shipped with pretty simple, magnetically driven dynamic speakers.

    On a related note, I’ve actually spent the last four months working on a 100% faithful adaptation of both QBasic and QuickBasic 4.5 that runs entirely in the browser on a virtual CPU and hardware abstraction layer. It’s a love letter to everyone who learned to program on Microsoft’s BASIC interpreters in the ’80s and early ’90s.

    The best compliment I’ve received so far is from friends who grew up in the same era I did: when I fullscreen the browser, a few of them assumed it was a virtual machine running the real thing.

    A QBasic port of the original BASIC-based DONKEY.BAS was one of the first programs I got running in it:

    https://mordenstar.com/share/qbasic-core-demos

    • codebje 4 hours ago
      You used to be able to do surprising things with those old speakers using a timer interrupt: on an IBM XT it was possible to get 8kHz quality out of it, enough to make 4-channel MOD playback sound about as good as hearing it over a phone.

      But your more typical use case was to play a single tone for some significant fraction of a second.

    • HeyLaughingBoy 11 hours ago
      At my first job, our entire order-entry and inventory management system was written in QBASIC. I wish I had the source to try it out with this.

      I know someone who might, if we could figure out how to get it off a DOS 5.25" floppy!

      • vunderba 9 hours ago
        That’s awesome. If you ever end up getting a copy of it, I’d love to stress-test QBasic-Core against it since I built in a virtual hard drive to allow File I/O (PUT for random access, PRINT to file number, etc.)

        I’ve got a fairly large collection of several hundred programs from the early to late ’90s that I’ve been carefully testing A/B testing against period accurate hardware and my simulator but actual professionally used QBASIC-based applications from back with the source intact are hard to come by.

      • ColdStream 6 hours ago
        The good news is that 5.25" floppies have tended to be more resilient to time than the 3.5" discs. Turns out just having less data spread over a larger space helped them in this regard.

        Hardest part is usually trying to find working drives and a means of getting the data off the system.

        • VorpalWay 6 hours ago
          The best (and most flexible) way to get data of old floppies is https://github.com/keirf/greaseweazle which reads the data at a raw magnetic level using a standard floppy drive and a custom open source circuit board which replaces the host controller.

          However, if you are specifically dealing with PC floppies, it is potentially overkill (but it might still be the easiest way to hook up a 5.25" floppy drive to a modern computer).

          5.25" drives may also need a separate power supply in addition to the greaseweazle, for 3.5" drives the GW has enough power to power the drive directly though.

    • d3Xt3r 9 hours ago
      And for the slightly younger folks who have more memories of Visual Basic than QBasic, check out GAMBAS: https://gambaswiki.org/website/en/main.html
      • vunderba 9 hours ago
        Loved Visual Basic! VB3 was probably my first experience as a kid to the idea of “threading” and UI-blocking operations.

        Remember this?

          DoEvents
    • physicles 3 hours ago
      Amazing. This is nostalgia heroin for me.

      How far does the HAL go? Screen 12 and 13, and writing directly to VRAM? WAIT for vsync? Call absolute for mouse usage?

      • vunderba 2 hours ago
        Thanks! I went so far with it that I was honestly questioning my own sanity.

        The HAL has a virtualized CPU, and I spent more time than I’d care to admit precisely timing instructions on various period-accurate hardware (386SX, 486DX). I even tuned it to the point where programs that take advantage of it actually run faster on the 486 because of the built‑in math coprocessor.

        > Writing directly to VRAM? WAIT for vsync?

        All screen modes are supported including the ability to draw to hidden pages. It’s got a fully emulated VGA hardware layer and even a synthetic VGA beam clock, so you can do tricks like `WAIT &H3DA, 8, 8` for vertical retrace to minimize flicker.

        > Call absolute for mouse usage?

        Yup! Int 33h is fully supported, we basically use a virtual TSR driver which is pointed to by the interrupt vector table. I actually tested it with an old pixel art editor I made in the 90s!

        PEEK/POKE and much of the BIOS are fully simulated, so you can use more advanced QuickBasic 4.5 features like calling interrupts (including silly stuff like rebooting the computer via int 19h).

        There's a ton more (including a Hayes compatible modem plugged into COM1) as well.

        I basically dug out a stack of my old PC books from the late ’80s and early ’90s, and they’ve been my bibles for the past several months (Undocumented DOS, The Programmer’s PC Sourcebook, etc.).

        It’s about 99% done at this point. I’m hoping to do a Show HN in the next couple of weeks.

    • mysterydip 11 hours ago
      This is fantastic! As one of those kids who spent the early 90s in QBasic, thank you!
    • mosburger 10 hours ago
      aw neat I'd love to try doing this for its predecessor GWBASIC (my first programming language on the Tandy 1000EX)
      • hakfoo 4 hours ago
        What's weird is that they did an open-source release of GWBASIC, but it seemed to be in a worse state than the DOS 1/2/4 releases. I don't think there's a turnkey distribution out there outside of digging up your old DOS 4.01 floppies.
      • vunderba 10 hours ago
        You absolutely should!

        I’ve already sunk hundreds of hours into building out the fidelity of QuickBASIC (everything down to emulating memory access so you can simulate realistic PEEKing and POKEing), so I don’t have the sanity points left to tackle any other variants myself, but I’d love to see a GW-BASIC version.

        • chorizo 1 hour ago
          Got grounded for “breaking” the computer by POKE’ing random numbers to 0 to 65535. In my defense, I was 11.
          • vunderba 44 minutes ago
            Haha same. I definitely crashed our family's PC quite a few times as a kid by forgetting to set the segment address to &HA000 and then poking, mistakenly assuming I was hitting mode 13h VGA memory.
    • NuclearPM 7 hours ago
      Do non-magnetically driven speakers exist?
      • racingmars 7 hours ago
        Yes, electrostatic speakers are a good example. Also a lot of PC motherboards I've had over the years have had the little piezoelectric speaker. And while still magnetic, there are planar magnetic speakers which are much more like electrostatic speakers (just using a magnetic field instead of electric field) than the typical moving coil / dynamic speaker drivers that you think of.
        • LeBit 7 hours ago
          This guy knows speakers.

          I have a pair of Magneplanar speakers. They always impress people.

    • alana314 7 hours ago
      Nibbles!
  • nfriend 11 hours ago
    Brings back memories of GORILLA.BAS! https://en.wikipedia.org/wiki/Gorillas_(video_game)
    • EvanAnderson 11 hours ago
      I was more of a Nibbles[0] person. I played it with other people on my XT-class laptop in high school.

      [0] https://en.wikipedia.org/wiki/Nibbles_(video_game)

      • hdgvhicv 10 hours ago
        I’ve got the music in my head just from seeing it written down. And the sound effect from gorrilla.
        • vunderba 9 hours ago
          Yeah it's very iconic. It’s actually the same melodic motif that’s played in the intro of GORILLA.BAS and NIBBLES.BAS - it’s a short snippet from Tchaikovsky’s 1812 Overture.

          Kind of reminds me of how most people don’t know “Korobeiniki” (Коробейники) by name, they just call it the Tetris song.

          • EvanAnderson 9 hours ago
            I love the 1812 Overture, in part, because it has artillery.

            "Oh, yes-- I play in the orchestra. I am in the auxiliary percussion and artillery sections."

            • vunderba 9 hours ago
              Haha, symphonies with accompanying armaments really make you appreciate where you’re going to be seated as an audience member.
      • rzzzt 7 hours ago
        My favorite is MONEY.BAS
    • gxd 11 hours ago
      For those who don't know why GORILLA.BAS is so cool... Back in the day, computers were expensive and games weren't readily available. Sometimes a parent would buy a computer for word processing or spreadsheets or take kids to the office which also had business computers. Children were curious about the computers but there wasn't really anything fun to do with them besides banging on the keyboard...

      ...Until you found the BASIC dialect that came with MS-DOS, that is! GORILLA.BAS was bundled with DOS and was a fun little game you could play in those computers. It's not like you could access web games on the Internet - there was no Internet!

      • pavel_lishin 11 hours ago
        It was also a very educational experience to start messing with the code until you broke it - forcing you to figure out how to fix it, to get your game back.
        • plasticchris 7 hours ago
          My earliest coding memory is messing with the gorilla code to get an advantage playing this against my brother…
          • Induane 3 hours ago
            My first ever hack was turning off collision detection in nibbles.bas so I could worm right through walls.
        • tomcam 8 hours ago
          At my age, getting my game back sounds fabulous
          • eastbound 7 hours ago
            Yes, when did we start messing with the code? We need to fix it?
      • rossriley 2 hours ago
        It sounds kind of crazy now but we genuinely used to buy computer magazines that had basic code printed in them, to try the game you would type the basic into a file, save and then run it.
      • vunderba 9 hours ago
        Just as importantly - it was an all‑in‑one. I think a lot of people tend to forget that there were already plenty of earlier BASIC dialects (GW‑BASIC, Apple II BASIC, C64 BASIC, etc).

        However QBASIC was likely the first freely available, all‑in‑one "batteries included" environment that came bundled with MS‑DOS 5 with a relatively friendly IDE that had built‑in help for every single command. GORILLA.BAS and NIBBLES.BAS were the gateway drugs for many future programmers.

        • pjmlp 39 minutes ago
          Only if you ignore the 8 bit home computers, we got all BASIC interpreters and machine code for free with each one.

          And there were "IDEs" that sometimes were offered in cover tapes, at the expense of even lesser RAM, I got one for the Spectrum.

          And the 8 bit computers with at least 128 KB, already could run CP/M, which opened the door for better BASICs, including compilers.

          • vunderba 33 minutes ago
            Definitely. I've used a few of them (Commodore BASIC, Applesoft BASIC) as a kid.

            I could have worded that a bit better. What i meant was that as far as I'm aware, QBASIC was the first free OS-bundled fully featured BASIC IDE which even by today’s standards still kind of holds up:

            • find and replace

            • split panes

            • an immediate mode

            • debugging

            • breakpoints

            • built‑in help for every basic keyword and command.

            • editing any lines (no need for line number at multiples of 10 to insert and modify at a later time)

        • ColdStream 6 hours ago
          Basic and Qbasic represent a part of computer culture that has been lost a little bit. It was the idea of making computers programmable to almost anyone without having to have a deep knowledge of how the system works.

          I'm not saying we should go back to BASIC but that spirit of easy to build has been lost a little. Nowadays you need to pull in like 40 dependencies before things can get really moving. Yeah it is OK after that but the barrier to entry can be a little tough at times. This is the same complaint I have about multimedia on the web, Flash solved the issue in a terrible fashion but the core idea was great.

          • vunderba 2 hours ago
            100%. I actually loved Flash for what it was. I get that it could definitely become convoluted especially when you were jumping between various keyframes, some of the control flows could get really messy.

            But just like QBASIC, it was a “batteries included.” environment. That’s what made it so compelling.

            QBASIC was the same way. It's a literal siren song for inquisitive kids to just experiment, because everything is right there. Like you said, there’s no importing libraries. It’s a completely self-contained sandbox of possibilities.

            If you have a question, you just slap that F1 on your buckler-spring mechanical keyboard and boom there’s documentation/examples.

      • bluedino 10 hours ago
        > Back in the day, computers were expensive and games weren't readily available.

        You could get a PC for a thousand bucks back then, and shareware was a thing in 1990-91. Crystal Caves, Commander Keen, Duke Nukem were huge hits and there were tons of less popular games...not to mention copying commercial games from friends.

        • gxd 8 hours ago
          > You could get a PC for a thousand bucks back then

          In the United States... In a lot of countries, computers cost a lot more than that in the local currency which, together with lower salaries, made computers inaccessible to most people.

          I remember seeing people playing GORILLA.BAS in computer stores...

          • pjmlp 38 minutes ago
            Which is why in many countries we stayed on the Speccy and C64, until 386SX were already widespread.
        • egypturnash 9 hours ago
          $1k in 1990 ~= $2.5k today.
          • ColdStream 6 hours ago
            And that would get you a system that was fairly anemic even for then. There were still some 286 systems being sold then which was 2 full architecture leaps behind at a time when it was starting to become very important.
        • QuercusMax 9 hours ago
          Crystal Caves! I've been trying to remember the name of that game for ages! I never bought the full version but played the shareware endlessly...
    • TonyAlicea10 9 hours ago
      GORILLA.BAS got me into programming decades ago. I made an (admittedly partially vibe coded) homage this year: https://gameswithtony.com/gorillas/
      • sejje 4 hours ago
        First code I ever edited.

        First time I played it was 8th grade, in Randy Seaman's Algebra class. He also had wolf3d on that machine.

    • RankingMember 11 hours ago
      GORILLA and NIBBLES!
    • jimt1234 10 hours ago
      We used to do quick tests of PC builds with GORILLA.BAS. It was later replaced by the 'Doom test'.
  • jamesdhutton 11 hours ago
    For anyone unfamiliar with DONKEY.BAS: it’s notable for having been co-written by Bill Gates. More info on its history bere: https://en.wikipedia.org/wiki/DONKEY.BAS
    • jakzurr 2 minutes ago
      2nd, the wikipedia article has some fun stuff in it
  • jkrauska 12 hours ago
    Inspired by the 45th anniversary of the IBM PC, I got my slopmachine cracking on a port of DONKEY.BAS to work in a browser. Pretty happy with the result. As a young person I remember being fascinated that you could make a game like this with so little code.
  • marcuskaz 8 hours ago
    The game theory is all wrong, this is a cooperative game, either they both win or both lose. I don't see how the Donkey getting hit by a car should be classified as "Donkey wins"
    • hahahaa 8 hours ago
      Donkey is also a collective noun for the donkeys and so the army that is the donkey wins.
      • jamwil 29 minutes ago
        ¡Viva Donkey!
  • sedatk 11 hours ago
    I once heard the rumor that DONKEY.BAS was the last piece of code Bill Gates wrote himself at Microsoft. I wonder if it's true.
    • ColdStream 6 hours ago
      That has all the hall marks of urban legend, but why let the truth get in the way of a great story.

      I have said it for a very long time, Gates wasn't innovative in technology but he absolutely innovated in bringing the most ruthless business practices into software.

  • friarpuck 11 hours ago
    Someone gave my grandfather a Games BASICA floppy that had this and other games on it. But this copy had a few games that had been "modified". I remember in DONKEY.BAS, it would curse at you if you hit the donkey. "YOU STUPID SONOFABITCH". We thought it was hilarious. My grandfather was less pleased. He took it away from us when he found out.
    • syntheticnature 8 hours ago
      As a kid I modified DONKEY.BAS for my younger brother who wanted to play as a donkey avoiding cars. It was a clumsy modification, I didn't account for the differing size of the pseudo-sprites, but it made him happy.
    • dmd 9 hours ago
      I learned most of the best cursing I've ever done from my grandfather. He took pride in teaching his grandkids to curse.

      He was involved in setting up the radar systems at Pearl Harbor, much good that did.

    • transitorykris 9 hours ago
      Modifying those games were the first times I ever touched code! There was one that existed somewhere between DOS 2.0 and 3.2 that simply asked your name, then asked how the hell you got that name. It was maybe half a dozen lines, but easy enough to modify output and learn a bit about variables.
  • chaoticmass 6 hours ago
  • flowofcontrol 12 hours ago
    my car keeps hitting the donkey when switching lanes even though I'm already well past it..
    • stronglikedan 12 hours ago
      have you had anything to drink recently?
      • SoftTalker 7 hours ago
        Officer, I'm not going to discuss my day with you.
    • smackeyacky 5 hours ago
      I haven’t looked at the code but the collision detection was buggy even back in the day. You have to switch lanes while there is nothing or a donkey in front of you. If the donkey is in the other lane it registers a hit even if it looks like you passed it

      Edit: line 1750 is where it does a simple collision check and yep looks like it registers a collision without checking you’re past the donkey or not

  • atum47 10 hours ago
    My perceptron can play this game, I think

    https://github.com/victorqribeiro/carGamePerceptron

  • pavel_lishin 12 hours ago
    On my machine, it is flickering like _crazy_, as if it's trying to shift back and forth between two resolutions.

    OSX, Firefox, browser size 3326×2830 pixels. Only happens at or around that particular size - resizing the window fixes the issue.

    • jkrauska 12 hours ago
      • pavel_lishin 11 hours ago
        Also, on reflection, I think the firefox window size is half of what I reported - I'm not sure what OSX does to its screenshots, but using SHIFT-CTRL-CMD-3, it's reporting about half that size. Not sure if that makes a difference to your changes (likely not).
  • ChrisArchitect 12 hours ago
    Related:

    Happy 45th Birthday to the IBM PC and Model F/XT

    https://news.ycombinator.com/item?id=49280103

  • Aeolun 4 hours ago
    I’m partial to Gorrila.bas
  • wk_end 12 hours ago
    It says something about what a thoughtful development environment these early BASICs were, that you could make a full simple little game like this in only 131 lines even though they're ostensibly far less powerful than modern languages. I'm not sure if you could even get an SDL window open and game loop running in 131 lines of (non-golfed) C.

    Never mind how compact, beginner-friendly, and just plain fun they were to use. It's been said countless times but I'll say it again - we've lost something over the years.

    • prmoustache 7 hours ago
      Back in the days you would buy printed magazines that contained full basic source code of programs and games and type them on your own text editor. I was a bit too young to do that but I remember watching my older brother just do that and then play games (after finding the typing errors for a while).
    • diegof79 8 hours ago
      What we lost is simplicity across the stack.

      I learned to program with BASIC. It was awful. I didn’t know how awful it was until many years later. So I don’t miss the language. But something I miss is how easy it was to learn what your machine was doing.

      The DOS boot and config involved only two files: CONFIG.SYS and AUTOEXEC.BAT, that was it. Most programs were self-contained, so you could copy the directory to a floppy disk and run them on another machine. If you broke something, copy the files again and restart; that was it… I “broke” config and programs many times, and it was a good way to learn.

    • throwaway81523 8 hours ago
      BASIC was higher level (or anyway, more batteries-included) than C. You could probably do this game in 131 lines of javascript straightforwardly.
      • pjmlp 33 minutes ago
        BASIC was the whole OS in 8 bit home computers.

        Other than that, either you would have machine code via DATA statement, be lucky that there was support for entering Assembly like on the BBC, or have the opportunity to actually get a proper assembler.

    • ligne 9 hours ago
      131 lines and about 10% of them are the title/copyright banner. Genuinely impressive in it's terseness
      • commandlinefan 9 hours ago
        Nearly a quarter of it is checking for necessary prerequisites, too.
    • krapp 10 hours ago
      >I'm not sure if you could even get an SDL window open and game loop running in 131 lines of (non-golfed) C.

      The basics (window, events, renderer) can be done in about 30 lines:

          #include <SDL3/SDL.h>
          #include <SDL3/SDL_main.h>
      
          static SDL_Window* window;
          static SDL_Renderer* renderer;
      
          int main(int argc, char* argv) {
              SDL_Init(SDL_INIT_VIDEO|SDL_INIT_AUDIO|SDL_INIT_GAMEPAD);
              SDL_CreateWindowAndRenderer("test", 640, 480, SDL_WINDOW_RESIZABLE, &window, &renderer);
              SDL_Event event;
          
              while(true) {
                  while(SDL_PollEvent(&event) != 0) {
                      if (event.type == SDL_EVENT_QUIT) {
                          goto ENDGAME;
                      }
                      //events go here
                  }
                  
                  // update here
                  SDL_SetRenderDrawColor(renderer,0,0,0,255);
                  SDL_RenderClear(renderer);
      
                  // render here
                  SDL_RenderPresent(renderer);
      
              }
      
              ENDGAME:
              SDL_DestroyRenderer(renderer);
              SDL_DestroyWindow(window);
              SDL_Quit();
          }
      
      I don't think you could get all of donkey.bas done in 131 lines, though. SDL3 does ship with an embedded debug font but that seems like cheating. You probably couldn't replicate the drawing code easily, it would probably need to be faked with images, and you'd need a font atlas for the text.
    • sltkr 10 hours ago
      It was really cool! The ease of getting started was definitely one of the selling points for the “home computers” of that era (GW-BASIC ran on IBM compatible PCs instead, but the appeal of BASIC was the same). Brevity was an important feature since a lot of people obtained programs by typing them over from a magazine or recording them from the radio. And of course, there was no such thing as auto-complete (let alone AI generation).

      That being said, SDL isn't actually that bad either. A minimal example is about 40 lines of code [1], not counting comments and blank lines, but including lines with just a curly brace which you could easily remove if you were concerned about size. A slightly more serious implementation of Snake runs about 345 lines of code [2].

      And to be fair, DONKEY.BAS is also cheating slightly on the line metric by stuffing lines full of statements, like for example:

          A$=INKEY$:IF A$=CHR$(27) THEN 1298 ELSE POKE 106,0:IF LEN(A$)>0 THEN LINE (CX,CY)-(CX+28,CY+44),0,BF:CX=252-CX:PUT (CX,CY),CAR%,PRESET:SOUND 200,1
      
      
      1. https://examples.libsdl.org/SDL3/renderer/01-clear/ 2. https://examples.libsdl.org/SDL3/demo/01-snake/
    • tancop 11 hours ago
      raylib might do it in less lines. SDL is designed as a cross platform base layer to wrap in another framework not as something you should be using directly.
      • Joel_Mckay 10 hours ago
        I usually recommend the inexperienced do at least 1 project in godot:

        https://godotengine.org/

        Then port it to UE if they are interested in skill reuse for future projects:

        https://www.unrealengine.com/

        SDL has a lot of issues, and falls into the "only if you must" category. Still better than .NET or Java in many ways, as spacial audio is easy in the mixer. =3

    • Joel_Mckay 10 hours ago
      Python is the modern Basic replacement, and also has similar fundamental design trade-offs. VB6 was the peak of the OLE/Multimedia paradigm, and was functionally replaced by the web browser script sandbox.

      > we've lost something over the years.

      Indeed, Information Appliances were never general-purpose computers. Some people used to care about that sort of thing, and left civilization the GNU compilers as one of the most important intellectual artifacts of our generation. =3

  • buildsjets 10 hours ago
    Clearly this needs to be replicated as GTA minigame.
  • phront 10 hours ago
    It turned out that Dino run has deep roots
  • foxglacier 5 hours ago
    A greyscale photo of a donkey appears if you lose badly enough. Surely that wasn't possible in basic with 16 colors??

    EDIT: That must be the easter egg mentioned in the repo.

    • echelon 2 hours ago
      A dithered, meme-y photo of Bill Gates appears if you win 10 times. That probably wasn't in the original, I'm guessing?
  • NDlurker 10 hours ago
    Surprisingly fun!
  • mempko 10 hours ago
    This is what got me into programming. When I was a kid, I had a shitty 386 because my father got a computer second hand from a friend (we were poor). I was playing the game and then pressed a key and it took me to the basic editor. I was confused with what I saw and started changing things. I changed a number and the size of the explosion on the banana got bigger. My best friend at the time went to computer camp and explained to me that it was code. 30 years later I'm still programming.
    • makapuf 8 hours ago
      WTF 386 was for me a sci-fi like device I wouldnt dare think about having when I was a kid. I had a very nice 8086 I cherished, with VGA video no less ! (Yes driving a vga card with a 8086 was slow..
      • lukeh 4 hours ago
        Ha yes, PC XT clone here! And then eventually, a 486SX around 1993, which was my first foray into Linux.
  • toolslive 11 hours ago
    tangential: I still remember how disappointed I was in PCs being used to a C64 (which was released in 1982) The quality of the games & sound effects was just not on the same level (C64 being much more advanced)
  • spwa4 12 hours ago
    Ahhh I never saw donkey.bas, and only saw the Microsoft one. You know, when that company cared about being part of the industry, as opposed to being the entire industry, and really want to be 5 other industries to, as they do now.

    Gorillas.bas (it's more or less like worms, except with only 1 gorilla per team)

    On the plus side: it was much prettier.

    • dec0dedab0de 11 hours ago
      Donkey was for basica/gwbasic. Gorillas was for qbasic, like a decade later.