A procedural world, a personal project

Small world.
Deep rabbit hole.

How PixelPunk was made, from the first rooftop to the small details that make the town feel lived in.

Start reading
PixelPunk’s Canal quarter at night: layered rooftops, warm windows and neon reflected in the water.
Canal quarter, after darkFrom the development archive
34 chapters on a Godot project

From the first rooftop to a town with a voice of its own.

345 minutes of rabbit holes

The development journal

It started with a rooftop,
and one problem led to the next.

Read from the start, or jump to whatever catches your eye.

When buildings learned to meet: a capture from the PixelPunk development archive.
PART 02Procedural architecture3 min read

When buildings learned to meet.

Hidden walls, roofs that stop at their neighbours, and details generated from how buildings touch.

Read the chapter
Teaching the night to glow: a capture from the PixelPunk development archive.
PART 03Lighting & atmosphere3 min read

Teaching the night to glow.

Hundreds of glowing fixtures on sixteen real lights, and a bug that only showed up when something moved.

Read the chapter
The city is in the details: a capture from the PixelPunk development archive.
PART 04Materials & pixels4 min read

The city is in the details.

Getting bricks and painted walls to agree, putting dirt where it belongs, and making detail hold up at normal zoom.

Read the chapter
Big buildings, little lies: a capture from the PixelPunk development archive.
PART 05Architectural scale3 min read

Big buildings, little lies.

The arch that was really a disc, the tower that was eight flat walls, and why bigger buildings needed different rules.

Read the chapter
Making the mouse feel right: a capture from the PixelPunk development archive.
PART 06Interaction & performance3 min read

Making the mouse feel right.

A drag harness, a frame budget that wouldn’t quite give, and construction animations that also changed when rebuilds get paid for.

Read the chapter
The town meets you halfway: a capture from the PixelPunk development archive.
PART 07Construction chemistry4 min read

The town meets you halfway.

Placement that suggests a fix, paths that turn into steps and stepping stones, and a spiral staircase that came out of a simple connection gesture.

Read the chapter
A little room for life: a capture from the PixelPunk development archive.
PART 08Composition & what comes next3 min read

A little room for life.

Leaving space, balancing things slightly off, one particular duck, and where the experiments stop and finished features begin.

Read the chapter
A place for the mess: a capture from the PixelPunk development archive.
PART 09Dressing & foliage4 min read

A place for the mess.

Rerolling a courtyard, finding room for a crate, and teaching plants where they can grow.

Read the chapter
The town finds its voice: a capture from the PixelPunk development archive.
PART 10Sound & atmosphere3 min read

The town finds its voice.

Construction clicks, a score that makes room for the mouse, and lamps that ease into the evening.

Read the chapter
Someone has moved in: a capture from the PixelPunk development archive.
PART 11Creatures & first moments3 min read

Someone has moved in.

Bird habitats, a cat with an umbrella, and little starting scenes that suggest something to try.

Read the chapter
A different way to look: a capture from the PixelPunk development archive.
PART 12Look profiles & cameras4 min read

A different way to look.

A softer look costs more than expected, and perspective makes a lovely model while complicating the view used for building.

Read the chapter
Letting the town settle: a capture from the PixelPunk development archive.
PART 13Life & finishing touches4 min read

Letting the town settle.

Creatures in normal play, a photo camera that gives your view back, and the window bug that had been dimming the town.

Read the chapter
Keep the house in your hand: a capture from the PixelPunk development archive.
PART 14Editing & performance4 min read

Keep the house in your hand.

Arrow handles, buildings that grow during a drag, a quieter selection highlight, and a closer look at the hitches.

Read the chapter
A house in the branches: a capture from the PixelPunk development archive.
PART 15Growing trees & treehouses6 min read

A house in the branches.

An Amsterdam canal scene exposes the old tree limit. Growing branches and timber supports open up a much taller kind of neighbourhood.

Read the chapter
Watching the trees grow: a capture from the PixelPunk development archive.
PART 16Trees & everyday editing5 min read

Watching the trees grow.

Fuller crowns, a new evergreen, branches that grow when planted, and an interface that leaves more of the town in view.

Read the chapter
Making room for beauty: a capture from the PixelPunk development archive.
PART 17The beautify plan7 min read

Making room for beauty.

What the next art pass aims to change, what it needs to protect, and how the results will be judged.

Read the chapter
Sweeping up the small faults: a capture from the PixelPunk development archive.
PART 18Beautify: the defect sweep9 min read

Sweeping up the small faults.

A measuring kit, wet-leaf glints, darker island banks, clean roof tiles and a softer canal mirror, with the numbers used to judge them.

Read the chapter
Finding the town in the dark: a capture from the PixelPunk development archive.
PART 19Beautify: night palette and values14 min read

Finding the town in the dark.

An indigo sky, a violet lift in the shadows, a warmer dusk, tide marks on the quays and painted metal, then the whole stage measured and timed as one.

Read the chapter
A mist the town can light: a capture from the PixelPunk development archive.
PART 20Beautify: fog, smoke and shade21 min read

A mist the town can light.

Fog tinted by the town, warm smoke, fog and smoke on for new scenes, a crisp Canal contact shade, soil and paving at the tree feet, leaded windows, and the stage timed as a whole.

Read the chapter
Where the island meets the water: a capture from the PixelPunk development archive.
PART 21Beautify: islands in water14 min read

