Blender Integration Guide

Comprehensive instructions for using the LotPixel Blender Add-on. Covers installation, auto-install via Hub, one click imports, texture/model/decal workflows, UI controls, displacement setup, and all Blender-specific behavior.

Complete Guide to Using the LotPixel Blender Add-on

1. Automatic and Manual Add-on Installation

The LotPixel Blender Add-on is installed in two ways:

Automatic Installation (Recommended)

The add-on installation screen appears in one of the following situations:

  • When you try to import a product into Blender for the first time
  • When you click the Settings icon in the top menu of LotPixel Hub and then select Blender Plugin

On this screen, click Install Plugin and the LotPixel Blender Add-on will be automatically installed to the correct Blender directory.

⚠️ Important: After installation, Blender must be restarted for the add-on to become active and ready to use with LotPixel Hub.
No manual steps are required.

Manual Installation

If needed, you can install the plugin manually by:

  1. Download the .zip file (Click Here)
  2. Go to the following directory:
    C:\Users\<your-username>\AppData\Roaming\Blender Foundation\Blender\<version>\scripts\startup
  3. Extract zip file into the startup folder
  4. After extracting the ZIP file, your folder structure should look like:
    ..\startup\Lotpixel Hub\__init__.py
  5. Restart Blender

Once the zip file is installed, the plugin is ready to use. No additional enabling steps are required.

2. One Click Import for Textures, Decals, and 3D Models

The Add-on integrates directly with LotPixel Hub. Clicking Import inside the Hub automatically triggers Blender and imports:

  • Textures
  • Decals
  • 3D Models

No manual setup is required.

Note:

Assets are imported into the software selected in Import SettingsImport to application inside LotPixel Hub.

By default, the asset will be imported into the application that was last selected as the import to application.

You can change the target application at any time when clicking the Import button.

3. Texture Import Behavior

When a texture is imported via LotPixel Hub, the process is fully automated to ensure a fast and consistent workflow.

The texture is automatically applied to the currently selected object in Blender.

A complete PBR material is created from scratch. You do not need to create or configure materials manually.

All available texture maps (such as Albedo, Roughness, Normal, Metallic, Displacement, etc.) are connected automatically based on your Import Settings.

The material setup follows Blender's standard PBR workflow, ensuring compatibility with rendering engines such as Cycles and Eevee.

This behavior allows you to import textures quickly while maintaining a clean and consistent material structure.

4. Decal Import Behavior

Decals in LotPixel Hub are treated as texture-based materials and follow the same import logic as regular textures.

Decals use the same PBR material system as standard textures.

All decal texture maps are connected using the same automatic node setup defined in your Import Settings.

Mask, Opacity, and other relevant maps are handled automatically to ensure correct transparency behavior.

No additional decal-specific setup is required from the user.

This unified system ensures that decals integrate seamlessly into your existing workflow and behave consistently with other LotPixel materials.

4.1 Imperfections Import & Behavior

Imperfections in LotPixel Hub work in two different modes, depending on the material state of the selected object.

When the Selected Object Already Has a LotPixel Material

If the selected object already has a LotPixel material assigned:

  • Imperfections are not imported as a new material.
  • The Imperfections maps are merged into the existing LotPixel material.
  • The base material remains intact, and Imperfections work as a layered enhancement on top of it.

In this case, Imperfections typically influence the following channels:

  • Roughness
  • Normal

This allows you to add:

  • Scratches
  • Smudges
  • Fingerprints
  • Dirt and surface variation

without breaking or replacing the original material setup.

When the Selected Object Has No Material Assigned

If the selected object has no material assigned at all:

  • Imperfections are imported as a new LotPixel material.
  • This newly created material is automatically assigned to the selected object.
  • All Imperfections maps are connected so the material can function independently.

This makes it possible to use Imperfections directly on an empty object as a quick starting material.

5. 3D Model Import Behavior

When a 3D model is imported through LotPixel Hub, Blender handles the process automatically with minimal user input.

Imported models are placed at the current 3D Cursor location in the scene.

The model is imported using the selected format (FBX or OBJ), as defined in your Import Settings.

If texture files are available for the model, materials are generated and assigned automatically.

This approach allows you to quickly bring models into your scene without manual cleanup or setup.

6. Material UI Controls

The LotPixel Add-on provides a custom UI panel inside Blender for quick adjustments:

  • Hue
  • Saturation
  • Brightness
  • Contrast
  • Roughness
  • Metallic
  • Specular
  • Ambient Occlusion
  • Normal Map Strength
  • Emission Strength and Color
  • Opacity / Mask
  • UV Tiling / Rotation / Location
  • Displacement toggle

These controls make material editing fast and non-destructive.
The LotPixel Add-on provides a custom UI panel inside Blender for quick adjustments.
To access this panel, press N to open the right-side toolbar and select the LotPixel tab.

Material UI Controls

7. Displacement Setup

For highest quality, EXR displacement maps are recommended.

Automatic Displacement Activation

When you enable Displacement inside the Add-on UI, Blender automatically:

  • Switches material settings to Displacement and Bump
  • Connects your displacement node
  • Prepares your shader for true height displacement

You do not need to manually change Blender settings.

8. Mesh Requirements for Displacement

To see real displacement:

Your mesh must be high-poly or you must add a Subdivision Surface Modifier.