Paper Sky
README.md
Paper Sky
One button. A folded paper crane flapping through the gaps in bamboo scaffolding above a dusk city. Touch a pole, the rooftops or the top of the sky and it crumples. Endless — chase your best.
World 5a35a9c3-1af6-49e4-b973-f11b15227f5a · startup scene
/zero/source/scenes/papersky.scene.
How to play
Press Space. That is the whole control surface.
- Space, gamepad A, or tap the screen — flap. One button, three
device classes, one control named
flap. - The crane always moves right and always falls. A flap is a fixed upward impulse, so height is something you spend and re-buy.
- Thread the gap between the bamboo poles for +1. The gaps narrow, drift further from level, and the crane speeds up as the run goes on — the first three gates are dead level with the spawn, to teach the beat.
- Touching a pole, the rooftops or the top of the sky ends the run. The card tells you which. Your score freezes, your best is kept, and a fresh crane is on the line under a second later.
- Flap again to go again. There is no menu and no win state.
What is on screen
Three faces, driven entirely by the run's own events:
- ready — the title, what to press on each device, and your best. After a crash it also carries THIS RUN beside BEST.
- flying — the score, big, and nothing else in the way. The digit pops to lantern-orange on each gap cleared.
- crumpled — CRUMPLED, the cause in words, THIS RUN against BEST, a NEW BEST flourish when you beat it, and how to fly again.
How it is put together
| Path | What it is |
|---|---|
rules.module | Every tuning number, the pure course function gateAt(index), the collision test, the difficulty ramp |
runstate.module | The run state and the event bus, in a file nobody edits so a save cannot orphan subscribers |
Crane.component | Flight, the ready/flying/crumpled machine, scoring, best |
Course.component | Materializes and releases gates around the crane |
gates.module | What a gate is made of — bamboo culms, lashing collars, a leaning back frame |
sky.module | The palette, the dusk light rig, and the parallax band layout |
Backdrop.component | Applies the light and sky, recycles the skyline bands, dresses the crane |
CraneCam.component | The camera's framing and its reactions; also mounts the interface |
PaperSkyHud.component | The screen |
Juice.component | Flap, score and crumple sound, the dusk ambience, the paper-scrap burst |
art/ | 9 meshes and 10 materials — the crane, the bamboo, the city, the rooftops, the haze |
The course is a pure function of the gate index, so every client computes
the same course without replicating any of it. Nothing but the planner writes
the scene file; every slice reaches the world from its own component's
awake, which is why three agents could build it at once.
Where the knobs are. Rules.tune holds every number the game feels like.
sky.module holds every number the look depends on. CRANE_SCALE in
Backdrop.component sizes the bird without touching its geometry.
What is rough
- The crane is small in frame. It is sized so the fold, the beak and the
pitch all read from a camera standing 19 m off a 20 m-tall play volume, and
it does read — but it is a modest shape in a wide shot. Its drawn size and
its collision radius are deliberately different numbers
(
Rules.tune.craneRadius0.55 nominal,hitRadius0.40 actual), so growing the art alone would make the hitbox feel wrong. - One residual seam. A
pass = "zfighting"capture is clean except for a ~20 px mark where the crane's head slab meets its neck slab. It is a solid intersection inside one mesh, not coplanarity, and it does not show in the final render. - Dusk reads dark. The city is silhouette by design, and on a dim screen
the whole frame can read closer to night than to dusk. The sun, ambient and
sky are all in one place (
sky.module) if that wants lifting. - The flap has no held-input state. Every press is one impulse; there is no charge, no hold, no double-tap. That is the design, but it means the only expressive range is timing.
- No persistence between sessions.
bestis the best this session; it is not written anywhere.