Log inGet started
World

Paper Sky

Branchmain
Branchesmain
Commit1c3ac06ea9

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

PathWhat it is
rules.moduleEvery tuning number, the pure course function gateAt(index), the collision test, the difficulty ramp
runstate.moduleThe run state and the event bus, in a file nobody edits so a save cannot orphan subscribers
Crane.componentFlight, the ready/flying/crumpled machine, scoring, best
Course.componentMaterializes and releases gates around the crane
gates.moduleWhat a gate is made of — bamboo culms, lashing collars, a leaning back frame
sky.moduleThe palette, the dusk light rig, and the parallax band layout
Backdrop.componentApplies the light and sky, recycles the skyline bands, dresses the crane
CraneCam.componentThe camera's framing and its reactions; also mounts the interface
PaperSkyHud.componentThe screen
Juice.componentFlap, 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.craneRadius 0.55 nominal, hitRadius 0.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. best is the best this session; it is not written anywhere.