Documentation

📚 ULTIMATE BATCH RENAME PRO - COMPLETE DOCUMENTATION

📋 TABLE OF CONTENTS

1. Overview

2. Installation

3. Quick Start

4. Features

5. User Interface

6. Usage Examples

7. Game Engine Presets

8. Preset System

9. History System

10. Advanced Features

11. Troubleshooting

12. FAQ

13. Support

🎯 OVERVIEW

Ultimate Batch Rename Pro is a professional batch renaming solution for Blender, designed to streamline your workflow and save hours of manual work. Whether you're organizing complex scenes, preparing assets for game engines, or standardizing naming conventions across your team, this addon provides all the tools you need.

Key Statistics:

• Rename 1000+ objects in under 1 second

• 95% time savings compared to manual renaming

• Zero performance impact on your Blender projects

• Compatible with Blender 3.0+

💿 INSTALLATION

1. Download the ultimate_batch_rename_pro.zip file from Blender Market

2. Open Blender and go to Edit → Preferences → Add-ons

3. Click Install and select the downloaded ZIP file

4. Enable the addon by checking the box next to Object: Ultimate Batch Rename Pro

5. The addon will appear in the 3D Viewport → Sidebar → Rename Pro tab

System Requirements:

• Blender 3.0 or higher (tested up to 4.4)

• No additional dependencies required

🚀 QUICK START

1. Select objects you want to rename in the 3D Viewport

2. Open the sidebar (press N) and click on the Rename Pro tab

3. Enter your find/replace criteria

4. Click the RENAME button

Example: Rename Cube.001, Cube.002, Cube.003 to Box_01, Box_02, Box_03:

• Find: Cube

• Replace: Box

• Enable: Add Numbers

• Format: _01

• Click RENAME

🔧 FEATURES

1. Find & Replace

• Simple Text Replacement: Basic find and replace functionality

• Regular Expressions: Full regex support for complex patterns

• Case Sensitive: Optional case-sensitive matching

2. Prefix & Suffix

• Add text before or after existing names

• Combine with other operations for complex renaming

3. Auto-Numbering

• Formats Available:

• 001, 002, 003... (3 digits with leading zeros)

• 01, 02, 03... (2 digits with leading zeros)

• 1, 2, 3... (simple numbers)

• _001, _002, _003... (underscore prefix)

• .001, .002, .003... (dot prefix)

• Custom Start Number: Begin numbering from any value

4. Target Types

• Selected Objects: Rename only selected items

• Hierarchy: Rename parent/child relationships

• Active Collection: Rename all objects in active collection

• Materials: Batch rename materials

• UV Maps: Rename UV map layers

• Vertex Groups: Rename vertex groups

5. Hierarchy Modes

• Children Only: Rename only child objects

• Parent + Children: Rename parent and immediate children

• Recursive: Rename entire hierarchy tree

🖥️ USER INTERFACE

Main Panel

┌─ Target ─────────────────────┐

│ ○ Selected Objects           │

│ ○ Hierarchy                  │

│ ○ Active Collection          │

│ ○ Materials                  │

│ ○ UV Maps                    │

│ ○ Vertex Groups              │

└──────────────────────────────┘

┌─ Find & Replace ─────────────┐

│ Find:    [_______________]   │

│ Replace: [_______________]   │

│ □ Use Regex                  │

└──────────────────────────────┘

┌─ Prefix & Suffix ────────────┐

│ Prefix: [_____] Suffix: [___]│

└──────────────────────────────┘

┌─ Auto Numbering ─────────────┐

│ □ Add Numbers                │

│ Format: [001 ▼]              │

│ Start: [1]                   │

└──────────────────────────────┘

┌─ Game Engine Presets ────────┐

│ [None ▼]                     │

└──────────────────────────────┘

    [    RENAME    ]

Presets Panel (Collapsible)

• Preset list with selection

• Add preset button [+]

• Delete preset button [-]

• Rename preset button [Aa]

• Load preset button [↓]

History Panel (Collapsible)

• Shows last 10 operations

• Timestamp for each operation

• Details of renamed items

• Clear history button

📖 USAGE EXAMPLES

Example 1: Basic Renaming

