Note: Pre-Release Documentation

This documentation is currently a pre-release version and is exclusive to members for early access. Please note that it is not yet complete and will evolve as the addon is refined. Thank you for your understanding and support during this phase!

About Hair Wrangler

Hair Wrangler is a Blender addon designed to make working with hair systems easier and more intuitive. It focuses on giving artists the ability to use regular curves to style hair, which can feel much more natural and precise compared to Blender’s default grooming tools.

The addon is aimed at simplifying workflows while still offering the flexibility to create everything from realistic hairstyles to abstract designs. It’s especially useful for those who want to spend less time setting up complex systems and more time focusing on the creative aspects of their work.

1. Key Features

Hair Wrangler has a growing number of features designed to simplify and enhance the hair creation process in Blender:

One-Click Setup

Getting started is effortless. Import a fully configured hair system with a single click, complete with everything you need to begin styling. This saves time and allows you to dive straight into the creative process.

Curve-Based Styling

At the heart of Hair Wrangler is its ability to let you control hair with regular Blender curves. This means you can shape and style hair strands in a way that feels natural and intuitive, using tools you’re already familiar with. No need to wrestle with complex grooming tools—just create or modify curves, and watch your hair system follow suit.

Strand/Geometry Switching

Hair Wrangler allows you to easily switch between strand-based hair and geometry-based visualizations with a single click. This feature is particularly helpful when you’re trying to refine the overall shape of the hair or need a clearer view of how it flows in 3D space.

Convert Existing Geometry Hair

If you’ve already created a hairstyle using poly curves, Hair Wrangler makes it easy to integrate them into your workflow. Add them to the system, and they’re automatically converted to strand hair, preserving your effort while giving you the benefits of Hair Wrangler’s features.

Modifier Control

Managing hair modifiers can be a tedious process in Blender. Hair Wrangler simplifies this by providing a dedicated UI to add, rearrange, and tweak modifiers without having to dig through menus. This keeps your workflow clean and focused, so you can make adjustments quickly.

Viewport Display Options

Adjusting how your hair system appears in the viewport is straightforward with Hair Wrangler. Whether you’re tweaking density, resolution, or other display settings, you can make adjustments directly in the addon without switching render engines or navigating complex menus.

Version History

Version 1.0 (Initial Release)

The first release of Hair Wrangler focuses on providing a strong foundation for curve-based hair creation in Blender. Key features include:

This version focuses on establishing core functionality and addressing the key pain points artists face when creating and managing hair systems in Blender. Future updates will build on this foundation, introducing new features and further refining workflows based on user feedback.


2. Installation

Requirements

Hair Wrangler has been tested and is fully compatible with Blender 4.1 and later versions. Using an older version of Blender may result in unexpected behaviour or missing features.

Download & Installation

Follow these steps to download and install Hair Wrangler:

  1. Download the Addon
  2. Install the Addon in Blender

Activation

After installing Hair Wrangler, follow these steps to activate it:

  1. Enable the Addon
  2. Save User Preferences
  3. Verify Installation

Troubleshooting Installation

If you encounter issues during installation:


3. Quick Start Guide

The Quick Start Guide provides an overview of how to set up and style a hair system using Hair Wrangler. It covers adding a new hair system, styling techniques, and utilizing modifiers to achieve different looks.

Introduction to Key Terms

Before diving into the Quick Start Guide, it's important to understand a few key terms that are central to using Hair Wrangler:

1. Adding a new Hair System

The first thing you want to do when using Hair Wrangler is add a new hair system.

Add your first Hair System:

Screenshot 2025-01-20 130931.png

This will import a pre-configured hair system into your scene, alongside a curve/lock of hair.

Screenshot 2025-01-20 132015.png

It will also import a collection into the Outliner with this structure:

Screenshot 2025-01-20 140229.png

dm3d-hair collection: Contains the dm3d-hair-curves collection, and DM3D Hair System

dm3d-hair-curves collection: Contains the curves that are converted into hair strands.

dm3d-hair-curve.001: An initial curve that’s imported by default.

DM3D Hair System: This is the system that converts the curves above into hair strands.