Skip to main content
Version: 1.0.0

Spaarkly Scripts — Overview

Author: Vincenzo Mossuto Creation Date: 30/09/2025
Last Reviewer: Sara Altomare/Rossana Mazza

This page provides a high-level overview of the Spaarkly Scripts add-on for Blender,
summarizing the available operators across the different sections of the workflow.
The goal is to give artists and developers a single reference point to understand
which tools are available, when to use them, and how they fit together in the eyewear pipeline.

Setup​

Scripts in this section are designed to prepare newly imported eyewear models for production use.
They clean the scene, align the geometry, and ensure that assets are correctly oriented for the pipeline.

  • New Model Setup → Cleans up empties and duplicates, resets origins, applies transforms, rotates the model correctly, and aligns it to Blender’s axes.

Naming​

The Naming Script is a tool used to correctly and consistently rename the materials and components that make up the 3D model of the eyewear. The script is divided into two main sections:

  • Component Renamer → allows you to rename the different components of the asset, ensuring that each element follows the correct and standardized naming convention.

  • Material Renamer → allows you to rename the materials associated with the various parts of the eyewear.

Modeling​

Modeling scripts provide utilities that support the geometry creation and refinement process,
as well as final adjustments needed before moving on to shading, rigging, or export.

  • Lens Base — Create a UV sphere perfectly fitted to four selected vertices, used as the base for lens modeling.
  • Sharp Select — Automatically select all sharp edges in the active mesh for quick refinement and creasing.
  • Standard Mirror — Add a standardized X-axis mirror modifier with consistent settings.
  • Final Setup FULL — Align and position the complete eyewear model for accurate export and 3D visualization.
  • Final Setup CUT — Prepare the model for VTO export with several operators:
    • Set Contact Point — Define the nosepad origin or vertex-based contact reference.
    • Temples Rotation — Open temple arms by a specified angle around their hinge screws.
    • Rotate Temples — Adjust temples’ orientation for cutting alignment.
    • Setup CUT — Center, align, and apply Boolean cutters for final VTO-ready assets.

Rigging & Animation​

This section covers the scripts that generate and prepare armatures for animation or deformation.
They automate rigging steps that would otherwise be repetitive and error-prone.

  • Standard-Armature tool → Builds an armature with one bone per selected mesh, parenting meshes with matching vertex groups.
  • Flexi-Armature tool → Creates a custom flexible armature for eyewear with smooth gradient weights,
    automatically setting up temples, tips, hinges, and frame parts for deformation.

Shading​

Shading scripts focus on material validation and color categorization,
ensuring that materials are consistent with the Spaarkly pipeline conventions.

  • Check material tool → Checks selected materials to verify naming consistency and validates Principled BSDF parameters,
    including sheen weight for VTO models.
  • HEX Color Categorizer → Converts a material’s HEX color into a predefined color family using HSV thresholds.

Export​

Export scripts generate lightweight, reusable .blend asset files for components and materials.
They enforce naming conventions, remove unnecessary data, and generate asset previews for the library.

  • Export asset → Exports selected objects (e.g., hinges, screws, frame parts) into a clean .blend file,
    generating previews and purging orphan data.
  • Export material → Exports the active material of the selected object, marks it as an asset, assigns it to a catalog,
    and saves it as a .blend file ready for reuse.