Task: Rename all default cubes to game-ready assets

• Find: Cube

• Replace: SM_Building

• Add Numbers: ✓

• Format: _001

• Result: Cube.001 → SM_Building_001

Example 2: Using Regular Expressions

Task: Remove all numbers from object names

• Find: \.\d+$

• Replace: (empty)

• Use Regex: ✓

• Result: Object.001 → Object

Example 3: Hierarchy Renaming

Task: Rename character hierarchy

• Target: Hierarchy

• Mode: Recursive

• Prefix: Character_

• Result: All bones/meshes get Character_ prefix

Example 4: Material Organization

Task: Standardize material names

• Target: Materials

• Find: Material

• Replace: MAT

• Suffix: _Base

• Result: Material.001 → MAT_Base

Example 5: Collection Batch Processing

Task: Rename all objects in "Props" collection

• Target: Active Collection

• Find: Untitled

• Replace: Prop

• Add Numbers: ✓

• Result: Organized prop naming

🎮 GAME ENGINE PRESETS

Unity Preset

• Converts to CamelCase naming

• Removes underscores and spaces

• Example: my_object_name → MyObjectName

Unreal Engine Preset

• Adds appropriate prefixes:

• SM_ for Static Meshes

• SK_ for Skeletal Meshes

• M_ for Materials

• T_ for Textures

• Example: Wall → SM_Wall

Godot Preset

• Follows Godot naming conventions

• Uses snake_case format

• Adds resource prefixes

💾 PRESET SYSTEM

Saving Presets

1. Configure your desired settings

2. Click the [+] button in Presets panel

3. Enter a descriptive name

4. Click OK

Loading Presets

1. Select a preset from the list

2. Click the [↓] button

3. Settings are instantly applied

Managing Presets

• Rename: Select preset and click [Aa]

• Delete: Select preset and click [-]

• Organize: Presets are saved per Blender file

Recommended Presets

• Game Ready: Prefix SM_, numbers _001

• Animation: Prefix Anim_, suffix _Base

• Materials: Replace Material with M_

• Cleanup: Remove .001 patterns with regex

📜 HISTORY SYSTEM

Features

• Automatic logging of all operations

• Timestamp for each action

• Detailed before/after information

• Configurable history limit (10-200 entries)

Usage

• View recent operations in History panel

• Track changes for documentation

• Clear history with one click

🔬 ADVANCED FEATURES

Regular Expression Examples

Remove trailing numbers:

regex

Find: \.\d{3}$

Replace: (empty)

Add prefix to specific pattern:

regex

Find: ^(Wall|Floor|Ceiling)

Replace: SM_$1

Convert underscores to dots:

regex

Find: _

Replace: .

Batch Processing Tips

1. Use Collections: Organize objects into collections for easier batch processing

2. Test First: Try operations on a few objects before applying to hundreds

3. Save Presets: Create presets for repetitive tasks

4. Combine Operations: Use prefix + numbering for complete renaming

🔧 TROUBLESHOOTING

Common Issues

Q: The addon doesn't appear in the sidebar

• A: Enable the addon in Preferences

• A: Press N to show the sidebar

• A: Check the "Rename Pro" tab

Q: Regex pattern causes an error

• A: Verify your regex syntax

• A: Test pattern on regex101.com first

• A: Escape special characters properly

Q: Numbers don't increment properly

• A: Ensure objects are selected

• A: Check the start number setting

• A: Verify the numbering format

Q: Preset won't save

• A: Enter a unique preset name

• A: Ensure you have settings configured

• A: Check Blender console for errors

❓ FAQ

Q: Can I undo rename operations? A: Yes, use Ctrl+Z to undo any rename operation

Q: Does it work with thousands of objects? A: Yes, tested with 10,000+ objects with instant results

Q: Can I rename across multiple .blend files? A: Currently works per file. Batch file processing planned for v2.0

Q: Are presets shared between projects? A: Presets are saved per .blend file. Global presets coming in v2.0

Q: Can I use special characters in names? A: Yes, but avoid characters that may cause issues in game engines: /\<>:|?*"

Q: Is there a performance impact? A: No, operations are instant and don't affect viewport performance