# Content Editor ## Tutorial **Access URL:** [**https://cloud.kivicube.com/content-editor/index.html**](https://cloud.kivicube.com/content-editor/index.html) The Content Editor currently supports 3D models and image assets. Support for AR videos, transparent videos, audio, particle effects, and more asset types will be added in the future. **Tutorial:** [**https://youtu.be/tgWoqBMndYo?si=KWeyHfDaM7H-dVhP\&t=82**](https://youtu.be/tgWoqBMndYo?si=KWeyHfDaM7H-dVhP\&t=82) *** ## Overview #### What is the purpose of the current Content Editor? * Supports converting FBX and OBJ files into the GLB format compatible with Kivicube * Supports post-processing effects such as tone mapping * Allows visual material editing for 3D models * Allows visual lighting adjustments * Provides real-time preview of model animations * Enables viewing of model properties to verify compliance with specifications * Includes model specification checks to ensure high-performance rendering after uploading to the Kivicube platform * Offers additional model configuration options for easier visual presentation ### FAQ

A / Q	Context
A	The model imported into the Content Editor looks different from how it appears in the modeling software
Q	This is expected behavior. The Content Editor uses a different renderer and lighting environment compared to modeling software. You will need to adjust materials and configure the lighting environment within the Content Editor.
A	The model imported into the Content Editor is missing textures
Q	Textures may be lost during the conversion process. You can simply reassign the textures to the corresponding materials within the Content Editor.
A	Model Import Failed
Q

### Mandatory Model Requirements Models that do not meet the following requirements cannot be imported into the Content Editor. #### ❌ Unsupported glTF Extensions Kivicube currently only supports the following extensions: * KHR\_materials\_unlit * KHR\_texture\_transform * KHR\_materials\_pbrSpecularGlossiness *(After importing into the Content Editor, these will be converted into the standard workflow, and you may reset materials as needed.)* #### How to handle unsupported glTF extensions? * If you import from FBX, this issue usually does not occur. * The issue mainly appears when exporting GLB directly from modeling software or using third-party GLB files. → When exporting, do not include unsupported extensions. #### Texture Size / Texture Format Restrictions * Supported formats: JPG / JPEG / PNG *(Use PNG for transparent textures.)* * Texture resolution must not exceed 2048. * Strongly recommended: use power-of-two square textures, such as: 2×2, 4×4, 8×8, …, up to 2048×2048 {% hint style="info" %} You can use Photoshop or XnView to export textures in formats such as GIF, TGA, DDS, PSD, TIF, BMP, EXR, HDR, etc. into JPG / JPEG / PNG. {% endhint %} #### Incorrect Model Data Naming The root bone of the model must not contain animations. If the root bone has animation data, create an additional empty bone and bind it as the parent to the original root bone.

#### Model Specifications

Type	Specifications
Mesh Count	Severe: ≥ 10 (mesh count too high); Moderately Severe: 5–10; Compliant: ≤ 5
Triangle Count	Severe: ≥6W; Moderately Severe: 3–6W; Compliant：≤3W
Vertex Count	Severe: ≥6W; Moderately Severe: 3–6W; Compliant: ≤3W
Material Count	Severe: ≥10; Moderately Severe: 5–10; Compliant: ≤5
Texture Count	Severe: ≥10; Moderately Severe: 5–10; Compliant: ≤5
Animation Count	Severe: ≥10; Moderately Severe: 5–10; Compliant: ≤5
Bone Count	Severe: ≥120; Moderately Severe: 60–120; Compliant: ≤60
Morph Count	Severe: ≥30; Moderately Severe: 0–30; Compliant: ≤10

*** ## Detailed Usage ### Model Import #### Direct Import * Supports direct import of FBX / OBJ / GLB * For glTF, you must package the .gltf, .bin, and all texture files into a ZIP file before importing

#### Importing from Sketchfab **Register and Log In to Sketchfab** * Click Login * ```

