This is a map of Universal Paperclips, the addictive philosophical clicker game by Frank Lantz. The diagrams consist of all projects and other major milestones in the game, along with their requirements, creating a map of sorts for the game.
The diagrams were created using Graphviz, with the help of the M4 macro language to simplify the repetition of node shapes and colors.
It should go without saying that these diagrams contain spoilers. I created them to help myself visualize the flow of the game to plan speedruns.
For more info on Universal Paperclips, see the game itself which is free to play in your browser, or the coverage in Wired, Forbes, or The New Yorker,
The game is split into four sections:
- Stage 1a (src, pdf, svg): stage 1 up to 20,000 ops and the new era of trust.
- Stage 1b (src, pdf, svg): stage 1 after the new era of trust
- Stage 2 (src, pdf, svg)
- Stage 3 (src, pdf, svg)
If printed, each section seems to fit decently onto one sheet of paper. Stage 1 is split for this reason.
Additionally, the build script (Makefile
) combines them into different combinations:
The diagrams cover v3 of Universal Paperclips, using requirements taken directly from the javascript code which is viewable with any browser's "view source" feature.
Thanks to Mr. Lantz for not minimizing or obfuscating his javascript. It's really neat to look at the source code, especially the projects file. Because the projects are numbered in order of their creation, you can get some insight into how the game grew during development and which features were early vs late additions. (Lantz's patch notes are also fun to read: patch 1 patch 2)
In the future, I hope to build an alternate version of these diagrams for the mobile version, which has some slightly different milestones, but it will take some reverse engineering of the different drone and factory cost calculations in stage 2.
The master
branch of this repository includes rendered files (pdfs and svgs) so that they are more easily accessible on the web.
You can also build pngs, but I am not checking them into the repository because the file sizes are much bigger: 500kb to 2mb.
There is a separate source
branch that just has the diagram source files.
If you plan to do any development, do it on the source
branch.
Files:
common.m4
defines shapes and colors for different categories of targets and projects: ops, creative, etc.- The
*.dot.m4
files contain the Graphviz graph definitions and calls to the macros incommon.m4
- The
Makefile
usesm4
anddot
to render the graphs in different formats. - For stage 2, the
upc_prices.py
Python script calculates factory and drone cost milestones and outputs graphviz code that is included by the.dot.m4
file.
These diagrams are by Mike Murphy ([email protected], Twitter:@sleepymurph). If you use or remix them, give credit to me and more importantly to Frank Lantz.
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.