Open-Source Blender Add-ons · Python

My Add-Ons

I build Blender add-ons with Python and Claude Code to take the busy work out of 3D, so I can spend more of my time on the art!

Smart Seams

Blender add-on · Python · GPL-3.0

Why I made it

I made every object on this page by hand, and they're being used in a project. Hand-painted textures and complex models take a ton of time, and UV unwrapping is the kind of busy work that eats into it. So I teamed up with Claude Code to build a tool that does that part faster, which leaves me more time for the creative stuff where human effort really counts. It's already helping me and my senior thesis film team keep our focus on the artistry!

Blender's Smart UV Project and Substance Painter's auto-unwrap tend to give you UVs that:

  • cut right through the middle of surfaces instead of following clean edge loops,
  • put seams anywhere, even in plain sight,
  • break one object into a bunch of tiny shells.

Smart Seams never lets UVs overlap, keeps stretching to a minimum, and gives less texture space to the parts nobody sees (undersides, faces sitting on the floor, inside faces).

Hand-made UVs vs Smart Seams

On the left are the UVs I unwrapped by hand for this lamp base, on the right is what Smart Seams made from the same model. First a checker texture (even, square tiles mean no stretch), then a stretch heat map, then both UV layouts.

Lamp base: worst shell stretch 9.63 by hand vs 0.06 with Smart Seams, and 82 flipped faces vs 0. To be fair to my hand-made version, a lot of that score comes from faces on its top that had collapsed flat in the UVs. Smart Seams isn't perfect either: the inside of the little hole on top still stretches a bit (the yellow spot).

UV layout

Left is a hand-made unwrap of a lamp base, right is Smart Seams on the same mesh.

The lamp base's hand-made UV layout: a top, a side strip and a bottom, with the bevels squashed into thin slivers
Hand-made, UV layout
The lamp base's UV layout from Smart Seams: the top with its holes, the bottom, the side band and the triangle recess
Smart Seams, UV layout

Before and after: the lamp base

Each color is its own UV shell, and the red lines are seams.

The lamp base with its hand-made UVs: 3 UV shells
Hand-made: 3 shells
The lamp base with Smart Seams: 4 UV shells, with seams along the panel borders
Smart Seams: 4 shells

From below

The underside of the lamp base with its hand-made UVs
Hand-made, from below
The underside of the lamp base with Smart Seams
Smart Seams, from below

Checker texture (stretch test)

The lamp base with a checker texture on its hand-made UVs: the texture smears and stretches
Hand-made: the checker smears and stretches
The lamp base with a checker texture on the Smart Seams unwrap: the squares stay even
Smart Seams: the squares stay even

Results

The lamp base, before and after
Hand-madeSmart Seams
UV shells34
UV overlap2.4%0%
Flipped faces820
Worst stretch9.630.06
Mean angle error31.0°0.1°
Seam length5.66.6

Smart Seams uses one more shell and a little more seam than the hand-made version, but in exchange every shell lies flat, with no overlap, no flipped faces and almost no stretch. It also only uses as many shells as it needs: one for a cube, three for a cylinder and four for the lamp base.

Simple shapes

How it works

When I unwrap by hand, I don't place seams one edge at a time. I look at an object as panels (the tabletop, each side of a leg, the wall of a hole) and decide which ones belong together. Smart Seams works the same way:

  • It figures out which faces are hard to see (under the tabletop, between the legs, on the floor) and hides seams there.
  • It groups faces into panels, and only ever cuts along the edges of a whole panel.
  • Round parts like cylinder walls get one clean, straight cut down the least visible side.
  • It joins panels into as few shells as it can, and checks every join with Blender's own unwrapper so nothing flips, overlaps or stretches too much.
  • Last, it evens out texel density, shrinks the hidden shells and packs everything.

Get it

It's free and open source (GPL-3.0). You need Blender 4.2 or newer. Select a mesh, open the sidebar (N) and hit Smart Seams Unwrap!

Texture Plugger

Blender add-on · Python · GPL-3.0

Why I made it

Every PBR texture set comes as a pile of files: base color, roughness, metallic, normal, height, AO, and sometimes packed maps with three of those squished into one image. Hooking them all up in the Shader Editor by hand means a lot of dragging nodes around and remembering which ones need Non-Color, which normal maps need their green channel flipped, and so on. It's the same few minutes of busy work every single time, so I made Texture Plugger with Claude Code to do it for me.

Point it at a folder (or drag the images into Blender) and it:

  • figures out which map is which from the filenames, including the naming styles from Poly Haven, ambientCG, Quixel/Megascans, Substance, Poliigon and Unreal/Unity,
  • wires every map into a Principled BSDF with the right color space,
  • handles DirectX normal maps, bump, displacement, opacity, emission and packed maps (ORM, ARM, MaskMap and friends),
  • can be run again without ever making duplicate nodes, and only ever removes the nodes it made itself.

Before and after

The same scene before and after loading two texture folders, one for the floor and one for the crates. Rendered in Cycles.

A floor and two crates with no materials
Before: no materials
The same scene after Texture Plugger: a displaced stone floor and two yellow painted metal crates with chipped paint
After: both sets plugged in

From a folder to a material

I made the example textures procedurally just for these screenshots.

What it hooks up

Each map, where it goes, and its color space
MapGoes intoColor space
Base ColorBase Color (times AO, if there is one)sRGB
Roughness, MetallicStraight inNon-Color
GlossInverted into RoughnessNon-Color
Normal (OpenGL or DirectX)Normal Map nodeNon-Color
HeightDisplacement or BumpNon-Color
Packed (ORM, ARM, MaskMap)Split into its channelsNon-Color
EmissionEmission ColorsRGB
OpacityAlphaNon-Color

Everything lands in a labelled frame with a tidy, repeatable layout, so the node tree stays readable. If a folder has more than one texture set, you can pick which one to use, and every map can be swapped or switched off before you hit Apply.

Get it

It's free and open source (GPL-3.0). You need Blender 4.5 or newer. Open the sidebar (N), go to the Texture Plugger tab and hit Load Texture Set!