``` * Register and Login

* Accept Kivicube’s Authorization Request

**Note** * Pay attention to the asset license agreement to ensure proper usage right

* **Sketchfab Preview vs. Content Editor Display**\ 可通过 **灯光环境 / 渲染 / 材质** 调整到满意效果。

*** ### Model Saving Click the Save button to save the model to your asset library.

#### Note

Type	Saving Condition
Model Materials	When saving, the material settings are written directly into the model. This means the version stored in the asset library will include the updated materials.
Lighting	Lighting adjustments are for preview purposes only. You will need to reconfigure again in the Scene Editor.
Rendering	Render adjustments are for preview purposes only. You will need to reconfigure again in the Scene Editor.
Model Display Setting	Model are for preview purposes only. You will need to reconfigure again in the Scene Editor.

*** ### Model Preview #### Model Properties Be sure to use the Model Properties panel to verify that the model meets all required specifications.

* File: Identifies which software was used to export the current model * Size: Models with a longest edge greater than 200 m will be automatically scaled down to 100 m upon import * glTF Extensions: Currently, only the following extensions are supported: * KHR\_materials\_unlit * KHR\_texture\_transform * KHR\_materials\_pbrSpecularGlossiness If any required extensions appear outside this list, the model may fail to load or render incorrectly.

#### Display Setting After clicking Save, none of the settings in Display Settings will be saved. You will need to reconfigure these settings in the Scene Editor. * Model Wireframe: Preview only; not saved. (Wireframe preview is currently not available in the Scene Editor.) * Model Bounding Box: Preview only; not saved. (In the Scene Editor, the bounding box appears automatically when an object is selected.) * Model Skeleton: Preview only; not saved. (Skeleton preview is currently not available in the Scene Editor.) * Model Axes: Preview only; not saved. (You can use the Scene Editor’s model axes to adjust the model’s position.) * Ground Grid: Preview only; not saved. (Useful for checking whether the model is centered and for assessing its position, size, and orientation.) * Background Display: Preview only; not saved. (Helps with visualizing the model in context.) * Field of View: Preview only; not saved. (Field of view adjustments must be done in the Scene Editor.)

*** ### Materials #### Selecting Materials A model may contain multiple materials, so be sure to configure each material properly. After importing a model into the Content Editor, it is common to encounter missing texture maps. Simply select the corresponding material and reassign the textures as needed.

#### Material Setting **Material Types** * **Metal/Roughness** A PBR (Physically Based Rendering) workflow that responds to lighting. Suitable for realistic materials influenced by light. * **Unlit** A material type not affected by lighting. This option offers higher performance and requires only a base color texture.

**Alpha Mode**

Type
Opaque	If you need a material to be non-transparent, set its transparency mode to Opaque.
Transparent / Semi-Transparent (BLEND)	If a material contains semi-transparency, set its transparency mode to Blend.
Transparent MASK	If a material contains transparency but no semi-transparency (for example, leaves), set the transparency mode to MASK. When the texture’s alpha value is greater than or equal to the Alpha Cutoff, the pixel will be rendered as opaque. When the alpha value is below the Alpha Cutoff, the pixel will be rendered as fully transparent.

Type

Opaque

If you need a material to be non-transparent, set its transparency mode to Opaque.

Transparent / Semi-Transparent (BLEND)

If a material contains semi-transparency, set its transparency mode to Blend.

Transparent MASK

If a material contains transparency but no semi-transparency (for example, leaves), set the transparency mode to MASK.
When the texture’s alpha value is greater than or equal to the Alpha Cutoff, the pixel will be rendered as opaque.
When the alpha value is below the Alpha Cutoff, the pixel will be rendered as fully transparent.

**Side** Enabling double-sided rendering will increase performance costs. Please avoid enabling it unless absolutely necessary.

**Material Property Settings**

Property	Illustration	Description
Base Color		为模型添加一个颜色贴图或者直接设置颜色
Roughness/Metalness		Roughness controls how rough or smooth the model’s surface appears. A lower roughness value results in a smoother surface, while a higher roughness value makes the surface more rough. A roughness map controls the roughness at different areas of the model, allowing some regions to appear smooth while others appear rough. Metalness / Metallic Glossiness controls the metallic appearance of the model. The higher the metalness value, the more metallic the surface appears. A metalness map controls the metalness level at different areas of the model, allowing some parts to appear more metallic while others remain non-metallic.
Occlusion		Ambient Occlusion (AO) adds shadow detail to a model. Sometimes, to reduce the number of texture maps, shadow details are baked directly into the base color texture. From a PBR rendering perspective, this is technically not recommended, but in practice it can be used when appropriate.
Emissive		Add an emissive map to the model or directly set an emissive color.
Normal		A normal map is used to add surface detail to a model.

*** #### Material Texture **Texture Formats** > Only **jpg / jpeg / png** are supported. Use **png** for transparent textures. | Original Format | Converting Method | | --------------------------------------------- | ----------------------------------------------------------------- | | gif / tga / dds / psd / tif / bmp / exr / hdr | Use Photoshop or XnView to export the textures as **PNG or JPG.** | * Download XnView: * File → Open (original image) → File → Export / Save As → select PNG or JPG **Texture Size and Compression** * Kivicube platform models must use textures with a maximum resolution of 2048, and we strongly recommend using power-of-two square textures, such as:\ 2×2, 4×4, 8×8, 16×16, 32×32, 64×64, 128×128, 256×256, 512×512, 1024×1024, 2048×2048. * **Choose Appropriate Texture Sizes:** To maintain model quality while optimizing performance, use the smallest possible texture size that still provides acceptable visual results. In special cases, you may choose a larger base color texture, while keeping other texture maps smaller. * All texture files should be compressed using tools such as [ImageOptim](https://imageoptim.com/), etc.\ • We recommend a default compression quality of 90%.\ • If the visual result is still good, you may try lowering the quality to 80%.\ • Do not reduce quality below 80%. * Normal maps are usually in PNG format and may remain large even after compression. You may try converting them to JPG for smaller file size.\ Note: JPG normal maps can easily degrade in quality : choose an appropriate compression level. * Use the "Optimize Model" Feature

## FAQ


Q	The bounding box does not fit the model
A	Symptom: After importing the model into the Content Editor, the model’s position does not match the bounding box. This is caused by bounding box alignment issues. We recommend adjusting the bounding box directly in your modeling software. If the model is only intended for use on the platform, you can use our model compression tool to correct the issue.

The bounding box does not fit the model

Symptom:

After importing the model into the Content Editor, the model’s position does not match the bounding box.

This is caused by bounding box alignment issues. We recommend adjusting the bounding box directly in your modeling software.

If the model is only intended for use on the platform, you can use our model compression tool to correct the issue.


Q	The Content Editor shows a popup message: “imageLoader onimageError”
A	Refer to “Texture size limit / Unsupported texture formats.” If the texture size is too large, please compress it.