Professional mesh cleanup toolkit for Blender 4.2+
Created by Nandur Studio (Nandang Duryat) © 2025
NS Toolkit - Mesh Cleanup Pro is a powerful Blender add-on designed to streamline your mesh workflow with visual topology analysis and one-click automation. Perfect for game developers, 3D artists, and anyone working with imported meshes that need quick cleanup and optimization.
- Real-Time Topology Visualization - Live highlighting in Edit & Object modes with smart color coding
- Converts Triangles to Quads - Automatically optimizes triangle meshes into quad-based topology
- Merges Vertices by Distance - Removes duplicate vertices and cleans up overlapping geometry
- Recalculates Normals Outside - Fixes inverted faces and ensures consistent normal direction
- Resets Custom Normal Vectors - Clears any custom split normals and returns to default calculations
Scene-Wide Analysis + Real-Time Updates! See topology changes instantly as you edit, with priority highlighting for N-gons and live updates in both Object and Edit modes.
- Smart Color System: 🔵 Blue=Has N-gons (priority), 🔴 Red=Triangle-dominant, 🟢 Green=Quad-dominant
- Scene-Wide Analysis: Highlights ALL objects in scene simultaneously
- Live Edit Mode Updates: Instant color changes as you modify mesh topology
- Performance Optimized: Dual handler system with automatic cleanup
- Visual Feedback: See problematic topology before cleanup
- Professional Workflow: Analyze then optimize with confidence
- Tris to Quads Conversion: Smart algorithm converts triangular faces to quads where possible
- Merge by Distance: Configurable threshold for removing duplicate vertices (default: 0.0001)
- Normal Recalculation: Ensures all faces point outward for proper lighting and rendering
- Normal Vector Reset: Clears custom split normals for clean, default normal calculations
- Sidebar Panel: Easy access via N-Panel in 3D Viewport under "NS Toolkit" tab
- Object Menu Integration: Available in Object > Convert menu
- Keyboard Shortcut: Quick access via
Ctrl + Alt + J
- Adjustable Merge Distance: Fine-tune vertex merging threshold for your specific needs
- Batch Processing: Process multiple selected objects simultaneously
- Undo Support: Full integration with Blender's undo system
- Clean, modern interface design
- Visual feedback with success notifications
- Branded NS Toolkit experience
- Blender Version: 4.2.0 or higher
- Operating System: Windows, macOS, Linux
- Memory: Minimal requirements (processes mesh data in memory)
- Download the
tris_to_quads_merge_addon.zipfile - Open Blender
- Go to
Edit > Preferences > Add-ons - Click
Install...button - Navigate to the downloaded ZIP file and select it
- Enable the add-on by checking the checkbox next to "NS Toolkit - Mesh Cleanup Pro"
- Extract the ZIP file to your Blender add-ons directory:
- Windows:
%APPDATA%\Blender Foundation\Blender\[VERSION]\scripts\addons\ - macOS:
~/Library/Application Support/Blender/[VERSION]/scripts/addons/ - Linux:
~/.config/blender/[VERSION]/scripts/addons/
- Windows:
- Restart Blender
- Enable the add-on in Preferences > Add-ons
- Select one or more mesh objects in your scene
- Access NS Toolkit via any of these methods:
- Sidebar: Press
Nto open sidebar, go to "NS Toolkit" tab - Menu: Object > Convert > "Tris to Quads + Merge + Normals"
- Shortcut:
Ctrl + Alt + J
- Sidebar: Press
- Adjust merge distance if needed (default: 0.0001 works for most cases)
- Click the button and watch the magic happen!
- Select Target Meshes: Choose the objects you want to clean up
- Configure Settings: Adjust merge distance based on your mesh scale and requirements
- Execute Operation: Run the cleanup process
- Review Results: Check the console message for processing summary
- Backup Your Work: Always save before running batch operations
- Test Settings: Try different merge distances on a copy first
- Check Results: Verify normals and topology after processing
- Iterative Workflow: Can be run multiple times for complex meshes
- Range: 0.0 to 1.0
- Default: 0.0001
- Purpose: Determines how close vertices need to be for merging
- Recommendations:
- Small objects/high detail: 0.0001 - 0.001
- Medium objects: 0.001 - 0.01
- Large objects/rough meshes: 0.01 - 0.1
- Clean up imported CAD models
- Optimize mesh topology for real-time rendering
- Prepare assets for game engines
- Fix mesh issues before slicing
- Ensure manifold geometry
- Optimize file sizes
- Prepare meshes for subdivision surface
- Fix imported model issues
- Standardize mesh topology
- Clean up imported BIM models
- Optimize complex architectural meshes
- Prepare models for rendering
Q: The add-on doesn't appear after installation A: Make sure you've enabled it in Preferences > Add-ons. Search for "NS Toolkit" if the list is long.
Q: Getting errors when running the tool A: Ensure you have mesh objects selected and you're in Object mode before running the operation.
Q: Merge distance seems too aggressive A: Try reducing the merge distance value. Start with 0.0001 and adjust as needed.
Q: Some faces are still triangles after conversion A: This is normal. The algorithm only converts triangles to quads where it makes topological sense.
Q: Normals are still incorrect after processing A: Some complex meshes might need manual normal correction. Try running the tool multiple times or use Blender's manual normal tools.
- Process objects in smaller batches for very large scenes
- Consider the merge distance relative to your object scale
- Use on duplicate objects first to test settings
- Documentation: This README file
- Blender Community: Post questions in Blender forums with "NS Toolkit" tag
- Bug Reports: Include Blender version, OS, and steps to reproduce
NS Toolkit is created by Nandur Studio (Nandang Duryat) © 2025
- Passionate Blender developer focused on workflow optimization
- Committed to creating tools that save time and improve productivity
- Active in the Blender community since 2020+
- ✅ Personal and commercial use allowed
- ✅ Use in client projects
- ✅ Modify for personal use
- ❌ Redistribute or resell the add-on
- ❌ Remove copyright notices
This add-on is provided "as is" without warranty. Always backup your work before using any automation tools.
- ✅ Real-Time Topology Visualization: Scene-wide highlighting with live Edit mode updates
- ✅ Smart Color Priority System: Blue=N-gons, Red=Triangle-dominant, Green=Quad-dominant
- ✅ Professional Mesh Cleanup Toolkit: Topology Highlight + Tris to Quads + Merge + Normals + Reset Vectors
- ✅ Advanced Performance: Dual handler system with optimized real-time updates
- ✅ Professional UI: Dynamic version display, branded experience, comprehensive feedback
- ✅ Commercial License: Full commercial usage rights included
- ✅ Platform Compatibility: Blender 4.2+ with extensive testing
- ✅ Complete Documentation: Installation guides, usage examples, troubleshooting
Thank you for choosing NS Toolkit! Your support helps us continue developing quality tools for the Blender community.
Happy Blending! 🚀
NS Toolkit © 2025 | Created by Nandur Studio