UV Mapping for Minecraft Models, Without the Jargon

A UV is an address. It tells one face of a cube which rectangle of the texture image to display. That is the whole idea; the rest is bookkeeping.

Box UV vs per-face UV

Box UV lays out all six faces of a cube automatically, in the cross pattern you see on the vanilla player skin. It is fast and it is what Minecraft entities use.

Per-face UV lets every face point anywhere in the image, independently. It costs more work and buys you reuse: one small texture can serve twenty cubes, because each face picks the patch it needs.

Importing a box-UV .bbmodel into our editor converts it to per-face UVs and tells you how many cubes were converted — the shape is unchanged, the addressing is just written differently.

Why a texture lands sideways

Each face carries a rotation of 0, 90, 180 or 270 degrees, applied after the UV. A plank running the wrong way is almost never a modelling error; it is a face rotation. Fix it on the face, not by rotating the cube.

Keep the texture small

16×16 or 32×32 per block is not a limitation, it is the look. A 512×512 texture on a chair does not read as more detailed in game — it reads as blurry, because the renderer samples it with nearest-neighbour filtering and everything soft turns to mush.

Practical habit

Paint on the model rather than in an image editor for anything positional, then touch up the flat texture for detail. Seeing the seam while you draw is worth more than any amount of guessing over a UV sheet.