Follow these standards when authoring GLB files for the Ächtung Kraft configurator. Consistent authoring ensures materials hydrate correctly, woven textures tile properly, and exports render identically across all devices.

Material names must be descriptive and match the configurator's matName field exactly.

Do NOT use Blender defaults like Material.001 — the configurator normalizes names but descriptive names are required for unambiguous matching.

Mesh PurposeRequired matNameNotes
Woven seat centerseat_centerPrimary woven insert
Woven seat backseat_backBack woven insert
Side bolsterbolsterCan split: bolster_left / bolster_right
Outer shellshellNon-configurable structural panel
HeadrestheadrestSeparate mesh recommended
StitchingstitchingSeparate mesh or baked — must be solid mode
Frame / baseframeMetal or carbon base structure
Seat railrailOptional — if modeled

Blender numeric suffixes (.001, .002) are automatically stripped during matching — you don't need to remove them manually.

Woven textile inserts MUST be on their own separate mesh objects. Do NOT merge woven surfaces with leather panels.

Each configurable surface (woven insert, leather bolster, shell) must be a distinct mesh with a single material.

Multi-material meshes are supported but discouraged — prefer one material per mesh for reliable configurator matching.

Avoid shared UV islands between woven and leather meshes. UV overlapping creates incorrect texture bleed.

Headrest should be a separate mesh to allow independent material assignment.

All woven insert meshes must have clean, non-overlapping UV maps (UV Map 0).

UV texel density must be consistent across the woven surface — no areas of extreme stretching or compression.

Textile orientation: stripe direction should align vertically in UV space (V axis = stripe direction).

Avoid mirrored UVs on woven surfaces — mirroring causes visible seams on the woven pattern where the mirror axis falls.

For curved bolsters or rounded cushions, consider using triplanar projection mode in the configurator instead of UV mode — it eliminates UV seams on curved geometry.

UV shells must not extend outside the [0,1] UV space. Repeat/tiling is handled by the configurator transform, not UV layout.

All object transforms must be frozen/applied before export. In Blender: Ctrl+A → All Transforms.

Model origin should be at the geometric center of the seat (bottom-center of the bounding box is acceptable).

Scale must be applied — the configurator auto-scales models to fit the viewport. Unapplied scale causes incorrect bounding box calculation.

Do NOT export with rotations baked into the mesh normals. Apply rotation before export.

Axis convention: +Y up, +Z forward (standard GLB/glTF). The configurator's camera is calibrated to this convention.

Export format: .glb (binary glTF). Do NOT use .gltf + bin — the configurator expects a single self-contained file.

Include: Mesh data, Materials, Textures (if any baked maps), Normals.

Exclude: Armatures, Shape keys, Animation data, Cameras, Lights, Custom properties.

Texture resolution: baked maps should be 2048×2048 maximum. Higher textures are ignored by the woven pipeline but increase file size.

For woven materials, no baked color texture is needed — the configurator applies the live woven canvas texture at runtime.

Triangulate before export (or use the Triangulate modifier). Some non-manifold quads cause import artifacts.

Use Principled BSDF for all materials. The configurator reads roughness, metalness, and base color from glTF PBR properties.

Woven inserts: set base color to #FFFFFF — the configurator replaces color with the woven canvas texture at runtime.

Leather materials: set base color to a neutral mid-tone. The customer selects the actual color via the palette.

Roughness: woven ~0.75, leather ~0.55–0.65, metal ~0.3, carbon ~0.25.

Metalness: only for truly metallic parts (frame rails, buckles). Keep leather and textile at 0.0.

Do NOT embed texture images inside the GLB for woven surfaces — the runtime pipeline replaces the texture entirely. Embedded textures on woven materials just increase file size.