I love Spelunky. I've been playing it almost every day for the last six months, and I never get tired of it. 

Sometimes Jeff and I will be at the office, each of us playing Spelunky -- inevitably, one of us will say, "Oh my god, you'll never believe what just happened!" and then proceed to regale the other with a story of our latest randomly generated adventure.

A couple of weeks ago, I got an idea in my head that wouldn't go away: what if I could make Spelunky update Twitter with these stories I love so much? And so I started right in on the project. (You can see the end result here: @darius_spelunks.)

The first step was decompiling the Spelunky source code. Spelunky is written in Game Maker 7, and so decompiling is pretty easy if you follow the instructions on the Spelunky wiki.

The next step was figuring out how to get Game Maker to update Twitter. It doesn't come with native support for HTTP Post requests, so I had to improvise. I ended up going with a real kludge of a solution. There's a user-contributed Game Maker DLL called SilentDOS, which lets you run stuff on the Windows command line in the background of your game. (There is a native GM7 function called execute_shell(), but the problem with that function is that it opens a cmd.exe window and disrupts your game.) To initialize SilentDOS, make sure that the DLL is in the same directory as your .gmk file, and then run this at the start of the game:

I put it in the create script for the oGame object in Spelunky.

So now I could run Windows command line stuff. This meant I could run wget, which is for making HTTP requests on the command line. Fortunately, it's pretty easy to update Twitter with wget. I ended up making a file called tweet.bat, and put it in my C:\Windows\System32 directory:

This uses a couple of tricks. First of all, it accepts a command line argument, and "%1" is just the argument you pass to it. In this case, it's the update you're sending to Twitter:

The IF statement just says that if the string I send is "DNT" ("Do Not Tweet"), don't send an update to Twitter, just print DNT to the console. Assuming I didn't send "DNT," it runs the wget command. The "-q" command runs it in quiet mode so it doesn't write any log files as outputs. The "-b" command runs it as a background process, so that it doesn't block Spelunky while it's trying to run. When I run it without "-b", the game will pause for three seconds every time I tweet while I wait for the Twitter server to verify the post.

So now I can tell SilentDOS to run tweet.bat with an arbitrary string as an argument. The problem is that if I try to pass it a regular string:

the Twitter post ends up saying only "This". It's because the command line argument assumes that "This" is argument 1, "is" is argument 2, etc. So I wrote a helper function called format() to replace all spaces with "%20", which is the hexadecimal URL encoding for the space character. The function also replaces commas with "%2C":

So here's the actual call to update Twitter from Game Maker:

At that point it was just a matter of experimenting with where in the code I could put the Twitter calls. My standard script for generating the text bits looks like this:

The first two lines are there because I had a lot of problems with updates that were too repetitive -- who wants to read, "I whipped a snake" "Take that, bat!" "Oh man I just whipped a caveman" all in a row? I wanted more variety in the tweets, so those first lines ask: Did we just tweet about this kind of event? If we did, then don't actually update Twitter with this. If we didn't, then we pick a random phrase to tweet about. The argument0 in these functions is usually the "type" field of a given object, which is the English language name of the object. It's formatted like "Caveman", which is why I call the string_lower() function when appropriate.

So there you have it: a brief tutorial on how to get Game Maker updating Twitter.