Skip to content

Import Pixel Art

by bloody_albatross·Modeling

Images © bloody_albatross. Used for product review; image policy.

Why we like it

Earns its place in the blender_extensions library for a focused job: turning pixel art into per-pixel geometry with shared materials and pattern-based naming.

What is Import Pixel Art?

Import Pixel Art is a Blender add-on that converts pixel art images into 3D geometry, creating one element per pixel. Pixels with 100% alpha are skipped, and every pixel of the same color shares a single material, so adjusting that material updates all matching pixels at once.

Two import modes are available. Separate Cubes creates a 1x1x1 cube for each pixel as its own object, all parented to an empty so the whole piece can be transformed together and moved pixel-by-pixel while holding ctrl. 2D Mesh places every pixel as a plane in one single mesh, which imports faster; extrude by one unit in Z or add a solidify modifier if you want depth.

Materials can optionally use nodes, and existing materials with matching names can be reused. Object, pixel, mesh and material names follow format string patterns using variables like {filename}, {color}, {x} and {y}. An optional auto down-scaling step handles pixel art that was up-scaled to an exact integer multiple, working best with PNG, BMP or GIF rather than lossy formats.

Who is Import Pixel Art best for?

Import Pixel Art is best for importing pixel art images into Blender as colored cubes or flat squares.

How much does Import Pixel Art cost?

Import Pixel Art is completely free to download and use.

Key features

  • Two import modes: separate 1x1x1 cubes as individual objects, or a single 2D mesh of 1x1 planes
  • Pixels of the same color share one material, so editing that material affects all matching pixels
  • Separate cubes are parented to an empty object so the whole piece can be transformed at once
  • Optional material nodes for the created materials
  • Customisable object, pixel, mesh and material names through format string patterns with variables like {filename}, {color}, {x} and {y}
  • Option to reuse existing materials that match the specified name
  • Optional auto down-scaling for pixel art up-scaled to an exact integer multiple

Tags

#pixel art#importer#cubes#materials#mesh#Blender add-on#GPL

Frequently asked questions

Does Import Pixel Art work with Blender 4.2?

Import Pixel Art is compatible with Blender 4.2 LTS and newer. It's distributed as an add-on for these versions, so if you're on 4.2 LTS or a later release you can install and activate it. The current build is version 1.2.1, last updated on 2024-09-09. For the most recent status and any changes to supported versions, the developer's page on GitHub is the place to check.

How do I install Import Pixel Art in Blender?

Import Pixel Art installs through Blender's add-on preferences. Open Edit > Preferences > Add-ons, use the Install button to add the script, then click the checkbox to activate it. Once enabled, the add-on can import pixel art images as separate cubes or a single 2D mesh. For best results the source image should have each apparent pixel be an actual 1x1 pixel; otherwise you can enable the auto down-scaling option. Full details are available on the developer's page on GitHub.

What image formats work best with Import Pixel Art's auto down-scaling?

Import Pixel Art's auto down-scaling works best with PNG, BMP or GIF images. It only succeeds when the pixel art was up-scaled to an exact integer multiple of the original with no other filters applied. Lossy formats like JPEG will almost always fail because they smudge the pixels. The process is done in Python and can be slow for big images, so down-scaling manually with a nearest-neighbor option in an image editor is another route.

How do I control the names of the objects Import Pixel Art creates?

Import Pixel Art lets you set names for the parent empty, pixel objects, meshes and materials through format string patterns. Patterns can use variables such as {filename}, {use_nodes}, {color}, {x} and {y}, which are replaced with their values. To include literal curly braces in a name, escape them as {{ and }}. Because same-color pixels share a material, the material name pattern helps you group and adjust them together.

Is Import Pixel Art free?

Import Pixel Art is listed as free here and is released under the GNU General Public License v3.0 or later. The add-on imports pixel art images into Blender as colored cubes or flat squares, with pixels of the same color sharing a material and optional auto down-scaling for up-scaled images. For current licensing terms, the full source code and the latest version, the developer's page on GitHub is the place to look.

Alternatives to Import Pixel Art

Also in Modeling for Blender.

Similar plugins