<aside> 🛟

Start with the checks in order. Many Rigger Aids problems come from an unsupported Blender version, a duplicate installation, the wrong active object or mode, stale list data, or an operation whose required source and target data is incomplete.

</aside>

First Checks

<aside>

1. Save the current Blender file under a new name.
2. Confirm the exact Blender and Rigger Aids versions.
3. Confirm that the Blender version is supported.
4. Restart Blender and reproduce the problem once.
5. Check the active object, selection, and Blender mode.
6. Refresh the relevant Rigger Aids list or panel.
7. Test the same operation in a small new file.
8. Record the complete error message before changing the setup. </aside>

Installation and Startup

<aside>

Rigger Aids Does Not Appear in Preferences

• Install the original Superhive ZIP without extracting it.
• Confirm that the ZIP contains the Rigger Aids package rather than another ZIP or a GitHub source archive.
• Use Edit → Preferences → Get Extensions → Install from Disk.
• Confirm that the Blender version meets the release minimum.
• Restart Blender after installation.

Rigger Aids Is Installed but the Sidebar Tab Is Missing

• Move the pointer over a 3D Viewport and press N.
• Confirm that the current editor is a 3D Viewport.
• Search for Rigger Aids in Preferences and enable it.
• Disable and re-enable the add-on once.
• Restart Blender.

Duplicate Panels or “Already Registered” Errors

This usually indicates more than one Rigger Aids copy or a stale Blender session.

1. Disable Rigger Aids.
2. Search Blender’s extension and add-on locations for older Rigger Aids installations.
3. Remove the obsolete copy.
4. Restart Blender.
5. Install and enable only the current release.

<aside> ⚠️

Do not keep a legacy add-on copy and an extension copy enabled at the same time.

</aside>

</aside>

Context and Selection Problems

<aside>

A Button Is Disabled

Check:

• Required object type
• Active object
• Selected objects or bones
• Object, Edit, Pose, Weight Paint, or another required mode
• Whether the data is editable
• Whether the required source, target, checked row, or list item exists

A disabled button often protects against running an operation in an invalid context.

The Tool Uses the Wrong Object

• Confirm the active object, not only the selected objects.
• Check the object stored in the relevant Rigger Aids list.
• In Advanced Bone Collection, confirm the chosen armature.
• In mesh tools, confirm the active mesh and its mesh data.
• Remove stale list entries and refresh the list.

Linked Data Cannot Be Edited

Objects, armatures, actions, or other data linked from an external library may be read-only. Use an appropriate library override or work on local editable data. Save a backup before changing a production linking workflow.

</aside>

Lists Do Not Match the Scene

<aside>

An Armature, Bone Collection, Action, or Group Is Missing

• Confirm that the data exists in the current scene or file.
• Refresh the relevant list.
• Clear filters.
• Confirm that the intended object is active or stored in the panel.
• Check whether the item was renamed after the list was created.
• Remove invalid rows and add the item again.

Checked Rows Produce an Unexpected Scope

Before applying a batch command:

• Clear filters temporarily.
• Review all checked and unchecked rows.
• Confirm whether the command affects the active object, selected objects, or all listed items.
• Test on a small subset. </aside>

Advanced Bone Collection

<aside>

Bone Visibility or Solo State Looks Wrong

• Confirm the active armature and bone collection.
• Check Blender’s native bone collection visibility.
• Disable any active solo state.
• Confirm whether you are viewing Object, Edit, or Pose mode.
• Refresh the collection and bone lists.

Constraints Do Not Change

• Confirm that the target pose bones have constraints.
• Check whether constraints are muted.
• Confirm that the chosen batch fields are checked.
• Verify source and target bones.
• For Armature constraints, verify all target slots and weights.

Bone Color or Display Changes Are Not Visible

• Confirm whether the operation targets bones, a collection, or both.
• Check the viewport’s armature display settings.
• Confirm the active armature and selected list rows.
• Refresh the viewport by changing mode or selecting the armature again. </aside>

Vertex Groups

<aside>

</aside>

Shape Keys

<aside>

</aside>

Actions and Action Slots

<aside>

</aside>

Driver Aids

<aside>

</aside>

Batch Constraints and Bone Parenting