[Ken] Design Version Mesh

Design Version Meshes represent specific variants or configurations of a Design Family. Each mesh represents a different size, style, or configuration option within the same design family (e.g., 3-seater sofa, 2-seater sofa, ottoman).

What is a Design Version Mesh?

A Design Version Mesh represents a specific variant or configuration within a Design Family. It enables:

• Product Variants - Multiple size/style options within the same design family
• Asset Management - Organizing 3D variants with metadata and thumbnails
• Version Control - Different mesh configurations per design version
• Catalog Integration - Controlling visibility in product catalogs
• Localization - Supporting multiple languages for variant names

Hierarchy Relationship

Design Family → Design Version → Design Version Mesh

Example: Danish Sofa Collection

Design Family: "DANISH SOFA"
├── Design Version: "v2.0"
    ├── Design Version Mesh: "3 Seater 180cm" (mesh_name: MS-00003100)
    ├── Design Version Mesh: "2 Seater 160cm" (mesh_name: MS-00003101)
    └── Design Version Mesh: "Ottoman" (mesh_name: MS-00003102)

Each Design Version Mesh represents a complete furniture piece variant:

• 3 Seater: Full-size sofa for three people
• 2 Seater: Smaller loveseat configuration
• Ottoman: Matching footstool/pouf

Attributes & Metadata

Design Version Meshes contain metadata that links design versions to actual 3D geometry, manages asset delivery, and controls catalog visibility.

Core Identity

Basic identifiers and naming:

Example:

sfid: "a50OQ000001R92PYAS"
name: "0.0"
mesh_name: "MS-xxxxxxxx"
mesh_label_name: "3 Seater"

Relationships

Links to parent entities and actual mesh assets:

Data Structure:

Design Version Mesh (a50OQ000001R92PYAS)
├── design_family_sfid: a4fOQ000000g8yrYAA
│   └── Points to: MALAGA Design Family
│
├── mesh_sfid: a60OQ000001S03QYAT
│   └── Points to: Actual 3D mesh geometry
│
└── design_mesh_junction_sfid: a70OQ000001T14RZAU
    └── Points to: Junction table between Design Version and Mesh

Purpose of Junction:

The design_mesh_junction_sfid enables:

• Many-to-many relationships between designs and meshes
• Shared mesh assets across multiple design versions
• Efficient asset reuse and storage

Asset Properties

Information about the 3D asset files and loading optimization:

Asset Loading Flow:

1. Thumbnail Display

   • mesh_thumbnail_url loaded first for quick preview
   • Example: https://res.cloudinary.com/dyl94w48r/image/upload/v1736304000/design-version-meshes/thumbnail/seat_cushion.jpg

2. Asset Path Resolution

   • mesh_path determines where to fetch the 3D model
   • Example: /Game/DLC/Dist/GenericItems/CODE/MS-xxxxxxx.MS-xxxxxxx

3. Chunk Management

   • chunk_id: Groups related assets for batch download
   • chunk_size: Tracks download size for progress indicators
   • Example: chunk_id: 1234, chunk_size: 5242880 (5MB)

4. Display Order

   • sort_order: Controls listing sequence
   • Lower values appear first
   • Example: sort_order: 1 (main mesh), sort_order: 2 (accessory)

Visibility & Localization

Controls how meshes appear in different regional catalogs and applications:

Visibility Flags:

The visibility_app_jp_ja attribute controls regional availability and catalog behavior:

Example Usage:

// Standard product - fully visible
visibility_app_jp_ja: "Catalog, Search"

// Limited visibility - catalog only
visibility_app_jp_ja: "Catalog"

// Special collection - curated access only
visibility_app_jp_ja: "Exclusive Custom Catalog"

// Internal/deprecated - hidden
visibility_app_jp_ja: "Don't Show in App"

Multi-Mesh Design Names:

When a Design Family offers multiple variant options, these attributes provide context:

