Getting Started

Installation

  1. Download the add-on’s .zip file from your purchase platform (Gumroad, Blender Market, etc.).

  2. Open Blender and select Edit > Preferences.

install from disk

  1. Go to the Add-ons tab, click the in the top right, then click Install from Disk….

  2. Select the downloaded .zip file and click Install Add-on.

  1. Download the add-on’s .zip file from your purchase platform (Gumroad, Blender Market, etc.).

  2. Open Blender and select Edit > Preferences.

  3. Go to the Add-ons tab and click the Install… button.

  4. Select the downloaded .zip file and click Install Add-on.

Quickstart

Once the add-on is enabled, the “Structured Renamer” panel will appear in the Tools tab of the 3D Viewport’s sidebar.

Basic Renaming Procedure

  1. Select a Pattern: Choose the naming pattern you want to use from the Naming Patterns dropdown at the top of the panel.

  2. Select Objects: Select one or more objects in the 3D viewport that you want to rename.

  3. Apply Elements: The Name Elements section of the panel displays the elements of the selected pattern.

    • Click text element buttons (e.g., CTRL, Arm): Adds or replaces the element in the selected object’s name.

    • Click position element buttons (e.g., .L, .R): Applies identifiers for left/right, etc.

    • Click counter element buttons (e.g., 01): Adds sequential numbers. Click the last “…” to specify a number manually.

    • Click delete button (e.g., ): Removes the element from the name.

Example: Renaming “Bone” to “CTRL_Arm-01.L”

  1. Select the Bone object.

  2. Select an appropriate pattern.

  3. Click CTRL and Arm from the Text Element item buttons. (Becomes CTRL_Arm)

  4. Click .L from the Position Element item buttons. (Becomes CTRL_Arm.L)

  5. Click 01 from the Counter Element item buttons. (Becomes CTRL_Arm-01.L)

    • (Separators and order depend on the selected pattern settings)

Trying Other Presets

Once you’re familiar with the default patterns, try other presets. The add-on includes various presets for different purposes (rigging, characters, motion graphics, etc.).

  1. Click the import button () in the Naming Patterns section at the top of the panel.

  2. When the file browser opens, navigate to the resources/presets folder in the add-on directory. (Usually opens automatically)

  3. Select and import preset files you want to try, such as vrm.json, hardsurface.json, archviz.json, etc.

  4. The imported patterns will be added to the Naming Patterns dropdown.

For details: Import / Export

Editing Patterns

  • For more detailed settings or to create new patterns, click the Enter Edit Mode button at the top of the panel to switch to Edit Mode.

  • When editing is complete, use Exit Edit Mode to return to Renaming Mode.

More Information

  • For details about each UI element, see User Guide.

  • For concepts about naming patterns and elements, see Concepts.