Setting Up Assets on iJewel Platform

Before deploying your Wedding Band Builder, you need to configure all the building blocks on the iJewel platform. This page covers each asset type and how to prepare it.

When these assets are ready, Create a Project shows the complete creation flow, the generated folder structure, exact Sync rules, which configuration fields Sync preserves, and which asset catalogs are not currently managed by Mini Editor.

2D Profiles

Profiles are 2D cross section curves that define the shape of the wedding band. The builder extrudes these curves along a circular torus path to generate the 3D ring geometry in real time.

The platform includes several built-in profiles:

Profile	Description
D-Shape	Classic rounded exterior, flat interior
Flat	Flat exterior and interior
Comfort	Rounded on both exterior and interior
Knife Edge	Pointed peak on the exterior
Beveled	Angled flat facets on the exterior
Concave	Inward-curving exterior surface
Round	Fully circular cross section

Custom profiles can be uploaded as .3dm (Rhino) files containing a single closed 2D curve. The curve defines the cross section shape, which the builder then extrudes and scales based on the user's width and thickness settings.

WARNING

The 2D profile curve must be drawn in accurate millimeter dimensions. The engine uses the curve's actual size as the base measurement for width and thickness. If your profile is drawn at the wrong scale, all dimensions, weight calculations, and pricing will be incorrect.

Metals

Metals define the color and material properties of the ring. The default configuration includes:

• White Gold with a cool silver-white tone
• Yellow Gold with a classic warm gold tone
• Rose Gold with a warm pink-gold tone

Each metal is paired with PBR material files (.pmat) that control physical rendering properties such as reflectivity, roughness, and color. Adding a .pmat file to a finish supplies that finish for an existing metal key; it does not create a new metal catalog entry. Custom metals such as Platinum or Palladium currently require a project-configuration/support update because the Wedding Band Sync and Mini Editor do not manage the metal catalog.

Surface Finishes

Surface finishes control the texture and appearance of the ring's exterior. Available finishes include:

Finish	Description
Polished	Mirror-smooth reflective surface
Hammered	Hand-hammered texture with organic dimples
Brush	Fine directional brushing lines
Ice	Crystalline frost-like texture
Nature	Organic bark like texture
Sand	Fine granular matte texture
Linear	Straight-line brushing pattern

Source material files may use descriptive names such as yellow-hammered.pmat. Inside a Drive project's finishes/<Finish>/files/ folder, name the files by their metal keys: yellow.pmat, white.pmat, and rose.pmat. Sync uses the filename without .pmat to match each material to its metal.

Ring Catalog

Pre-modelled rings that customers can add to the compilation next to the parametric wedding bands. The catalog lives in the project manifest under ringCatalog, with one list per ring type:

"ringCatalog": {
  "engagement": [
    {
      "id": "ring-1",
      "name": "Solitaire I",
      "file": "engagement/ring-1.glb",
      "thumbnail": "engagement/ring-1.png"
    }
  ],
  "memoire": [
    {
      "id": "eternity-1",
      "name": "Eternity I",
      "file": "eternity/eternity-1.glb",
      "thumbnail": "eternity/eternity-1.png",
      "scaleAdjust": 1.12
    }
  ]
}

Field	Description
id	Stable identifier, used by the API and for model swapping
name	Display name shown in the picker and on selection
file	The .glb model — absolute URL or relative to assetBaseUrl
thumbnail	Preview image for the picker (optional; a generic glyph is shown without it)
scaleAdjust	Optional multiplier on the automatic size matching. Use when the model's bounding box overstates the hoop — for example, eternity prongs pointing outward

Preparing the models:

• Export as .glb with real-world millimeter dimensions. The builder auto-scales each model so its hoop matches the wedding bands, but sane authoring scale keeps the measurement logs meaningful
• Name the metal material Metal (or any name starting with Metal/Material). Those materials are swapped when the customer picks white, yellow, or rose gold — using the same .pmat files as the wedding bands, so colors always match
• Leave diamond materials unnamed or gem-named and apply the diamond material before export. Every stone mesh must have it — a stone left on the metal material will be recolored with the metal
• Merging all stones into one mesh (or instancing one stone) keeps files small and loading fast

Scene Settings

Scene settings control the 3D preview environment:

• Lighting controls the environment map, light intensity, and shadows
• Camera sets the default viewing angle, zoom level, and orbit constraints
• Ground configures the ground plane appearance and shadow baking
• Post-processing handles tone mapping, bloom, and other visual effects

Scene settings are stored as .vjson files and can be configured through the iJewel platform or uploaded directly.

Pricing Configuration

Pricing parameters determine how ring prices are calculated based on material weight and diamond specifications:

• Metal prices set the price per unit for each metal type (supports grams, ounces, and troy ounces)
• Metal density is the density in g/cm3 for accurate weight calculation (e.g., 15.5 for 18K gold)
• Diamond pricing sets the price per carat for diamond settings
• Markup is a multiplier applied to the subtotal

For programmatic pricing control, see the Pricing API.

Continue on iJewel3D

See Create a Project for step-by-step project creation and profile/finish catalog management. For help preparing custom assets, contact contact@ijewel3d.com.