Example: Modular Sofa Variants

Localization Flow:

User Language: Japanese (ja-JP)
└── Display: japanese_name_for_multi_mesh_design
    └── Fallback: name_for_multi_mesh_design (if Japanese name empty)

User Language: English (en-US)
└── Display: name_for_multi_mesh_design

Use Cases & Examples

Single-Variant Design

Simple furniture items with only one configuration:

Example: Fixed Design Armchair

Design Family: "NORDIC ARMCHAIR"
└── Design Version: "1.0"
    └── Design Version Mesh: "Standard"
        ├── mesh_name: "MS-00004200"
        ├── mesh_label_name: "Standard"
        ├── name_for_multi_mesh_design: null (only one variant)
        └── sort_order: 1

Characteristics:

• Single variant available
• No size/configuration options
• Multi-variant naming not required
• Simple catalog presentation

Multi-Variant Design

Product families offering multiple size or configuration options:

Example: Danish Sofa Collection

Design Family: "DANISH SOFA"
└── Design Version: "2.5"
    ├── Design Version Mesh: "3 Seater 180"
    │   ├── mesh_name: "MS-00003100"
    │   ├── mesh_label_name: "3 Seater"
    │   ├── name_for_multi_mesh_design: "3 Seater 180cm"
    │   ├── japanese_name_for_multi_mesh_design: "3人掛け 180cm"
    │   └── sort_order: 1
    │
    ├── Design Version Mesh: "2 Seater 160"
    │   ├── mesh_name: "MS-00003101"
    │   ├── mesh_label_name: "2 Seater"
    │   ├── name_for_multi_mesh_design: "2 Seater 160cm"
    │   ├── japanese_name_for_multi_mesh_design: "2人掛け 160cm"
    │   └── sort_order: 2
    │
    └── Design Version Mesh: "Ottoman"
        ├── mesh_name: "MS-00003102"
        ├── mesh_label_name: "Ottoman"
        ├── name_for_multi_mesh_design: "Ottoman 80cm"
        ├── japanese_name_for_multi_mesh_design: "オットマン 80cm"
        └── sort_order: 3

Benefits:

• ✅ Customers can choose the size that fits their space
• ✅ Each variant maintains same design language
• ✅ Coordinated collection (can mix and match)
• ✅ Localized names for each variant

Modular Design System

Reusable design elements across multiple product families:

Example: Sectional Sofa System

Design Family: "MODULAR SECTIONAL"
└── Design Version: "3.0"
    ├── Design Version Mesh: "Left Arm Section"
    │   └── mesh_sfid: MESH_LEFT (mesh_name: MS-00005200)
    │
    ├── Design Version Mesh: "Right Arm Section"
    │   └── mesh_sfid: MESH_RIGHT (mesh_name: MS-00005201)
    │
    ├── Design Version Mesh: "Armless Section"
    │   └── mesh_sfid: MESH_CENTER (mesh_name: MS-00005202)
    │
    ├── Design Version Mesh: "Corner Section"
    │   └── mesh_sfid: MESH_CORNER (mesh_name: MS-00005203)
    │
    └── Design Version Mesh: "Chaise Section"
        └── mesh_sfid: MESH_CHAISE (mesh_name: MS-00005204)

Modular Benefits:

• Users can configure custom layouts
• Each section is a complete furniture piece
• Mix and match to fit any space
• Consistent design across all sections

Related Pages

Core Resources

• Design Version - Parent concept overview
• Design Family - Top-level design hierarchy
• Category - Catalog organization

Material System

• Design Version Elements - Material components
• Materials - Application - Applying materials to meshes

Asset Management

• 3D Model Import - Importing custom 3D models
• Asset Pipeline - Asset creation workflow
• Performance Optimization - Mesh optimization guide

Technical Details

• Chunk System - Asset delivery system
• Localization - Multi-language support
• Caching Strategy - Client-side asset caching