RESTful-DOOM

An HTTP + JSON API hosted inside the 1993 DOOM engine!

RESTful-DOOM is a version of Doom which hosts a RESTful API! The API allows you to query and manipulate various game objects with standard HTTP requests as the game runs.

There were a few challenges:

• Build an HTTP+JSON RESTful API server in C.
• Run the server code inside the Doom engine, without breaking the game loop.
• Figure out what kinds of things we can manipulate in the game world, and how to interact with them in memory to achieve the desired effect!

RESTFul-DOOM is built on top of the awesome Chocolate Doom project. I like this project because it aims to stick as close to the original experience as possible, while making it easy to compile and run on modern systems. This was only possible by building on top of their hard work!

More details in blog post:

http://1amstudios.com/2017/08/01/restful-doom/

API Spec

API spec in RAML 1.0 format

Build

Building dependencies (needs to be run only once)

Takes care of building and configuring dependencies like SDL. Uses chocpkg.

./configure-and-build.sh

Compiling

Run make from the src (or root) directory. src/restful-doom will be created if the compile succeeds.

Run

The DOOM engine is open source, but assets (art, maps etc) are not. You'll need to download an appropriate WAD file separately.

To run restful-doom on port 6666:

src/restful-doom -iwad <path/to/doom1.wad> -apiport 6666 ...

Thanks!

chocolate-doom team
cJSON - JSON parsing / generation
yuarel - URL parsing