HOW TO SET-UP ADDON?

If you are tired of clicking through endless tabs, fighting with messy imported assets, and manually organizing your outliner, it is time to reclaim your creative time. I am incredibly excited to introduce Magic Menu, a powerhouse add-on that brings a massive suite of object, material, scene, and AI tools straight to your cursor.

Triggered by a single hotkey (the ` backtick by default) and built like Blender’s native Shift+A popup, Magic Menu is designed to keep you in the zone. Whether you are running Blender 3.6 LTS or the cutting-edge 5.0, this add-on is fully compatible and ready to streamline your workflow.

Here is a deep dive into what Magic Menu can do for your art.

The Core Features

The menu is cleanly divided into categories so you can always find exactly what you need in a fraction of a second.

1. Object & Organization Tools

Say goodbye to cluttered scenes and annoying multi-user data errors.

• Rename by Viewport: Instantly rename visible objects based on their polycount and type. Your assets will automatically become clean, readable tags like Small_Mesh_1 (under 2k faces) or Large_Mesh_1 (over 20k faces).

• Auto Sort Collections: Automatically structure your entire project. This tool sorts everything into a dedicated collection tree based on object type and mesh size.

• Merge Objects .001: Instantly clean up duplicates. It detects meshes sharing suffixes like .001 or .002, makes them single-user to prevent breaking other data, and merges them into one unified object.

• Apply Rotation & Scale: Fixes the dreaded "multi-user data" error automatically by duplicating shared mesh data before applying transforms across all selected objects.

2. Materials & Viewport Enhancements

Keep your viewport focused and your file sizes incredibly light.

• Merge Materials .001: The ultimate imported-asset cleaner. It takes duplicate materials (like metal.001 and metal.002), consolidates them back to the original base material, updates every slot, and wipes out the junk.

• Isolation Ghosting: Gain perfect spatial awareness. Instead of hiding the rest of your scene, this turns everything unselected into a transparent, unclickable wireframe "ghost" so you can model in context.

• Camera Bookmarks: Save up to 5 viewport angles directly to your hotkeys to jump between crucial perspectives without cluttering your scene with actual camera objects.

• Texture Bridge: Instantly opens the images of your active material slot in the Image Editor, prioritizing what you are currently working on.

• Auto-Cleanup: Your scene's dedicated janitor. Safely merges duplicate materials, purges unused images/lights/curves, and wipes out stray .00x meshes.

3. Advanced Scene Tools

These are the heavy hitters designed to save you hours of tedious manual labor.

• Orphan Purger Pro: A deep-cleaning system that goes beyond Blender's default tool. It strips the "fake user" flag from bloated data-blocks and recursively purges them.

• Instance Converter: Slashes memory usage by scanning for meshes with identical geometry and converting them into linked instances (like Alt+D).

• Physics Settle: Stop placing objects by hand. Select your falling items, pick your floor last, and let real-time rigid body physics drop them naturally into place.

• Randomize Transform Plus: Introduce controlled chaos with a live adjustment panel for location, rotation, and scale.

• Auto UV: Get clean unwraps instantly. It marks seams on edges sharper than 60° and applies a finely tuned Smart UV Project.

• Focus Zoom: A flawless viewport framing tool that works perfectly even when triggered from the popup menu.

Spotlight: Blend Objects

This is our largest scene tool, designed to seamlessly merge intersecting objects. Simply select the objects, pick your target last, and choose your method:

• Normals Only (Shading): Keeps your geometry untouched. It uses a Data Transfer modifier to copy custom normals, making the seam disappear visually. Perfect for rocks on terrain or kitbashing.

• Real Geometry (Apply): Destructively boolean-unites the objects and automatically builds a rounded polygonal fillet along the exact intersection seam.

• Real Geometry (Live Modifiers): A non-destructive workflow using Boolean Union and angle-limited Bevel modifiers. You can still move the source objects while the blend updates live.

• Seamless Remesh (Organic): The deepest blend available. It rebuilds the entire surface with a voxel remesh into one continuous quad-skin, removing all traces of the intersection. Ideal for sculpting bases!

(Note: Every tool comes with a live "Adjust Last Operation" panel in the bottom-left corner of your viewport, letting you tweak settings like fillet radius, voxel size, and curvature live!)

Premium AI Features

For those who want to unlock the absolute bleeding edge of Blender automation, the Premium version integrates Google's Gemini AI directly into your workflow.

• AI Command Console: Tell Blender what to do in plain English. Type "Scatter these rocks randomly on the ground," and the AI will write and execute the Python code instantly.

• Texture-to-Material: Describe a material like "rusty sci-fi metal with scratches," and the AI will build a full procedural node tree and assign it to your selection. It even auto-fixes its own code if it encounters an error!

• Smart Namer: The AI analyzes your mesh statistics (polycount, proportions, modifiers) and renames objects to professional industry standards.

• Smart Sorter: Let an AI environment artist organize your outliner. It analyzes every object and sorts them into a highly logical, customized collection hierarchy.

How to Get Started

Installation is as simple as it gets:

1. Go to Edit > Preferences > Add-ons > Install…

2. Select your downloaded magic_menu_v1.3.0.zip file.

3. Enable the add-on.

4. Press ` (backtick) in the 3D viewport to open the menu!

Unlocking Premium & Setting up the AI

If you have the Premium version, unlocking it and setting up your free API key is incredibly quick:

1. Head over to aistudio.google.com/apikey and sign in with your Google account.

2. Click Create API key.

3. Copy your unique key.

4. In Blender, go to your Magic Menu add-on preferences, expand the panel, and paste the key into the Gemini API Key field.

5. Enter the Premium unlock password: MagicPro2026 and hit Unlock.

Which AI Model should you choose?

Safety Note: All AI-generated code is safely logged in the MagicMenu_AI_Log text block for your review, and every destructive tool in this add-on can be undone with a simple Ctrl+Z.

Ready to optimize your workflow and let the add-on do the heavy lifting? Grab Magic Menu today, and let’s make Blender more user-friendly together. Happy blending!