Ultimate Asset Organizer – Materials
Documentation & usage guide for Blender 4.5+.
Meet the add-on
Welcome to Ultimate Asset Organizer – Materials for Blender 4.5+.
If you have texture packs sitting on disk and want them turned into usable Blender materials, this add-on is made for that.
This add-on helps you:
- Create materials from texture folders
- Mark materials as Assets for Blender’s Asset Browser
- Generate previews so you can browse visually
- Use proxy textures during preview generation to keep memory use under control
The goal is simple:
Spend less time wiring materials and more time building your scenes.
Why you might want it
Use this add-on to build a reusable material library from your texture folders. Once materials are marked as assets, you can browse them in the Asset Browser and drag and drop them into any file.
- Turn texture collections into a reusable material library
- Drag and drop materials from the Asset Browser into any scene
- Keep library files cleaner (especially after generating previews)
- Build a library once and reuse it across projects
It’s a good fit if you:
- Download a lot of PBR texture packs
- Work on environments, props, or look development
- Want a shared material library for a team
Key features
Here’s what it can do:
Folder to Material Conversion (with flexible grouping)
- Choose a folder that contains your texture sets.
- With Group texture maps into materials ON (recommended), it creates one material per folder.
- With that option OFF, it creates one material per texture map file (useful for testing or special cases).
- If you enable UDIM Texture Maps, it supports UDIM sets.
Smart Texture Detection
- Looks for common map types (color, roughness, metallic, normal, AO, opacity, height/displacement, and more when available).
- Builds a solid starting material you can adjust later.
Heuristic Smart Search
- Helpful when texture packs include extra folders (previews, renders, thumbnails, and so on).
- Focuses on the actual textures so you get fewer duplicates.
Asset Browser Integration
- Marks your materials as Assets, so they show up in Blender’s Asset Browser.
- Makes reusing materials across projects easy: browse in the Asset Browser, then drag and drop.
Preview Generation (Thumbnails)
- Generates previews for asset materials that don’t have one yet.
- Uses your chosen Proxy Folder and Proxy Size to reduce memory use while generating previews.
- You can cancel safely if you need to stop.
Cleanup Tools
- Helps remove unused data from the file when you’re done.
- Can remove temporary proxy folders created during preview generation.
How it works
Typical workflow:
- Step 1 — Setup
- Choose your Source Folder (where your texture sets live).
- Optionally enable Search Sub-folders for nested libraries.
- Enable UDIM Texture Maps only if your textures use UDIM tiles.
- Pick a Proxy Folder and Proxy Size for preview generation.
- Step 2 — Create Materials
- The add-on scans folders and builds materials based on your settings.
- Depending on your grouping choice, it creates one material per folder (recommended) or one per texture map file.
- Step 3 — Create Asset Library
- Marks materials as Assets so they appear in the Asset Browser.
- Step 4 — Generate Asset Previews
- Generates thumbnails for Asset materials that need them.
- Important: Step 4 does not save your file automatically — save your .blend when you’re happy with the results.
- Clean up (optional)
- Purge unused data and delete temporary proxy folders after big preview jobs.
After that, you can browse your materials in the Asset Browser and reuse them whenever you need.
Quick start
1. Install the add-on
- Download the add-on file.
- In Blender, Drag & Drop the .zip file inside the Viewport.
- Click Save Preferences so it stays enabled next time.
2. Find the add-on panel
- Open the 3D Viewport.
- Press N to open the side panel (if it’s not already open).
- Look for the tab: UAO — Materials.
3. (Recommended) Start a dedicated library file
- Open a fresh .blend, then use Save Library As to create a dedicated “Materials Library” file.
- This keeps your library clean and avoids mixing in unrelated materials from other scenes.
4. Step 1 — Point it to your textures
- Choose your Source Folder (your library root).
- Enable Search Sub-folders if your packs are nested.
- Enable Heuristic Smart Search for real-world folder structures (recommended).
- Enable UDIM Texture Maps only if your textures use UDIM tiles.
5. Step 2 — Create your materials
- Click Step 2 — Create Materials.
- Most users should keep Group texture maps into materials ON for usable “ready-to-go” materials.
6. Step 3 — Turn them into assets
- Click Step 3 — Create Asset Library.
- Your materials are now flagged as Assets and ready for the Asset Browser.
7. Step 4 — Generate previews (recommended)
- Pick a Proxy Folder and Proxy Size (lower = faster/lighter, higher = sharper).
- Click Step 4 — Generate Asset Previews.
- You can cancel safely if needed. Completed previews stay.
When you’re happy with the results, save your library .blend.
Examples and ideas
Not sure where it fits in your workflow? Here are a few common ways to use it:
Building a personal library from downloaded textures
- Point the add-on at your downloaded packs.
- Create materials, mark them as assets, and generate previews.
- Save one clean library file you can reuse across projects.
Creating a studio or team library
- Store one shared library .blend in a shared location.
- Everyone points Blender’s Asset Libraries to the same folder and stays consistent.
Cleaning up old projects
- Start a fresh file and rebuild materials from the original textures.
- Reuse a clean library instead of rebuilding materials in every scene.
Environment building
- Create a library of wood, metal, concrete, stone, ground, etc.
- Drag and drop materials while blocking out environments or props.
Tips for best results
A few small habits make a big difference, especially when you’re building a large library.
Keep folders clean (when you can)
- One material set per folder is ideal.
- Avoid mixing unrelated images in the same folder.
Use grouping unless you have a reason not to
- Keep Group texture maps into materials ON for the best ready to use result.
- Turn it OFF only when you intentionally want one map per material.
Use UDIM mode only when needed
- If your set is UDIM based, enable UDIM Texture Maps.
- If you don’t use UDIMs, leave it off for a simpler workflow.
Choose proxy size wisely
- Lower proxy sizes are faster and easier on your computer.
- Higher proxy sizes look nicer but take longer.
- If previews feel slow, lower the proxy size or process fewer materials at a time.
After big preview jobs, run cleanup
- Use the cleanup action to remove unused data and delete temporary proxy folders.
- It’s a good habit for keeping your library file responsive.
FAQ
Do I need to know anything about shaders or nodes to use this?
Not really. The add-on is designed so you point it at your textures and it builds solid materials for you. You can still tweak things later if you want, but it’s not required.
My folders are a bit messy. Will it still work?
It works best when each material has its own folder. If your packs include extra helper folders (like previews or renders), enabling Heuristic Smart Search usually helps.
Some materials didn’t get created. What happened?
Usually the folder didn’t contain usable maps, or the images were too mixed to form a clean material set. Try cleaning the structure, or run a smaller batch to verify results.
Step 4 didn’t generate anything — why?
Step 4 generates previews for Asset materials. Make sure you ran Step 3 — Create Asset Library first (or that your materials are already marked as assets).
Previews are taking a long time. What can I do?
Try these:
- Lower the Proxy Size.
- Run fewer materials at once.
- Close other heavy programs while previews are generating.
Will this break my existing projects?
No. The add-on only affects the file you run it in. Still, for large library builds, it’s a good idea to work in a dedicated library .blend and keep backups.
Can I stop a job if it’s taking too long?
Yes. You can cancel safely. Completed materials and previews will stay; the add-on simply stops working on the rest.
Need help?
If something isn’t working or you have a question, get in touch. It really helps if you include:
For the fastest support, include:
- Your Blender version
- Your operating system (Windows, macOS, or Linux)
- Rough library size (number of folders/materials)
- Which step you were running (Step 2 / Step 3 / Step 4)
Report a bug or issue
- Describe what you were doing when the problem happened.
- If possible, mention any error messages you saw.
Request features
- Have an idea that would make the add-on even better? Let us know.
- We use real user feedback to decide what to improve next.