diff --git a/doc/jump/README.txt b/doc/jump/README.txt
new file mode 100644
index 0000000..1f45be1
--- /dev/null
+++ b/doc/jump/README.txt
@@ -0,0 +1,53 @@
+Here's the player jumping, at 30fps.
+I wanna replicate the arc pretty closely, so here's the numbers I got from the pictures (roughly
+counted pixels, I didn't measure scientifically):
+
+FRAME	Y
+0	6
+1	7
+2	2
+3	6
+4	3
+5	2
+6	3
+7	1
+8	0
+9	0
+10	-2
+11	0
+12	-2
+13	-2
+14	-2
+15	-4
+16	-4
+17	-3
+18	-4
+
+so the jump total raises the player up by ~30px.
+based on this guesswork I'm gonna smooth it out to:
+
+FRAME	Y
+0	6
+1	6
+2	2
+3	6
+4	3
+5	3
+6	3
+7	1
+8	0
+9	0
+10	-2
+11	0
+12	-2
+13	-2
+14	-2
+15	-4
+16	-4
+17	-4
+18	-4
+
+same value, raises up player by 30px
+SAM_FALLSPEED is 4, so after frame 16 the jump is officially done.
+honestly I'm pretty confident in the fact that my counting was off (and maybe bad framerate), but
+oh well. maybe this'll feel natural enough.
diff --git a/doc/jump/jump1.png b/doc/jump/jump1.png
new file mode 100644
index 0000000..b920623
Binary files /dev/null and b/doc/jump/jump1.png differ
diff --git a/doc/jump/jump10.png b/doc/jump/jump10.png
new file mode 100644
index 0000000..f3094dd
Binary files /dev/null and b/doc/jump/jump10.png differ
diff --git a/doc/jump/jump11.png b/doc/jump/jump11.png
new file mode 100644
index 0000000..fc43c97
Binary files /dev/null and b/doc/jump/jump11.png differ
diff --git a/doc/jump/jump12.png b/doc/jump/jump12.png
new file mode 100644
index 0000000..8273f52
Binary files /dev/null and b/doc/jump/jump12.png differ
diff --git a/doc/jump/jump13.png b/doc/jump/jump13.png
new file mode 100644
index 0000000..e61e2ee
Binary files /dev/null and b/doc/jump/jump13.png differ
diff --git a/doc/jump/jump14.png b/doc/jump/jump14.png
new file mode 100644
index 0000000..8efdd43
Binary files /dev/null and b/doc/jump/jump14.png differ
diff --git a/doc/jump/jump15.png b/doc/jump/jump15.png
new file mode 100644
index 0000000..5d53a08
Binary files /dev/null and b/doc/jump/jump15.png differ
diff --git a/doc/jump/jump16.png b/doc/jump/jump16.png
new file mode 100644
index 0000000..397a3af
Binary files /dev/null and b/doc/jump/jump16.png differ
diff --git a/doc/jump/jump17.png b/doc/jump/jump17.png
new file mode 100644
index 0000000..7b77e58
Binary files /dev/null and b/doc/jump/jump17.png differ
diff --git a/doc/jump/jump18.png b/doc/jump/jump18.png
new file mode 100644
index 0000000..ac4b3d6
Binary files /dev/null and b/doc/jump/jump18.png differ
diff --git a/doc/jump/jump19.png b/doc/jump/jump19.png
new file mode 100644
index 0000000..9313b9d
Binary files /dev/null and b/doc/jump/jump19.png differ
diff --git a/doc/jump/jump2.png b/doc/jump/jump2.png
new file mode 100644
index 0000000..835eaa9
Binary files /dev/null and b/doc/jump/jump2.png differ
diff --git a/doc/jump/jump20.png b/doc/jump/jump20.png
new file mode 100644
index 0000000..0f1e43d
Binary files /dev/null and b/doc/jump/jump20.png differ
diff --git a/doc/jump/jump21.png b/doc/jump/jump21.png
new file mode 100644
index 0000000..64ab8bd
Binary files /dev/null and b/doc/jump/jump21.png differ
diff --git a/doc/jump/jump22.png b/doc/jump/jump22.png
new file mode 100644
index 0000000..46c7525
Binary files /dev/null and b/doc/jump/jump22.png differ
diff --git a/doc/jump/jump23.png b/doc/jump/jump23.png
new file mode 100644
index 0000000..68470fa
Binary files /dev/null and b/doc/jump/jump23.png differ
diff --git a/doc/jump/jump24.png b/doc/jump/jump24.png
new file mode 100644
index 0000000..579e0c8
Binary files /dev/null and b/doc/jump/jump24.png differ
diff --git a/doc/jump/jump25.png b/doc/jump/jump25.png
new file mode 100644
index 0000000..feaf82a
Binary files /dev/null and b/doc/jump/jump25.png differ
diff --git a/doc/jump/jump26.png b/doc/jump/jump26.png
new file mode 100644
index 0000000..4a270c4
Binary files /dev/null and b/doc/jump/jump26.png differ
diff --git a/doc/jump/jump27.png b/doc/jump/jump27.png
new file mode 100644
index 0000000..dfd8b4e
Binary files /dev/null and b/doc/jump/jump27.png differ
diff --git a/doc/jump/jump3.png b/doc/jump/jump3.png
new file mode 100644
index 0000000..3efad48
Binary files /dev/null and b/doc/jump/jump3.png differ
diff --git a/doc/jump/jump4.png b/doc/jump/jump4.png
new file mode 100644
index 0000000..ea2f2a1
Binary files /dev/null and b/doc/jump/jump4.png differ
diff --git a/doc/jump/jump5.png b/doc/jump/jump5.png
new file mode 100644
index 0000000..33e7cb9
Binary files /dev/null and b/doc/jump/jump5.png differ
diff --git a/doc/jump/jump6.png b/doc/jump/jump6.png
new file mode 100644
index 0000000..66e7c92
Binary files /dev/null and b/doc/jump/jump6.png differ
diff --git a/doc/jump/jump7.png b/doc/jump/jump7.png
new file mode 100644
index 0000000..b762ca4
Binary files /dev/null and b/doc/jump/jump7.png differ
diff --git a/doc/jump/jump8.png b/doc/jump/jump8.png
new file mode 100644
index 0000000..a089b2a
Binary files /dev/null and b/doc/jump/jump8.png differ
diff --git a/doc/jump/jump9.png b/doc/jump/jump9.png
new file mode 100644
index 0000000..5252f68
Binary files /dev/null and b/doc/jump/jump9.png differ
diff --git a/doc/palette.jpg b/doc/palette.jpg
new file mode 100644
index 0000000..b200b89
Binary files /dev/null and b/doc/palette.jpg differ
diff --git a/doc/screenshots/construction_site.png b/doc/screenshots/construction_site.png
new file mode 100644
index 0000000..16d00a4
Binary files /dev/null and b/doc/screenshots/construction_site.png differ
diff --git a/doc/sprites/p1-enemies.png b/doc/sprites/p1-enemies.png
new file mode 100644
index 0000000..c060e25
Binary files /dev/null and b/doc/sprites/p1-enemies.png differ
diff --git a/doc/sprites/p23-items.png b/doc/sprites/p23-items.png
new file mode 100644
index 0000000..e65a29e
Binary files /dev/null and b/doc/sprites/p23-items.png differ