SketchUp Plugin Tutorial
How to export Dynamic Components for the Konfiguruj configurator
The Konfiguruj Export plugin exports Dynamic Component parameters from SketchUp to a zip file (model.glb, parameters.json, materials) that you can upload to the configurator. Your model must use Dynamic Components with configurable parameters.
Installation
- Download the .rbz file using the button above.
- In SketchUp: Window → Extension Manager → Install Extension.
- Select konfiguruj_export.rbz. The plugin appears under Plugins → Konfiguruj Export.
Supported entities
The plugin reads Dynamic Component attributes from:
- Groups – with Dynamic Component attributes in the dynamic_attributes dictionary
- Component instances – with Dynamic Component attributes
Parameters
Supported parameter types:
- Dimensions: LenX, LenY, LenZ, width, height, depth (and Czech: sirka, vyska, hloubka, prumer)
- Materials: color, barva, material
- Options: avariant, variant, typ
Formula syntax
- Parent!param – references a parameter from the parent group/component
- ComponentName!param – references a parameter from another component (e.g. stul!leny)
Effect types
- scale – scale mesh on axis (x, y, z, xz)
- position – position mesh from formula (e.g. from LenY)
- material – apply material/color to mesh
Export workflow
- Open a SketchUp model with Dynamic Components.
- Select the root group or component that contains your parameters.
- Plugins → Konfiguruj Export → Export for Konfiguruj.
- Choose save location (default: modelname_configurator.zip).
- Upload the zip to the configurator via Import from SketchUp.
Troubleshooting
If the plugin does not export anything:
- Run Plugins → Konfiguruj Export → Debug and check the Ruby Console (Window → Ruby Console) for entities and parameters found.
- Ensure the root group/component with parameters is selected before running Export.
Materials
Only textured materials are exported as PNG. Color-only materials are skipped; the configurator supports textures. Dimension parameters are exported in cm (SketchUp returns inches; the plugin converts).
