URT3D Docs
  • πŸ“˜Welcome to URT3D Docs
  • Getting Started
    • πŸš€Quickstart
  • Basics
    • 🌐Introduction to URT3D
    • πŸ”„How to Convert Your Files
    • ⬆️Upload Tips and Guidelines
    • πŸ“¦Using Your Converted Files
    • πŸ› οΈTroubleshooting Conversion
  • πŸ“‚ Developers
    • πŸ‘©β€πŸ’»Getting Started with the SDK
    • πŸ‘¨β€πŸ’»Unity Integration Guide
    • πŸ—οΈCore Concepts & Architecture
    • 🧬Traits System
    • ✍️Scripting System
      • 🧾MiniScript Recipes
    • πŸ“˜API Reference
    • πŸ’‘Examples and Best Practices
    • πŸ›°οΈAdvanced Topics
Powered by GitBook
On this page
  • 🚫 Common Upload Issues
  • 🧩 Model Issues After Conversion
  • πŸ› οΈ General Troubleshooting Tips
  • πŸ’¬ Need Help?
  1. Basics

Troubleshooting Conversion

Having issues uploading or converting your 3D model? This page outlines the most common problems and how to fix them before trying again.

If your upload or conversion fails β€” or the resulting .urta doesn’t look right β€” don’t worry. Here are common problems, their causes, and how to fix them.


🚫 Common Upload Issues

πŸ”Ή "Unsupported File Format"

Only .glb and .gltf formats are currently supported. ❗ Solution: Convert your model to .glb using Blender or another tool.

πŸ”Ή "File Too Large"

Files over 100MB may be rejected or fail silently. ❗ Solution: Reduce polygon count, compress textures, or split into smaller assets.

πŸ”Ή "Nothing Happens After Upload"

If the page stalls after uploading: ❗ Solution:

  • Try a different browser (Chrome is recommended)

  • Ensure the model has embedded geometry and textures

  • Check internet speed or firewall issues


🧩 Model Issues After Conversion

πŸ”Ή "Model is Invisible"

This usually means the scale is extremely small or the model’s pivot is offset. ❗ Solution:

  • Apply transforms and reset pivot in Blender before re-exporting

πŸ”Ή "Textures Are Missing"

If the model loads but appears solid white or gray: ❗ Solution:

  • Make sure textures are embedded in the .glb file

  • Use glTF Binary (.glb) with packed textures (avoid separate .bin/.png)

πŸ”Ή "Upside Down / Wrong Orientation"

Some exports use different up axes by default. ❗ Solution:

  • In Blender, set Z-up and Y-forward before exporting

  • Preview model in a viewer to confirm orientation


πŸ› οΈ General Troubleshooting Tips


πŸ’¬ Need Help?

PreviousUsing Your Converted FilesNextGetting Started with the SDK

Last updated 1 month ago

Open the .glb in a viewer like

πŸ”Ή Open your .glb in to catch issues before uploading πŸ”Ή Keep textures under 2K resolution if possible πŸ”Ή Confirm the file name contains no spaces or special characters πŸ”Ή Always test conversion with a known-good test model before scaling up

πŸ—¨οΈ πŸ“© Email:

πŸ› οΈ
gltf-viewer.donmccurdy.com
gltf-viewer.donmccurdy.com
Join our Discord creator community
support@urt3d.com