Boop

Boop Documentation

Troubleshooting

Common issues, platform notes, and frequently asked questions about Boop.

Common Issues

"No mesh selected" error

Boop requires at least one mesh object to be selected. Make sure you're selecting the mesh object itself, not an armature, curve, or empty. You can check the object type in the Properties panel.

Pre-processing takes a long time

Large meshes (500K+ faces) may take a few seconds to analyse. If pre-processing seems stuck:

  • Check the Blender system console for progress messages (Window → Toggle System Console on Windows)
  • Ensure you have enough available RAM
  • Try processing one object at a time instead of a full hierarchy

UV distortion is too high

If the simplified mesh shows noticeable texture warping:

  • Lower the target reduction (e.g. 70% instead of 50%)
  • Reduce the UV distortion threshold in the settings to make Boop more conservative
  • Check that the original mesh has clean, non-overlapping UVs

Addon not appearing after install

  1. Confirm you installed the .zip file directly (not an extracted folder)
  2. Check that the addon is enabled in Edit → Preferences → Add-ons
  3. Search for "Boop" in the addon search bar
  4. Restart Blender if needed

Platform Notes

macOS

  • On Apple Silicon Macs, Boop runs natively — no Rosetta required
  • If macOS blocks the addon, go to System Settings → Privacy & Security and allow it

Linux

  • Boop requires glibc 2.31 or newer
  • If you see shared library errors, check your distribution's glibc version with ldd --version

FAQ

Can I use Boop on multiple machines?

Your license is valid for one machine at a time. Deactivate on your current machine before activating on another. You can do this from the License section in the Boop panel.

What mesh types are supported?

Boop works with standard polygon meshes (tris and quads). It does not currently support NURBS surfaces, curves, or metaballs — convert these to mesh first.

Does Boop work with modifiers?

Boop operates on the evaluated mesh. Apply any modifiers you want included in the simplification before running Boop. Non-destructive modifier stacks are preserved on the original object.

How do I report a bug?

Email hello@mopokestudio.com with:

  • Your Blender version and OS
  • Steps to reproduce the issue
  • The Blender system console output (if relevant)