Getting Started

If you don’t know how to install Addon, read following documentation.

Overview

How it works

  • You need first to rename 1 bone to fit your requirements: You can choose for example finger.R
    BoneChainRenamer will automatically find if there is a side suffix on your bone name (“.R”).

  • Select all your chain root bones, last selected must be your renamed root bone (at step 1).

  • Launch BoneChainRenamer. Bone Chains are now renamed with following rules:

    • First chain is now finger_0.R (and other bones of this chain finger_0.R.001, etc…)

    • Other chains are named finger_1.R (and finger_1.R.001, etc…), finger_2.R (and finger_2.R.001, etc…)

    • See addon preferences for more information about separator, how to count chains, etc…

    • Chains are renamed based on a sort order of their root bone. On operator properties, you can choose what sort order you want to apply:
      • Alphabetic: based on name of your bone names
      • X location: based on X location of bones (world space) : from the smallest to the largest
      • Y location: based on Y location of bones (world space) : from the smallest to the largest
      • Z location: based on Z location of bones (world space) : from the smallest to the largest
      • X location reversed: based on X location of bones (world space) : from the largest to the smallest
      • Y location reversed: based on Y location of bones (world space) : from the largest to the smallest
      • Z location reversed: based on Z location of bones (world space) : from the largest to the smallest
      • Distance: based on distance to your active bone (world space): from the smallest to the largest
      • Distance reversed: based on distance to your active bone (world space): from the largest to the smallest

    For distances (Distance and _Distance reversed), distance is based on “center” of bones (median point between head and tail), in order to be able to rename in such cases :

    • On a chain, renaming will stop when your chain forks

      Stop when forks

Addon Preferences

Preferences

  • Separator : Underscore by default. Character used to separate your chain name and chain counting

  • Counting method : How to identify chains. Numeric by default : finger_0.R, finger_1.R, finger_2.R, etc…
    It can be changed to alphanumeric: finger_a.R, finger_b.R, finger_c.R, etc…

    With letters

  • No count when single chain rename: If you select only 1 root bone, you can choose if bones will be renamed finger_0.R, or only finger.R

  • Stop chain when bone is not connected: You can choose if renaming stops when a bone is not connected to its parent, or if renaming continue until a bone has no child (connected or not)