Troubleshooting

❌ Problem

I tried downloading UnwrellaConnect from GitHub, but it doesn’t work as shown in the tutorial.

💡 Solution

On GitHub, make sure you are downloading the correct release version of UnwrellaConnect.

✅ Go to the “Releases” section on the right side of the UnwrellaConnect GitHub page.

⬇️ There, download the official Release ZIP package.

⚠️ Do not use the green “Code → Download ZIP” button at the top of the page - this creates a source archive that is not installable in Blender.

❌ Problem

Drag & Drop doesn’t work – UnwrellaConnect won’t install, and it doesn’t appear in the Blender Add-ons list.

💡 Solution

This issue is often caused by using an incorrect or incomplete extension file.

Please ensure you have properly downloaded the official UnwrellaConnect extension from the correct source. Refer to the section above on how to obtain the correct file for installation.

Also, make sure you are using Blender version 4.2 or newer. Older versions are not officially supported and may not recognize the extension.

If the drag & drop method still fails, refer to the manual installation instructions in the Installation section for an alternative method.

❌ Problem

Can’t find the Unwrella tab in the Sidebar? Where is it?

💡 Solution

If you don’t see the Unwrella tab in Blender, there are a few common reasons:

• The addon is not installed or not activated. Please refer to the installation and troubleshooting steps above to ensure UnwrellaConnect is correctly set up.

• You’re in the wrong workspace. The Unwrella panel appears only in the UV Editing workspace.
  ➤ Switch to the “UV Editing” tab in Blender.

• You’re looking in the wrong editor area. In the UV Editing layout, the Unwrella tab is found in the right sidebar of the left (UV/Image Editor) window, not in the 3D Viewport.
  ➤ Press N to toggle the sidebar if it’s hidden.

• No object is selected. The Unwrella panel becomes visible only when an object is selected in the viewport.
  ➤ If nothing is selected, the tab may not appear at all.

❌ Problem

Your browser automatically deletes “Unwrella-IO.exe” after downloading. This issue may arise if your internet browser mistakenly identifies “Unwrella-IO.exe” as a potentially harmful application and blocks it, suspecting it to be a virus.

💡 Solution

Try using a different browser to download “Unwrella-IO.exe”. If the problem persists, consider downloading the file on a different computer where browser security settings do not prevent downloading executable files from the internet.

☝️ Security Measures

Ensure that you download “Unwrella-IO.exe” only from our official website. We cannot take responsibility for any issues arising from downloading the software from unofficial or dubious sources. Please check the Docs Section for Unwrella-IO and Packer-IO for further installation details.

❌ Problem

Unwrap button does nothing and an error appears: “Unwrella-IO or Packer-IO not found!”

💡 Solution

This message means that UnwrellaConnect cannot detect Unwrella-IO or Packer-IO on your system.

Possible reasons include:

• The required app is not installed.
• The app is installed but not properly registered with the system (e.g. due to security restrictions).

There may be an OS-specific issue preventing automatic detection.

✅ Make sure that either Unwrella-IO or Packer-IO is properly installed before using UnwrellaConnect. / If the problem persists, you can manually set the correct path to the application inside the UnwrellaConnect settings.

➡️ See the Installation section for instructions on setting a Custom App Path.

💀 The installation encountered a bad sector on the hard drive, causing damage to the app.
💡 Solution: Please uninstall Unwrella-IO or Packer-IO or UnwrellaConnect and then reinstall it.

☝️ Report

Please provide us with details about your hardware and software, along with a screenshot of the error message, so we can assist you effectively in troubleshooting the issue. Send your reports to info@3d-plugin.com.

❌ Problem

💡 Solution: Crashes during unwrapping or packing are often caused by damaged or problematic geometry. Common issues include:

• Non-manifold edges
• Double faces or overlapping geometry
• Empty faces or zero-area polygons
• Unmerged or loose vertices

To fix this:

• Use Blender’s Clean Up tools: Edit Mode → Mesh → Clean Up

• Merge any loose or duplicate vertices (M → Merge by Distance).

If issues persist, try exporting the mesh as OBJ and re-importing it. The OBJ format strips away non-essential data and can help remove problematic elements.

☝️ Report a Problem Still stuck? We’re here to help! Send your mesh file to us via our Discord channel or email us at info@3d-plugin.com. We’ll take a look and help identify what went wrong.

❌ Problem

Unwrapping takes forever! What’s going on?

💡 Solution: If unwrapping your object takes a very long time, it’s usually due to high mesh complexity. Common causes include:

• The object contains millions of faces.
• You’re using the Organic or Mosaic mode, which require more processing for complex shapes.
• The mesh includes degenerated or unclean geometry, such as non-manifold edges or irregular faces.
• UV packing needs to handle thousands of UV islands, which increases calculation time.

What you can do:

• Try switching to the Hard Surface method.
• If it unwraps successfully, it’s a sign your topology is too complex for Organic or Mosaic modes to solve quickly.
• Use Blender’s Clean Mesh tools to remove double faces, loose vertices, or geometry errors.

Be patient: even in challenging cases, Unwrella will complete the task - and it’s still significantly faster and more accurate than manual unwrapping.

Large UV packing jobs with 10,000+ islands may also take time - but Unwrella is optimized and remains faster than most other solutions on the market.

❌ Problem

Unwrapped UVs look messy or suboptimal – the result doesn’t look right!

☝️ Recommended Action

Unwrella calculates UVs based on geometry and numerical optimization, not aesthetics. This means that:

• In Organic mode, you might see long, stretched UV strips. While they may not look “clean” to the eye, they are technically correct with minimal UV stretching.
• If you’d prefer more visually organized islands, simply add a manual seam where you’d like the UV to split and enable “Preserve Seams” before unwrapping again. This small manual input can drastically improve the layout.

If you’re getting blobby or rounded UV islands, try lowering the Stretch Factor in Organic or Mosaic mode. This helps Unwrella partition the surface more cleanly instead of inflating the shapes into large rounded forms.

Combining automated UV generation with a few guided manual seams gives the best results - both technically and visually.

❓ Question

Can I use UnwrellaConnect for commercial production?

💡 Solution

Yes.
UnwrellaConnect is released under the MIT License, which means you are free to use it for personal, educational, and commercial purposes - including professional production work and final outputs.

✅ Free to download and use

✅ No restrictions on the UV maps or files you generate with it

✅ All results are 100% yours

🔒 Please note: this applies only to the UnwrellaConnect Blender extension. The Unwrella-IO application is a commercial product and is subject to a separate licensing agreement.

If you need help, have questions, or want to report an issue, feel free to reach out:

📧 Email: info@3d-plugin.com

💬 Discord: Join our support channel: https://discord.gg/r8jPCWk

We’re happy to assist you!