Overview
Welcome to the Roomle Content Creation documentation. This guide introduces the process and concepts behind creating interactive 3D product configurators using the Roomle Rubens platform.
Asset Types in Roomle
To build a configurator, you will work with three main types of assets:
Component Definitions with RoomleScript (Logic)
JSON-based definitions that describe how a product can be configured.
Contain parameters, rules, and RoomleScript logic to control geometry, materials, and product behavior.
Component definitions are the core of Level 3 configurators, enabling interactive and parametric products.
Textures (Materials):
Images and material definitions that give your models color, surface detail, and realism.
Materials are uploaded and managed in Rubens Admin, and can be mapped to meshes in your components.
Geometry (Meshes):
3D models representing the shape of your products.
Created in 3D modeling tools (like Blender) and imported into the Rubens Admin platform.
For Level 1 (Model Viewer), uploading a mesh is sufficient to visualize a product.
Content Creation Levels
Roomle supports several levels of content creation, each building on the previous:
Level 1: Model Viewer
The simplest form: upload a mesh in Rubens Admin to visualize a static 3D model -> Learn more.
Level 2: Material Configurator
Allows users to change colors or finishes, but does not support advanced logic or parametric geometry.
Upgrade a Level 1 model by adding materials and simple parameters in Rubens Admin -> Learn more
Create Level 2 configurators from scratch -> Learn more.
Level 3: Product Configurator
Combines geometry, textures, and logic in component definitions.
Enables full configurability and feature set of the Roomle Rubens Configurator: users can change dimensions, select options, and see the product update in real time.
Requires writing RoomleScript and structuring component definitions to describe all possible configurations.
Workflow Overview
Create Components:
Set up Visual Studio Code with the Roomle Component Tool Extension to write component definitions -> Learn more and learn the features of the extension -> Learn more.
Create component definitions that reference your meshes and materials -> Learn more.
Add parameters and RoomleScript logic to enable configuration -> Learn more.
Link the meshes with materials from Rubens Admin to your component definitions -> Learn more or create geometry from primitives, prisms and CSG operations -> Learn more
Set Up Materials:
Create and upload material definitions and textures in Rubens Admin -> Learn more.
Prepare 3D Models:
Get the Roomle Blender Addon -> Learn more
Model your product in a 3D tool and export it in a supported format using our Roomle Blender plugin -> Learn more.
Import the meshes into Rubens Admin -> Learn more.
Integration
Once the content is ready, the next step is to integrate it into your website or application -> Learn more about integration.
Last updated