⚙️ Detailed Usage

Preferences Panel

• Mounted .blend Files: Manage your search folders and .blend files, and see what assets are added.
• Update Catalogs: Update your .blend files by using the  Scan operator.
• Tags: Assign tags for .blend's, folders, objects and collections to make searching easier.

Side-Panel

• Switch between the  Search,  .blend,  Folder, and  Tools view mode
  • You can set the import options globally in the  Tools view, or you can set them per-folder or per-blend through the   gear icons.
• Browse through the list of assets and spawn them.
• RED-highlighted  .blend Multi-tool : An operator with the   icon exists to reload, open, or re-scan the active .blend file.
  • Hold  CTRL to reload the .blend file as a library
  • Hold  SHIFT to open the .blend file in a new instance of Blender
  • Hold  ALTto re-scan the .blend file in OptiPloy

Localization Options

In the  Tools view mode, you may choose to localize any of the following data types:

bpy.types.Collection
bpy.types.Object
bpy.types.Mesh
bpy.types.Material
bpy.types.SurfaceCurve
bpy.types.Light
bpy.types.Curve
bpy.types.GreasePencil
bpy.types.MetaBall
bpy.types.TextCurve
bpy.types.Volume
bpy.types.Armature
bpy.types.Camera
bpy.types.NodeTree
bpy.types.Image

Setting these options affects imports as a whole, but localization options can also be set per-blend or per-folder.

Asset Browser Integration

OptiPloy has an operator built-in to optimize Collections or Objects linked through the Asset Browser.

• Viewport / Operator Search Menu
  Search for  Optimize with OptiPloy and execute the operator
• Outliner
  Select the IDs you wish to localize (collections/objects), right click, and select  Optimize with OptiPloy

Again, for this to work, the assets need to be  linked through the asset browser, not appended.

🖥️ For Developers

Scripting Hook

OptiPloy automatically executes any text block associated with an import. You can access the data of the imported object through bpy.context.scene['new_spawn'] to perform further adjustments or optimizations.

Using Key Modifiers

Incorporate key modifiers ( CTRL,  SHIFT,  ALT) into your scripts by accessing

bpy.context.scene['key_ctrl']
bpy.context.scene['key_shift']
bpy.context.scene['key_alt']

Full Features

• Hybrid Importing
  Choose from 15 data types to localize or to leave linked to the source file. Object and Collection types are enabled by default.
• Fine‑Grained Control
  Save importing preferences globally, per-folder, or per-blend.
• One‑Click Workflow
  Spawn assets directly from the side‑panel without manual linking/appending.
• No Duplicating Boneshapes
  Boneshapes do  not duplicate, not even if you choose to localize armatures.
• Auto-Execute Scripts & Scriptable Hook
  OptiPloy will automatically execute text data blocks associated with your import. This ensures, for example, that Rigify UI scripts work right off the bat.
• .blend File Multi-tool
  Use CTRL, SHIFT, or ALT on the red Blender icon to reload, open, or re-scan the selected .blend file
• Full Driver Functionality
  Despite all the localizing that takes place, drivers never lose their targets as they shift from linked to localized.
• Hierarchal Localizing
  OptiPloy recursively builds a hierarchy of levels that IDs are referenced at, and localizes going down this hierarchy. This ensures no breakage when localizing.
• Automatic Library Overrides
  Unlocalized IDs are given automatic library overrides to make some wiggle room for what can be edited.
  To edit custom properties, make sure  Library Overridable is enabled in its options.
• Fun for Coders
  During the script execution stage at the end of the importing process, you can access the new import through  bpy.context.scene['new_spawn'], letting you do further adjustments after it has been deployed.
  Scripters can incorporate  CTRL,  SHIFT, and  ALT into their scripts by using:
  
  

  bpy.context.scene['key_ctrl']
  bpy.context.scene['key_shift']
  bpy.context.scene['key_alt']

  Attach text blocks to an import by assigning them as a custom property to any ID associated with the import.
• Asset Library Integration
  An operator named  Optimize with OptiPloy exists to optimize assets linked through the asset browser.
  Viewport: Object → Optimize with OptiPloy
  Outliner: Right-click → Optimize with OptiPloy
• Thumbnail Previews
  Selected assets will have their previews shown in a little window
• Search Menu
  Dedicated menu to search through every mounted .blend file
• Tags
  Add tags to .blend files, folders, objects, and collections for organization!
• Drag 'n' Drop
  Drag your assets and orientate them onto geometry for super easy placement, exactly like the Asset Browser. Plus, two extra orientation modes!