<aside> ✅

Official minimum: Blender 5.1.0 Primary release target: Blender 5.1 Current Rigger Aids release: 5.1.1

</aside>

Supported Blender Versions

Blender version	Status	Notes
5.0.x	Not officially supported	The add-on metadata requires Blender 5.1.0. Some code may load in 5.0, but Rigger Aids 5.1.1 is not certified for production use there.
5.1.x	Supported	Primary target for Rigger Aids 5.1.1. Registration and removal were verified in Blender 5.1.2.
5.2.x	Compatible	Registration and removal were verified in Blender 5.2.0 LTS. Report any workflow-specific issue caused by an API change.
Future Blender 5.x releases	Check before production use	Rigger Aids is intended for Blender 5+, but a future Blender release is not automatically certified until it has been tested.
Blender 4.x and older	Not supported	Use a release specifically made for that Blender generation, if one is available.

<aside> ℹ️

“Blender 5+” describes the product generation. It does not mean every past or future Blender 5.x build has identical API behavior. Always check the supported-version table and release notes.

</aside>

System Requirements

<aside>

Operating System

Rigger Aids is written in Python and uses Blender’s built-in Python API. It has no detected third-party Python package dependency.

Windows: Primary development and testing platform.
macOS: Expected to work where the matching Blender version is supported, but not currently part of the primary test environment.
Linux: Expected to work where the matching Blender version is supported, but not currently part of the primary test environment.

If an operating-system-specific problem occurs, include the operating system and Blender build information in the support request.

Hardware

Rigger Aids does not require specialized hardware beyond Blender’s own requirements.

Performance depends mainly on:

Number of armatures, bones, constraints, actions, drivers, shape keys, and vertex groups
Complexity of the current scene
Size of batch operations
Available system memory

Large production rigs may take longer to scan, refresh, rename, or process than small test rigs.

</aside>

Software and Package Requirements

<aside>

A supported official Blender release
The original Rigger Aids ZIP supplied through Superhive
Permission to install Blender extensions or add-ons for the current user
Write access to Blender’s user configuration or extension directory
No separate Python installation
No required third-party add-on

Recommended add-ons listed in Recommended Add-ons are optional unless a specific integration explicitly says otherwise.

</aside>

Blender Data Requirements

<aside>

Rigger Aids operates on existing Blender data. Individual tools may require one or more of the following:

An active armature or mesh object
Selected bones, pose bones, vertices, objects, actions, drivers, constraints, shape keys, or vertex groups
The correct Blender mode, such as Object, Edit, Pose, or Weight Paint mode
Editable local data rather than read-only linked data
A saved file or backup before destructive batch operations

Each feature page identifies its intended context and workflow.

</aside>

Permissions and Local Files

<aside>

Script Library

The Script Library can register folders containing Python scripts and run a selected script inside Blender.

<aside> ⚠️

Only run scripts from sources you trust. A Blender Python script can modify the current file and access files available to your user account.

</aside>

Rigger Aids does not require the Script Library for its other toolsets.

Internet Connection

An internet connection is needed to download Rigger Aids and obtain updates from Superhive. The installed add-on does not require a continuous internet connection for its normal local rigging tools.

</aside>

File Safety and Backups

<aside>

Before using batch rename, delete, constraint, parenting, driver, shape key, or vertex group operations:

Save the Blender file.
Create a versioned backup for important production work.
Test unfamiliar batch operations on a copy.
Review the active object, selected items, checked rows, and current mode.

Some Blender operations may not be fully recoverable after saving and closing the file.

</aside>

Version Information for Support

<aside>

Include all of the following when requesting compatibility support:

Rigger Aids version
Blender version, including patch number
Operating system and version
Whether Blender is an official release, beta, daily build, or custom build
Whether the file uses linked or library-overridden data
Complete error message
Minimal steps that reproduce the issue

You can find the Blender version under Help → About Blender and the Rigger Aids version in Edit → Preferences.

</aside>

Compatibility Policy

<aside>

The supported minimum version is defined by the Rigger Aids release metadata.
Patch releases within a supported Blender line are preferred because they include Blender bug fixes.
Beta, alpha, and daily Blender builds are not recommended for production use.
Compatibility with a newly released Blender version may require a Rigger Aids update.
Older Rigger Aids releases remain tied to the Blender generation for which they were published. </aside>