Where the island meets the water.

A lit waterline and a skirt under the boats, rain rings on the water, island banks cut like cake, and the stage measured and signed off.

Read the chapter
A city on the horizon: a capture from the PixelPunk development archive.
PART 22Beautify: skyline, neon bay and golden hour15 min read

A city on the horizon.

A tower skyline, a violet city glow under a two-tone cloud deck, a lamp-lit far quay, light columns on the night bay, and a golden hour that knows where the sun is.

Read the chapter
Lights in the small places: a capture from the PixelPunk development archive.
PART 23Beautify: small items14 min read

Lights in the small places.

Bold marks on unlettered signs, wet glints under lamps, window cores and warm arched rooms, the island clear of the dock, a pixel halo instead of bloom, and a hotter sun disc.

Read the chapter
Leaves lit by every lantern: a capture from the PixelPunk development archive.
PART 24Beautify: trees lit by every lantern12 min read

Leaves lit by every lantern.

Cool undersides and a shadow-side ring, a lamp list for the leaves, lamp light in the leaf shader, crowns in small clusters, and the stage signed off.

Read the chapter
A lived-in town: a capture from the PixelPunk development archive.
PART 25Beautify: a lived-in town22 min read

A lived-in town.

Room stories in lit windows, light that matches the room, glass for unlit panes, a derived roofscape, ivy without a grid, ivy curtains, window boxes, downpipes and vents. Closed and signed off.

Read the chapter
A town that moves: a capture from the PixelPunk development archive.
PART 26Beautify: motion44 min read

A town that moves.

A motion setting, breathing light pools and faulty tubes, rain in single art pixels, one wind that moves trees, cloth, rain and water in whole pixels, bobbing boats, cloud shadows, placement puffs, and a veil of rain that picks up the colour of the lights at night. All four groups of the stage are closed.

Read the chapter
Pixels that stay put: a capture from the PixelPunk development archive.
PART 27Beautify: edges and pixels10 min read

Pixels that stay put.

An edge ink and rim pass, tried and kept off, a cheaper finishing pass at art resolution, a camera that snaps to the art-pixel grid, and smooth panning on top of it. The creator tried the new camera live and kept it.

Read the chapter
Stone, grass and a lighter touch: a capture from the PixelPunk development archive.
PART 28Beautify: polish12 min read

Stone, grass and a lighter touch.

The first round of the polish stage: a hover lift and arrows-only selection with double-click to move, violet-grey stone, banded lawns, slab paving, shadows on the water and lens blur on the art-pixel grid. The creator kept all of it.

Read the chapter
Finer wires and a replanted harbour: a capture from the PixelPunk development archive.
PART 29Beautify: polish18 min read

Finer wires and a replanted harbour.

Cables drawn as one-pixel lines, the Harbour replanted, quay swags, rainy overcast and a placeable beacon, a speck guard measured and not built, art pixels that follow the window, and a pixel font with whole-number interface scales. The polish stage is complete.

Read the chapter
Longer boats and a line to the quay: a capture from the PixelPunk development archive.
PART 30Decor: boats and controls22 min read

Longer boats and a line to the quay.

Photo-mode and Esc fixes, boats with a length grip, six boat styles with houseboats in Amsterdam, and a quay magnet with mooring lines, buoys and fenders, including the review fix that lifts the ropes over the quay’s edge, a floating jetty whose deck never sinks into the ground, the stage’s closing checks and builds, and arrows drawn at the window’s own resolution.

Read the chapter
Iron gates, bicycles and a lifting bridge: a capture from the PixelPunk development archive.
PART 31Decor: ironwork, street life, waterside16 min read

Iron gates, bicycles and a lifting bridge.

Tray groups and type-to-filter, the ironwork stage with gates, railings and garden ironwork, the street stage with bicycles, a market and street furniture, its second pair of builds and the bike redesign the creator asked for, and the waterside stage with the lifting bridge, water clutter and pieces that appear on their own.

Read the chapter
Spires, stained glass and a ruined wall: a capture from the PixelPunk development archive.
PART 32Castle architecture11 min read

Spires, stained glass and a ruined wall.

New tower roofs, bartizans and cupolas, gothic windows and stained glass, buttresses, gargoyles, a clock and a belfry, a viaduct and a covered bridge, the rubble stone and the ruined finish, then a test castle of 121 pieces, the slate spire backs and the creator’s approval.

Read the chapter
Crags, lanterns and a castle on the loch: a capture from the PixelPunk development archive.
PART 33Castle grounds16 min read

Crags, lanterns and a castle on the loch.

A crag and cliff stairs, a boathouse and lantern boats, a glasshouse, perches, a stone circle and pumpkins, arcades, a fountain and gate toppers, banners, torches and braziers, the Loch castle starter, the stage close and its builds, a traced slider release and the creator’s answers.

Read the chapter
PART 34Controls8 min read

Keys, grips and a camera that holds the ground.

One input map for every key, turn grips on props, bench seats, arrow-key nudging, Q and E orbits, four corner views, Space and Alt drags, a corrected pan and saved camera preferences.

The latest chapter
Keys, grips and a camera that holds the ground: an archived development capture.

Straight from the project notes.

Every chapter draws on the development notes and real captures, and the failed experiments and unfinished edges are left in.

How this was put together