This document outlines the category-agnostic requirements for models intended for use in the WANNA 3D Viewer.
All General 3D Model Requirements apply, with the additional rules below ensuring correct rendering and functionality. Please note that for bags, WANNA supports additional interactive features in the 3D Viewer. For details, see Bags 3D Model Requirements (3D Viewer).
Main Requirements
| Requirement | Details |
|---|---|
| Max triangles in a scene | 130,000 |
| Max primitives in a scene | 105 |
| Max texture size | 2048x2048 |
| Total texture pixels in a scene | 37,748,736 px (≈ 9 × 2048 × 2048) |
| Archive file size (geometry + textures) | ≤ 50 MB |
| Model scale | True-to-size (1:1) |
| File format | glTF (.gltf) or GLB (.glb) only |
| Model position | Main body must be centred |
| Multi-object scenes | For models with two and more objects (e.g. earrings, sneakers), the midpoint must be centred |
Modelling Recommendations
- All surfaces must be modelled, including undersides and interior faces.
- Add a
plane_aonode to improve realism:- A horizontal AO-baked plane beneath the model.
- Backface culling must be enabled.
- More information on the recommended node structure can be found below.
- If your design includes gems, refer to How to add beautiful gems to 3D models for detailed instructions on creating high-quality gem elements.
- The 3D Viewer supports model animations. Refer to Animations in 3D Viewer for detailed setup instructions.
Recommended Node Structure
| Node name | Purpose |
|---|---|
main |
Contains all objects that should be visible in the 3D Viewer General view, excluding auxiliary elements reserved for ActionAnimation, which are displayed only in the Details view. |
plane_ao |
Z=0 plane with baked AO from the main node, always shown. Backface culling should be enabled for plane_ao. |
action_animation |
Auxiliary objects required for specific animations, displayed only in the Details view of the 3D Viewer (e.g. arrows to guide user attention during animation playback). The Details view is available only if this node is present, and the node is displayed only when the user switches to that view. |
Only the
mainnode and its sub-nodes will be visible in the 3D Viewer’s General view. Therefore, the model will display correctly only if themainnode is placed at the top level of the hierarchy.
If nomainnode is present in the model, all nodes will be displayed in the 3D Viewer simultaneously, without any additional functionality.