Skip to main content

Asset pipeline

How to get content from a DCC tool into a loadable DDDBrowser scene.

Product formats​

RoleFormat
MeshOBJ (+ separate MTL)
TexturesPNG / JPG / JPEG / TGA (LDR)
AudioWAV (PCM) or Ogg Vorbis
ScriptsLuau (.luau)
SceneJSON discovered from HTML

Not supported: glTF, GLB, FBX, USD, HDR material maps, EXR, compressed WAV, MP3/Opus as product formats. Skyboxes may use Radiance .hdr or six-face lists.

  1. Author in Blender / Maya / etc.
  2. Export mesh as Wavefront OBJ with materials.
  3. Export textures as LDR PNG or JPEG; keep under asset budgets.
  4. Host all files on HTTPS (or Accept Allow HTTP for local http:// testing).
  5. Reference URIs in scene JSON assets[], place with instances[].
  6. Validate by loading the discovery HTML in DDDBrowser.

OBJ tips​

  • Prefer triangulated meshes (runtime triangulates, but export-time triangles are clearer).
  • Keep OBJ under 64 MiB, MTL under 16 MiB, verts under ~2M.
  • Use relative mtllib names that resolve next to the OBJ on the server (cache layout preserves relative paths so mtllib / map_* siblings stay beside the mesh).
  • MTL maps consumed at load: map_Kd (albedo), map_Ka (ambient occlusion), map_bump / bump (remapped to normal when no dedicated normal map), metallic/roughness/normal/emissive when present. Unsupported params (e.g. map_Ks, map_d, Ns, illum) are ignored with warnings.
  • Colliders: set instance/asset collider fields in scene JSON when needed (see Instances).

Texture tips​

  • Max 8192 px per side; max 4096² total pixels; max 64 MiB file.
  • Power-of-two sizes help GPU upload; avoid huge atlases for simple props.

Audio tips​

  • SFX: export PCM WAV (cap 32 MiB). Music beds: prefer Ogg Vorbis (cap 16 MiB).
  • Use audio.ambient for non-spatial beds.

Scripts​

  • Host .luau on the scene origin or add hosts under Settings → Script origins.
  • Pin public scripts with asset sha256.

Next​