Content Editor

Tutorial

Access URL: 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://www.bilibili.com/video/BV1vu4y167wR

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

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.

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

  • Uncheck “Staff Picks” to access a wider selection of assets

  • 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.

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: https://www.xnview.com/en/xnviewmp/#downloads

  • 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, 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.

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.

上一页Requirements下一页3D Model

最后更新于

这有帮助吗？