ifhttp provides an HTTP REST interface for interacting with Z-Machine interactive fiction (IF) stories (typically .z8 files). Clients can connect to the service to start a game and then POST commands to it. Sessions are deleted after a while in a feeble attempt to save memory. This service is definitely DoS-able.
See a live example on https://www.langworth.com/
$ docker pull ghcr.io/statico/ifhttp $ docker run -p 8080:8080 -v /path/to/stories:/data ghcr.io/statico/ifhttp npm run -s start -- /data/story.z8 All request and response bodies should be JSON. In addition to a status code, requests may return a JSON object with an error property which describes the error.
Returns a session ID for a new game.
Response:
{ "session": "<id>", "output": "<text>" }Sends a command to the game.
Request:
{ "session": "<id>", "message": "<user input>" }Response:
{ "output": "<text>" }