Smart Scene Organizer - Official Documentation

Version: 1.0 | Author: Zibad Mend | Support: Blender 4.x & 5.0+

1. Introduction

Welcome to Smart Scene Organizer! This add-on uses a sophisticated hybrid Artificial Intelligence engine (combining Geometric Decision Trees, Poly-density mapping, and Proximity Context) to automatically analyze, rename, organize, and prep your 3D scenes.

2. Installation

1. Download the provided .zip file.
2. In Blender, navigate to Edit > Preferences > Add-ons (or Extensions in Blender 5.0).
3. Click on Install (or Install from Disk), and select the .zip file.
4. Enable the add-on by checking the box.
5. In the 3D Viewport, press N to open the right sidebar and look for the Scene Organizer tab.

3. User Interface Overview

The add-on is divided into three main workspaces accessible via the top tab menu:

4. Core Tools & Operations

AI Context Analysis

• Analyze Selected / Analyze All: The engine will deeply scan objects (penetrating Empty groups and Collection Instances). It identifies what an object is based on its name, dimensions, poly-count, and what objects are around it.
• Manual Override: Select an item from the list, change its Category, Sub-type, or Material manually, and click Apply Override.

Pipeline & Batch Renamer

• Auto-Rename by AI: Automatically renames all analyzed objects in the scene based on their detected type (e.g., changes Cube.001 to Dining_Chair_01).
• Sync Data Names: Copies the Object name to the Mesh Data name. Essential for game engine exports (Unreal/Unity). (Safely skips Read-Only data in Blender 5.0+).
• Game-Ready (SM_): Adds the SM_ prefix to objects and the M_ prefix to materials.
• Hierarchy Rename: Select a parent object (e.g., "Car") and it will rename all its children sequentially (e.g., Car_Child_01).
• Auto-Organize Collections: The ultimate cleanup tool. It creates standardized Collections (like Col_Furniture) and moves analyzed objects into them automatically.

5. How to Train the AI

If the AI fails to recognize a specific custom prop (e.g., a "Sci-Fi Crate"), you can teach it:

1. Go to the 🧠 AI Training tab.
2. Set the Name (e.g., Sci-Fi Crate) and Category (e.g., Props).
3. Add Keywords separated by commas (e.g., crate, scifi, box).
4. Set the Minimum and Maximum tolerances for Height (Z), Length (X/Y Max), and Width (X/Y Min).
5. Select the expected Poly Density (Low, High, or Any).
6. Click Save / Update Profile. The AI will now recognize these objects forever!

6. Reports & Export

After your scene is analyzed and materials are assigned, you can generate a Bill of Quantities (BOQ):

• Console Report: Prints the total estimated cost in the Blender System Console.
• Export CSV: Generates a Project_Report.csv file in the same folder as your .blend file, containing detailed dimensions, categories, materials, and individual costs.