The first 3D viewer on Mister Blocks drew bricks as coloured boxes with little cylinders on top. It was technically correct and looked like a spreadsheet. Kids building from instructions need to recognise the piece in their hand, so I spent a surprising amount of time making three.js bricks look like real plastic.
Here's what made the difference, roughly from biggest to smallest.

Tesla Cybertruck: 61 pieces, 9 steps. More LEGO cars.
1. Light it like a product photo
Flat lighting is what makes 3D bricks look like boxes. Real ABS plastic has a soft sheen and bright edges, because in every product photo it's sitting in a studio.
So the viewer builds one: an environment map of a soft grey room with a big softbox overhead and strip lights at the sides. Every brick reflects it a little, which gives the tops a gentle sheen and catches a highlight along every edge. That one change did more than everything else in this post.
Two smaller fixes made it read correctly:
- Colour space. Colours are picked in sRGB (that's what LEGO colour charts give you), converted to linear for the renderer to mix light, and the picture goes back to sRGB at the end. Skip that and the lighting mixes the wrong numbers, so colours come out muddy.
- Seam lines that work on dark bricks. Joins between bricks get a thin line: dark on light bricks, light on dark bricks. Without the second half, a black wall looked like one solid slab.
2. Put it on a real table
A model floating in a blue void reads as a render. The same model on a wooden table reads as something you could build.
The table is a top-down photo of our own wooden table, scaled so 1,125 pixels = 34 studs (27 cm), mirrored so it tiles without seams, and fading into a dim room behind the model like a close-up photo. A soft dark patch right under the model grounds it, and the sun's shadow box is fitted tightly around the model, so its shadow is sharp where it touches the table and soft further out.

Shelby Cobra 427: 69 pieces, 8 steps. One of the easy builds.
Every build's picture on the site (the gallery cards, Open Graph images, the image sitemap) is the real viewer, drawn by a headless browser at 1600×1200 on that table and stored in R2. Same renderer, same look, everywhere.
3. Bricks are hollow underneath
When you open a piece from the parts list, it slowly tips over to show its underside, because that's how you tell a brick from a stack of plates, and a 2×4 from a 2×4 tile.
The underside is real LEGO geometry (1 unit = 8 mm): a 1 mm top and 1.2 mm walls around an open cavity. Pieces 2 wide or more get a hollow tube (6.5 mm outside, 4.8 mm hole) between every four studs; 1-wide pieces get a thin pin. The cavity ceiling and tube holes are drawn dark so you see them as holes, not as a flat bottom.
Only the single-piece viewer draws this. A 1,000-piece model stays solid, because nobody sees the bottom of a brick that's sitting on another brick.
4. Draw less, so 1,300 pieces stay fast
Some of the sculptures have more than 1,300 pieces, and they have to animate on a phone.
- Geometry is shared by every piece of the same size, and outlines are computed once per size.
- All the studs of one piece are one mesh.
- Covered studs aren't drawn. For each stud, the viewer knows the step at which something will sit on it, and hides it from that step on.
That last one had a bug that only showed in the exploded view. With the layers pulled apart, the covered studs were still hidden, so every layer looked smooth on top with nothing to connect to. Now, exploded, every piece shows all its studs.

RoboCop: 91 pieces, 9 steps. In robots and movie builds.
5. Small things that make it feel right
- Scrubbing never bounces. Pressing Next drops the new pieces in with a little fall. Dragging the step slider is instant, and a hidden piece cancels any half-finished drop. Before that, scrubbing back and forth made the whole model jitter.
- The slider doesn't resize under your finger. The step label used to sit next to the slider; its changing length resized the slider while you dragged it. It moved to its own line.
- Tall figures keep their heads. The camera frames the whole model as seen from its viewing angle, not from straight ahead, so tall figures fit.
-
Degrees vs radians. Some stored builds had their camera angles saved in degrees (
az 30, el 35) and the viewer read them as radians, so a few models opened looking up from under the table. Now any angle that's clearly degrees is read as degrees. - Night mode turns the lights down and lets neon pieces glow with a soft bloom, for the city and sci-fi builds.
- Hover to explain. Point at a brick and a card says what it is; point at a step in the list and its pieces light up while everything else fades.

Sans (Undertale): 116 pieces, 10 steps. More video game builds.
Try it
Every build on the site uses this viewer, and every guide prints as a booklet or a PDF. A few to turn around:
- Rick's Space Cruiser from TV shows and space
- Xbox Series X with a controller
- Bluey's Queenslander house from buildings
Or snap a photo of your own loose bricks at misterblocks.com: it works like a LEGO scanner app and gives you custom instructions for builds made from exactly what you have.
Unofficial fan builds. LEGO® is a trademark of the LEGO Group, which does not sponsor or endorse this site. Characters and brands belong to their owners.


Top comments (1)
Cool! I love Sans 💀