As of October 2024, Mansion Maniac will no longer be updated by NYPL and will soon be archived. Source code for the site is available here: https://github.com/nypl-publicdomain/mansion-maniac and the digitized Apartment Houses of the Metropolis collection can be viewed here: https://digitalcollections.nypl.org/collections/apartment-houses-of-the-metropolis.
This is a procedural maze/dungeon builder that uses blueprints from NYPL's Apartment Houses of the Metropolis collection. Individual rooms were cut out from the images in the collection and manually annotated with the room editor. This places every room in a square grid that then allows for the player's avatar to explore.
Uses images from the Apartment Houses of the Metropolis collection and its supplement, made available by the New York Public Library as public domain material.
The player's avatar moves on a square grid, where each square can be one of three different tile types:
- floor (the player can occupy these tiles),
- wall (player cannot occupy these tiles),
- door (“portal” to another room, these can only be 1 square deep and at least 2 square wide).
Rooms are of two types: starting/root rooms (the first room displayed) and regular rooms. The root room is the “entrance” to the mansion and is based on what appears to be an entrance to the original mansion in the blueprint. As the player moves around a room and encounters a door, a random complementary room with a door the same tile size is placed in that location.
There's a very basic room editor that lets you see how each room is built (use the left/right arrows to change room). The editor does a simple check to verify that all doors have at least one complementary door (e.g.: if there is a 3-square door on the right there needs to be at least one 3-square door on the left).
Easter egg: there is a “debug mode” in the game that shows the different tiles for the rooms and is accessible by tapping the D key.
If you're interested in procedural dungeons similar to this one or those used in videogames, here's a nice write up on dungeon algorithms.
If there are no available doors to go through or if the player moves on an area where two rooms overlap (the algorithm does not check for overlap prevention) you will need to press Restart to create a new mansion. You can also Save the current mansion as a PNG file and download it.
- Install the required packages
npm install- Run the app locally with npm:
npm run start- To re-compile your CSS as you change it during local development, run:
npm run devPush to gh-pages to deploy to Github Pages. Be sure to compile before committing by running
npm run buildMade with CreateJS and TypeScript.
The name of this project is inspired by the amazing Maniac Mansion videogame by Ron Gilbert and Gary Winnick.
See license.
On January 6, 2016, The New York Public Library enhanced access to public domain items in Digital Collections so that everyone has the freedom to enjoy and reuse these materials in almost limitless ways. For all such items the Library now makes it possible to download the highest resolution images available directly from the Digital Collections website.
That means more than 187,000 items free to use without restriction! But we know that 180K of anything is a lot to get your head around — so as a way to introduce you to these collections and inspire new works, NYPL Labs developed a suite of projects and tools to help you explore the vast collections and dive deep into specific ones.
Go forth, reuse, and let us know what you made with the #nyplremix hashtag! For more information: